Google Play 업로드용 keystore 생성과 key.properties 연결

Google Play에 개발자 등록과 본인 인증 후 AAB를 올리려면 upload keystore로 서명한 빌드가 필요합니다.
Play 개발자 계정과 별개로, 내 PC에서 키 파일을 만든 뒤 출시 설정에서 앱과 연결하면 됩니다.

 

 

 

1. keystore 생성

프로젝트의 android 폴더에서 실행합니다.

// 안드로이드 폴더로 이동
cd android

// keytool을 사용해서 keystore 생성
keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

• keytool: JDK에 포함된 인증서/키 관리 도구
• -genkey: -genkeypair와 같음. 공개키+개인키 쌍을 새로 만들고 keystore에 넣음
• -v: verbose. 진행 과정을 자세히 출력
• -keystore upload-keystore.jks: 키를 저장할 파일 경로/이름
• -keylog RSA: 키 알고리즘. Android/Play 업로드용으로 흔히 RSA 사용한다고 함
• -keysize 2048: 키 길이(비트). 2048이 현재 일반적인 최소 권장선이라고 함
• -validity 10000: 인증서 유효 기간(일). 약 27년. 앱 서명 키는 길게 잡는 편이라고 함
• -alias upload: keystore 안에서의 키 별명. 나중에 key.properties의 keyAlias와 같아야함

 

아래 이미지는 제가 만들면서 나왔던 질문들을 캡쳐한 것입니다.

 

질문을 요약하자면

• name: 본인 이름 또는 개발자명
• organizational unit: 소속 조직, 부서
• organization: 소속사
• city: 도시
• state: 시/도
• country code: 국가 코드 두 글자

이정도입니다.

 

그리고 비밀번호는 본인이 기억하기 쉽더라도 안전을 위해 길고 특수문자나 숫자도 가능하니 섞어서 사용하면 좋을 거 같습니다.

저는 23자로 만들었습니다. ㅋㅋㅋ

 

아! 비밀번호 입력할 때 비밀번호는 화면에 출력되지 않습니다. 하지만 입력이 된거니까 입력하고 enter 누르면 됩니다.

 

 

 

2. key.properties 연결

android 경로 바로 하위에 key.properties로 만듭니다.

android 폴더 하위 바로 아래에 key.properties 생성

 

내용은 다음 내용으로 채워줍니다.

YOUR_STORE_PASSWORD 부분만 아까 keystore을 생성하면서 작성한 비밀번호를 작성해주면 됩니다.

storeFile=upload-keystore.jks
storePassword=YOUR_STORE_PASSWORD
keyAlias=upload
keyPassword=YOUR_KEY_PASSWORD

 

여기서 주의할 점은 혹시라도 git commit 할 때 key.properties와 *.jks는 commit 하면 안됩니다.

 

 

3. 검증

keystore를 생성하고 제대로 생성되었는지 확인하기 위해서는 아래 명령어를 통해 확인할 수 있습니다.

keytool -list -v -keystore upload-keystore.jks -alias upload

 

명령어를 입력하고 keystore 생성할 때 입력했던 비밀번호를 입력하면 alias 'upload' 글자가 보인다면 성공입니다.

Alias name: upload 나오면 검증 된거임

 

 

 

4. 보관

생성한 keystore 비밀번호는 잘 보관해야합니다.

메모장에 작성해서 드라이브에 올리든, 외장하드나 USB에 보관을 하던, 혹은 비밀번호 관리해주는 플랫폼을 사용하여 관리해도 됩니다. 본인이 편한 방식으로 안전하게 잘 보관하면 됩니다. 그리고 분실하지 않도록 주의합니다. 왜냐하면 Play 업로드가 막힐 수 있음!