sign, apk, aab 만들기
React Native 프로젝트에서 APK 파일을 생성하는 방법을 단계별로 설명드리겠습니다. 이 APK 파일은 Android 앱을 배포하거나 테스트하기 위해 사용됩니다.
1. 프로젝트 준비
먼저, React Native 프로젝트가 올바르게 설정되어 있는지 확인합니다.
npx react-native init MyProject
cd MyProject
여기서 MyProject는 프로젝트 이름입니다.
2. Android 빌드 환경 설정
2.1 JDK 설치
Android 앱을 빌드하기 위해 **Java Development Kit (JDK)**가 필요합니다.
- JDK 다운로드 페이지에서 JDK를 설치하세요. JDK 11이 권장됩니다.
2.2 Android Studio 설치
Android Studio는 Android SDK 및 빌드 도구를 포함하고 있습니다.
- Android Studio 설치 후, Android SDK 및 관련 빌드 도구를 설치하세요.
- Android Studio 설치 후, SDK 위치를 기록해 둡니다. 일반적으로 SDK는
~/Library/Android/sdk(macOS) 또는C:Users<Your Username>AppDataLocalAndroidSdk(Windows)에 위치합니다.
2.3 환경 변수 설정
SDK 경로를 환경 변수에 추가합니다.
macOS/Linux:
bash코드 복사export ANDROID_HOME=$HOME/Library/Android/sdk export PATH=$PATH:$ANDROID_HOME/emulator export PATH=$PATH:$ANDROID_HOME/tools export PATH=$PATH:$ANDROID_HOME/tools/bin export PATH=$PATH:$ANDROID_HOME/platform-toolsWindows: 환경 변수 설정 창에서
ANDROID_HOME변수와 SDK 경로를 추가합니다.
3. Release 모드로 APK 빌드
3.1 앱 서명 키스토어 생성
APK를 배포하기 위해 앱 서명에 사용할 키스토어 파일을 생성해야 합니다.
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias
my-release-key.jks는 생성될 키스토어 파일의 이름입니다.my-key-alias는 키의 별칭입니다.
이 명령을 실행하면 여러 질문에 답해야 합니다. 예를 들어, 이름, 조직, 국가 코드 등을 입력합니다. 키스토어 파일은 android/app 디렉토리에 저장하세요.
3.2 gradle.properties 파일에 서명 정보 추가
android/gradle.properties 파일을 열고, 다음 내용을 추가합니다.
MYAPP_RELEASE_STORE_FILE=my-release-key.jks
MYAPP_RELEASE_KEY_ALIAS=my-key-alias
MYAPP_RELEASE_STORE_PASSWORD=your-password
MYAPP_RELEASE_KEY_PASSWORD=your-password
여기서 your-password는 키스토어 생성 시 사용한 비밀번호입니다.
3.3 build.gradle 파일에 서명 설정 추가
android/app/build.gradle 파일에서 서명 설정을 추가합니다.
android {
...
defaultConfig { ... }
signingConfigs {
release {
storeFile file(MYAPP_RELEASE_STORE_FILE)
storePassword MYAPP_RELEASE_STORE_PASSWORD
keyAlias MYAPP_RELEASE_KEY_ALIAS
keyPassword MYAPP_RELEASE_KEY_PASSWORD
}
}
buildTypes {
release {
signingConfig signingConfigs.release
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
}
3.4 APK 빌드
이제 APK를 빌드할 준비가 되었습니다. 프로젝트의 android/ 디렉토리로 이동한 후, 다음 명령어를 실행합니다.
cd android
./gradlew assembleRelease
Windows에서는 ./gradlew.bat assembleRelease를 사용하세요.
이 명령이 완료되면, android/app/build/outputs/apk/release/ 디렉토리에 app-release.apk 파일이 생성됩니다.
4. APK 확인 및 배포
생성된 app-release.apk 파일을 Android 기기에 직접 설치하여 테스트하거나, Google Play 스토어 등에 배포할 수 있습니다.
adb install android/app/build/outputs/apk/release/app-release.apk
요약
- JDK 및 Android Studio 설치: 개발 환경을 설정합니다.
- 서명 키스토어 생성: APK 서명을 위한 키스토어를 생성합니다.
- 빌드 설정:
gradle.properties및build.gradle파일에 서명 정보를 추가합니다. - APK 빌드: Release 모드로 APK를 빌드합니다.
이 과정에 따라 React Native 프로젝트에서 APK를 생성할 수 있습니다.
