android-keystore-setup

name	android-keystore-setup
description	Android Keystore 생성 및 GitHub Secrets 등록 자동화 스킬

Android Keystore Setup

Android 앱 서명을 위한 Keystore 생성 및 GitHub Secrets 등록을 자동화합니다.

역할

Android 앱 서명 전문가. Keystore 생성, 관리, CI/CD Secret 연동을 담당합니다.

수행 가능 작업

1. Keystore 생성

• keytool 명령어로 .keystore 파일 생성
• 프로젝트 기본값:
  • Keystore 파일명: colorsortmaster.keystore
  • Alias: colorsortmaster
  • Algorithm: RSA 2048
  • Validity: 10000일 (약 27년)
  • DN: CN=Color Sort Master, OU=Development, O=ColorSortStudio, L=Seoul, ST=Seoul, C=KR
• 사용자에게 비밀번호 입력 요청 (강력한 비밀번호 권장)

생성 명령어:

keytool -genkey -v \
  -keystore colorsortmaster.keystore \
  -alias colorsortmaster \
  -keyalg RSA -keysize 2048 \
  -validity 10000 \
  -storepass "<PASSWORD>" \
  -keypass "<PASSWORD>" \
  -dname "CN=Color Sort Master, OU=Development, O=ColorSortStudio, L=Seoul, ST=Seoul, C=KR"

2. Keystore 검증

keytool -list -v -keystore colorsortmaster.keystore -storepass "<PASSWORD>"

3. GitHub Secrets 등록

gh CLI로 직접 등록:

# keystore를 base64로 인코딩하여 등록
base64 colorsortmaster.keystore | gh secret set ANDROID_KEYSTORE_BASE64
gh secret set KEYSTORE_PASSWORD --body "<password>"
gh secret set KEY_ALIAS --body "colorsortmaster"
gh secret set KEY_PASSWORD --body "<password>"

등록되는 Secrets:

• ANDROID_KEYSTORE_BASE64 (keystore 파일의 base64 인코딩)
• KEYSTORE_PASSWORD
• KEY_ALIAS
• KEY_PASSWORD

등록 확인: gh secret list

4. 백업 안내

• Keystore 분실 시 앱 업데이트 불가 (Google Play App Signing 사용 시 완화)
• 최소 2곳에 백업 권장 (USB, 클라우드)

참고 문서

• .claude/commands/deploy-setup.md (Step 5: Keystore)
• GitHub Secrets 등록: gh secret set 명령어 사용
• docs/deploy/store-submission-guide.md (line 454-461: 백업 프로토콜)

제약 조건

• .gitignore에 *.keystore, *.jks 이미 포함 → 레포에 커밋되지 않음
• 비밀번호는 절대 하드코딩 금지 → .env + GitHub Secrets만 사용
• 로컬 .env 파일은 커밋하지 않음

실행 전 확인

• Java JDK가 설치되어 있어야 함 (keytool은 JDK에 포함)
• gh CLI가 인증되어 있어야 함 (GitHub Secrets 등록용)