react native(리액트 네이티브) 안드로이드 배포하기

시작하기

구글 개발자 등록이 완료되어있고 react native 프로젝트가 있다는 가정하에 배포 방법을 알아보도록 하겠습니다.

  1. keytool로 개인서명키 만들기
  2. Gradle properties 변수들 작성
  3. Gradle 설정파일 수정
  4. release AAB(Android App Bundle) 빌드
  5. AAB 파일 업로드
  6. 개인정보처리방침

1. keytool로 개인서명키 만들기

keytool 를 사용하여 개인 서명 키를 생성할 수 있습니다.

1
keytool -genkey -v -keystore my-upload-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
  • keystore 옵션의 my-upload-key.keystore 값은 파일이름입니다.
  • alias 옵션의 my-key-alias 값은 별명입니다.
  • validity 옵션의 10000 값은 유요기간입니다.

위의 명령어를 실행하면 조직 이름 비밀번호등을 입력하라고 나옵니다.
하나씩 입력해줍니다.
마지막에 [아니오]선택지만 나와있는데 이때는 y를 입력하고 엔터를 누르면 생성이 됩니다.

keystore 생성

개인서명키를 분실했을경우 사이트를 참고해주세요

2. Gradle properties 변수들 작성

android/gradle.properties 파일 하단에 다음 값을 추가합니다.

1
2
3
4
MYAPP_UPLOAD_STORE_FILE=my-upload-key.keystore
MYAPP_UPLOAD_KEY_ALIAS=my-key-alias
MYAPP_UPLOAD_STORE_PASSWORD=*****
MYAPP_UPLOAD_KEY_PASSWORD=*****

아까전에 생성한 파일의 이름 별명 비밀번호를 각자에 생성한 파일에 맞게 입력해야합니다.

3. Gradle 설정파일 수정

android/app/build.gradle 파일에 다음 코드를 추가합니다.

android/app/build.gradle
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
...
android {
...
defaultConfig { ... }
signingConfigs {
release {
if (project.hasProperty('MYAPP_UPLOAD_STORE_FILE')) {
storeFile file(MYAPP_UPLOAD_STORE_FILE)
storePassword MYAPP_UPLOAD_STORE_PASSWORD
keyAlias MYAPP_UPLOAD_KEY_ALIAS
keyPassword MYAPP_UPLOAD_KEY_PASSWORD
}
}
}
buildTypes {
release {
...
signingConfig signingConfigs.release
}
}
}
...

4. release AAB(Android App Bundle) 빌드

bundleRelease은 앱을 실행하는데 필요한 모든 JavaScript를 AAB(AndroidApp Bundle)로 묶습니다.

1
2
cd android
./gradlew bundleRelease

빌드가 성공하면 android/app/build/outputs/bundle/release/app-release.aab에서 파일을 찾을수 있습니다.

1
open android/app/build/outputs/bundle/release

release 파일

진행하면서 어려운점이나 막히는 부분이 있다면 공식 홈페이지를 참고 하면 됩니다.

5. 구글 플레이스토어에 배포하기

구글 플레이스토어 콘솔에 접속해서 로그인하고 앱을 생성합니다.
이후 앱에 관한 정보 제공 및 스토어 등록정보를 작성해줍니다.

앱에 관한 정보 제공 및 스토어 등록정보 설정

개인정보처리방침

개인정보처리방침을 등록해야합니다.
개인정보 처리방침을 손쉽게 작성할 수 있는 정부 공식 사이트에 접속합니다.

개인정보처리방침 만들기를 클릭하고, 생성을 진행합니다.
개인정보처리방침 만들기

생성이 완료되면 파일을 다운받거나 텍스트로 받을 수 있는데, 사이트를 쉽게 적용하기 위해서 notion을 사용해보도록 하겠습니다.

notion 사이트 공유

노션을 접속한 이후, 개인정보 처리방침 페이지를 만들고 개인정보처리방침 텍스트를 복사해서 붙여넣습니다.

개인정보처리방침 글

그리고 우측위에 share버튼이 있는데 클릭하면 다음과 같은 창이 나옵니다.

share 창

share to web을 토글하면 web link가 나오는데 이 링크는 바로 어떤 웹 브라우저에서도 바로 접속할 수 있게됩니다.

링크를 복사해서 구글 플레이스토어 콘솔 개인정보처리방침에 등록합니다.
개인정보처리방침 등록

배포하기

다음으로 파일을 배포하도록 하겠습니다.

프로덕션 버전 만들기

App bundle 부분에 파일을 업로드 합니다.

파일업로드

이후 우측 하단에 활성화된 버전검토 버튼을 클릭합니다.
이후 나오는 에러나 경고등을 처리해줍니다.

버전 검토후 에러

정보수집여부 개인정보처리방침등의 문제를 해결하고 나면 프로덕션 트랙으로 출시 시작버튼이 활성화 됩니다.

출시시작 버튼

출시가 완료되었습니다.
구글측에서 앱을 검토한 이후 실제 구글 플레이스토어에서 확인 할 수 있습니다.
프로젝트 생성부터 배포까지 고생많으셨습니다.

출시완료

Share