Android 앱 릴리스 Skill
릴리스 APK를 빌드하고 텐센트 앱보우/샤오미/화웨이/OPPO/vivo 5대 앱 스토어에 제출하여 엔드투엔드 자동화를 제공합니다.
실행 명령어
사용자가 "패키징하여 심사 제출"(또는 "출시" / "앱 등록" / "앱 배포" / "멀티 채널 제출" 등)을 요청하면:
- 업데이트 문구 확인: 사용자가 지정하지 않으면 기본값 "알려진 문제 수정 및 사용자 경험 최적화"를 사용하거나 사용자에게 문의합니다.
- 올인원 명령어 실행:
PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \ --i-know-this-submits-to-production \ --update-desc "<업데이트 문구>" \ <프로젝트 루트 디렉터리> - 출력 모니터링: 스크립트가 전체 단계(사전 점검 -> 패키징 -> Bugly -> 멀티 채널 제출 -> Git 태그)를 자동으로 완료하며, 수동 개입이 필요하지 않습니다.
- 결과 보고: 각 채널의 성공/실패 상태를 사용자에게 요약합니다.
- 예외 처리: 사전 점검 실패(서명/버전 번호) 시 중단하고 구체적인 이유를 사용자에게 알립니다. 특정 채널 실패는 다른 채널에 영향을 주지 않습니다.
패키징만 하고 제출하지 않음 (dry-run)
앱보우만 dry-run(업로드만 하고 심사 제출 안 함)을 지원합니다. 샤오미/화웨이/OPPO/vivo는 업로드 시 자동 심사 제출되며, dry-run 시 자동으로 건너뜁니다:
python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
--dry-run --store yyb \
<프로젝트 루트 디렉터리>
단일 채널 지정
PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
--store yyb|xiaomi|huawei|oppo|vivo \
--i-know-this-submits-to-production \
--update-desc "<업데이트 문구>" \
<프로젝트 루트 디렉터리>
단계 건너뛰기
--skip-build: 패키징 건너뛰고 기존 APK 사용--skip-bugly: Bugly 심볼 테이블 업로드 건너뛰기--skip-git: Git 태그 생성 건너뛰기--skip-check: 사전 점검 건너뛰기
자동화 프로세스
| 단계 | 스크립트 | 설명 |
|---|---|---|
| Step 0 사전 점검 | pre_check.py | 릴리스 서명 구성이 signingConfigs.release인지 확인 + 로컬 versionCode > 온라인 버전 번호 |
| Step 1 패키징 | ./gradlew clean assembleRelease | app-arm64-v8a-release.apk 찾기(64비트 패키지만 업로드) |
| Step 1.5 Bugly | upload_bugly_symbol.py | mapping.txt 업로드(비차단, 실패해도 심사 제출에 영향 없음) |
| Step 2 멀티 채널 제출 | 각 채널 *_submit.py | 구성된 자격 증명이 있는 채널에 순차적으로 업로드, 독립적인 안전 잠금 |
| Step 3 Git 태그 | git_tag.py | 모두 성공한 후 master에 병합 + 버전 태그 생성 + 푸시 |
지원 채널
| 채널 | 식별자 | 서명 방식 | dry-run | API 제한 |
|---|---|---|---|---|
| 텐센트 앱보우 | yyb | HmacSHA256 | 지원 | 업로드 100회/일, 업데이트 50회/일 |
| 샤오미 앱 스토어 | xiaomi | RSA (X.509 인증서) | 미지원(업로드 시 자동 심사 제출) | 없음 |
| 화웨이 앱 마켓 | huawei | OAuth2 (API 클라이언트) | 미지원 | 없음 |
| OPPO 앱 마켓 | oppo | HmacSHA256 | 미지원 | 50회/일/인터페이스 |
| vivo 앱 마켓 | vivo | HmacSHA256 | 미지원 | 50회/일/인터페이스 |
모든 채널은 중국어 업데이트 문구를 지원하며, --update-desc로 통일 전달됩니다. 화웨이는 추가로 사용자에게 표시되는 newFeatures 필드를 설정합니다.
안전 잠금
심사 제출은 온라인 쓰기 작업이므로 다음 조건이 모두 충족되어야 합니다:
- 명령줄에
--i-know-this-submits-to-production포함 - 환경 변수
PUBLISH_CONFIRM_SUBMIT=YES(멀티 채널) 또는 해당 채널 변수
build_and_submit.py는 --confirm 시 각 하위 프로세스에 해당 환경 변수를 자동으로 설정하므로, PUBLISH_CONFIRM_SUBMIT=YES만 설정하면 됩니다.
채널별 특징
- 앱보우: 업로드와 심사 제출이 분리되어 dry-run을 지원합니다. 하루 업로드 100회, 업데이트 50회 제한.
- 샤오미: 업로드 시 자동 심사 제출되며, 업데이트는 APK + updateDesc만 필요합니다. API 제한 없음.
- 화웨이: Token -> OBS 업로드 -> 파일 정보 업데이트 -> 언어 정보 업데이트(업데이트 문구) -> 2분 대기 -> 제출. 팀 수준 자격 증명은 앱 간에 공통으로 사용됩니다.
- OPPO: 릴리스 인터페이스 필드가 많지만, 쿼리 결과에서 기존 값을 자동으로 재사용합니다. 인터페이스당 하루 50회 제한.
- vivo: APK 업로드 시 요청 번호 + versionCode 반환, 업데이트 인터페이스 필수 필드가 적습니다. 인터페이스당 하루 50회 제한.
사전 조건
- 각 앱 스토어에 앱이 등록되어 있고 성공적으로 릴리스되어 있어야 함
- 프로젝트 루트 디렉터리에
.publish_env파일이 있어야 함(.gitignore에 포함됨), 각 채널 자격 증명 포함 - 샤오미 공개 키 인증서 파일이 프로젝트 루트 디렉터리에 있어야 하며
.gitignore에 추가되어야 함 - 로컬 환경에 Python 3.8+ 및
requests,pycryptodome,cryptography패키지 설치 필요 - 프로젝트 루트 디렉터리에
gradlew가 있어야 하며 Java / Android SDK가 구성되어 있어야 함
단일 채널 작업
각 채널은 독립적인 조회 및 심사 제출을 지원합니다. 자세한 내용은 README.md를 참조하세요.
Bugly 심볼 테이블
패키징 후 자동으로 mapping.txt를 Bugly에 업로드합니다(비차단). 온라인 충돌 스택을 복원할 수 있도록 합니다. jar 도구는 skill의 tools/ 디렉터리에 내장되어 있으며, 자격 증명은 .publish_env에서 읽어옵니다(BUGLY_APP_ID / BUGLY_APP_KEY).