[SecureGen] 프로젝트 초기화 완료 (문제 발생 및 해결 방안 요약)

앞 포스트에서 제시한 방안을 바탕으로 앱 초기화 완료

 

앱 초기화 완료 화면

 

 

진행 과정에서 발생한 문제점 및 해결 방안들을 요약 요청하여 작

 

Q : 위 상황과 해결방안들을 요약해줄래?

 

---

현재 상황 요약 및 해결 방안

지금까지 발생했던 오류와 그 해결 과정을 요약해 드릴게요. 핵심 문제는 React Native 프로젝트 빌드에 필요한 개발 환경 설정, 특히 Java, Node.js, Android SDK 및 NDK 버전의 호환성이었습니다.

---

1. 초기 문제: Unsupported class file major version 68

• 문제: Gradle 빌드 중 "Unsupported class file major version 68" 오류가 발생했습니다. 이는 주로 Gradle이 사용하는 Java 버전이 너무 높거나, 프로젝트와 호환되지 않을 때 나타나는 오류입니다. Major version 68은 Java 12에 해당합니다.
• 원인 파악: 사용자의 시스템에 Java 24, 나중에는 Java 23이 설치되어 있었음을 확인했습니다. 이들은 React Native 및 Gradle 빌드 환경에서 아직 공식적으로 지원하지 않는 최신 비-LTS(Long-Term Support) 버전이었습니다.
• 해결 방안: **Java 17 (LTS) 또는 Java 11 (LTS)**과 같이 React Native 및 Gradle이 권장하는 LTS 버전의 Java를 설치하고, JAVA_HOME 환경 변수를 해당 경로로 정확하게 설정하는 것이 가장 중요했습니다. 이후 변경 사항 적용을 위해 새 터미널을 열어 java -version으로 확인하고, Gradle 캐시를 정리해야 했습니다.

---

2. 다음 문제: :app:configureCMakeDebug 실패 및 WARNING: A restricted method in java.lang.System has been called

• 문제: Java 버전 조정을 시도한 후에도 :app:configureCMakeDebug[arm64-v8a] FAILED 오류가 지속되었습니다. 이 태스크는 Android NDK (Native Development Kit) 및 CMake와 관련된 빌드 단계에서 발생합니다. WARNING: A restricted method 메시지는 Java 관련 문제가 여전히 남아있을 가능성도 시사했습니다.
• 원인 파악: 이 유형의 오류는 주로 Android NDK 및 CMake가 제대로 설치되지 않았거나, 버전이 호환되지 않을 때 발생합니다.
• 해결 방안:
  • Android Studio의 SDK Manager를 통해 "Android NDK (Side by side)"와 "CMake"가 모두 설치되어 있는지 확인하고 필요하다면 설치하도록 안내했습니다.
  • npx react-native doctor 명령어를 실행하여 개발 환경 상태를 진단하고, android/build/reports/problems/problems-report.html 파일을 열어 더 자세한 오류 보고서를 확인하도록 제안했습니다.

---

3. 최종 문제: npx react-native doctor 결과 - Android SDK - Versions found: N/A

• 문제: npx react-native doctor를 실행한 결과 ✖ Android SDK - Versions found: N/A - Version supported: 35.0.0이라는 명확한 오류가 확인되었습니다. 이는 안드로이드 앱 빌드에 필수적인 Android SDK 35.0.0이 시스템에 없거나, CLI가 그 위치를 찾지 못한다는 의미입니다.
• 원인 파악: Android SDK 35.0.0이 실제로 설치되지 않았거나, ANDROID_HOME 환경 변수가 SDK의 정확한 설치 경로를 가리키지 않아 발생했습니다.
• 해결 방안:
  1. Android Studio SDK Manager에서 Android SDK Platform 35.0.0을 확실하게 설치했는지 다시 확인합니다.
  2. Android SDK Manager 상단에 표시된 정확한 Android SDK 설치 경로를 확인합니다.
  3. ANDROID_HOME 시스템 환경 변수를 이 정확한 SDK 경로로 설정하고, Path 환경 변수에 %ANDROID_HOME%\platform-tools, %ANDROID_HOME%\tools 등이 포함되어 있는지 확인합니다.
  4. JAVA_HOME도 다시 한번 Java 17 또는 11로 올바르게 설정되어 있는지 확인합니다.
  5. 환경 변수 변경 후에는 모든 터미널 창을 닫고 새로 연 후 echo %ANDROID_HOME%과 java -version으로 올바른지 재확인합니다.
  6. Gradle 캐시 및 프로젝트 빌드 파일(build, .gradle)을 모두 정리합니다.
  7. 마지막으로 npx react-native doctor를 다시 실행하여 모든 항목이 ✓로 표시되는지 확인한 후, npx react-native run-android로 앱 빌드를 재시도합니다.

---

현재까지의 상황을 종합해 볼 때, Android SDK 35.0.0 설치 및 ANDROID_HOME 환경 변수 설정이 가장 핵심적인 해결 과제입니다. 이 문제가 해결되면 빌드가 성공할 가능성이 높습니다.