Community생산성 & 협업github.com

AngChow/android-publish

Android 앱 패키징 및 앱스토어 심사 제출 전 과정을 자동화하는 Codex Skill: 사전 점검 → 패키징 → Bugly 심볼 테이블 업로드 → 멀티 채널 심사 제출(텐센트 앱보우/샤오미/화웨이/OPPO/vivo) → Git 태그 생성

android-publish란 무엇인가요?

이 Skill은 Android 애플리케이션의 릴리스 패키징(packaging)과 여러 중국 앱 스토어(텐센트 앱보우, 샤오미, 화웨이, OPPO, vivo)에 대한 심사 제출(submission)을 완전 자동화합니다. 사용자가 "패키징하여 심사 제출" 또는 "멀티 채널 제출"을 요청하면, 사전 점검(pre-check) → APK 빌드 → Bugly 심볼 파일 자동 업로드 → 각 스토어 API를 통한 제출 → Git 태그 생성까지 하나의 명령어로 실행합니다. 이 Skill은 Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼과 호환되며, Python 스크립트 기반으로 작동합니다. 주요 장점으로는 업데이트 설명 통일, 각 채널별 API 특성(예: dry-run 지원 여부, 일일 호출 한도)에 맞춘 안전한 제출, 실패 시에도 다른 채널에 영향을 주지 않는 격리된 처리, 그리고 Bugly 충돌 스택 복원을 위한 심볼 업로드 기능이 포함됩니다. 사용자는 미리 생성된 Gradle signing 설정, 스토어 API 자격 증명(credentials)을 `.publish_env` 파일에 저장하고, 단일 명령어로 전체 프로세스를 트리거할 수 있으며, `--dry-run` 및 `--skip-*` 플래그를 통해 일부 단계를 선택적으로 실행하거나 건너뛸 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AngChow/android-publish

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Android 앱 릴리스 Skill

릴리스 APK를 빌드하고 텐센트 앱보우/샤오미/화웨이/OPPO/vivo 5대 앱 스토어에 제출하여 엔드투엔드 자동화를 제공합니다.

실행 명령어

사용자가 "패키징하여 심사 제출"(또는 "출시" / "앱 등록" / "앱 배포" / "멀티 채널 제출" 등)을 요청하면:

  1. 업데이트 문구 확인: 사용자가 지정하지 않으면 기본값 "알려진 문제 수정 및 사용자 경험 최적화"를 사용하거나 사용자에게 문의합니다.
  2. 올인원 명령어 실행:
    PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
        --i-know-this-submits-to-production \
        --update-desc "<업데이트 문구>" \
        <프로젝트 루트 디렉터리>
    
  3. 출력 모니터링: 스크립트가 전체 단계(사전 점검 -> 패키징 -> Bugly -> 멀티 채널 제출 -> Git 태그)를 자동으로 완료하며, 수동 개입이 필요하지 않습니다.
  4. 결과 보고: 각 채널의 성공/실패 상태를 사용자에게 요약합니다.
  5. 예외 처리: 사전 점검 실패(서명/버전 번호) 시 중단하고 구체적인 이유를 사용자에게 알립니다. 특정 채널 실패는 다른 채널에 영향을 주지 않습니다.

패키징만 하고 제출하지 않음 (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 assembleReleaseapp-arm64-v8a-release.apk 찾기(64비트 패키지만 업로드)
Step 1.5 Buglyupload_bugly_symbol.pymapping.txt 업로드(비차단, 실패해도 심사 제출에 영향 없음)
Step 2 멀티 채널 제출각 채널 *_submit.py구성된 자격 증명이 있는 채널에 순차적으로 업로드, 독립적인 안전 잠금
Step 3 Git 태그git_tag.py모두 성공한 후 master에 병합 + 버전 태그 생성 + 푸시

지원 채널

채널식별자서명 방식dry-runAPI 제한
텐센트 앱보우yybHmacSHA256지원업로드 100회/일, 업데이트 50회/일
샤오미 앱 스토어xiaomiRSA (X.509 인증서)미지원(업로드 시 자동 심사 제출)없음
화웨이 앱 마켓huaweiOAuth2 (API 클라이언트)미지원없음
OPPO 앱 마켓oppoHmacSHA256미지원50회/일/인터페이스
vivo 앱 마켓vivoHmacSHA256미지원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회 제한.

사전 조건

  1. 각 앱 스토어에 앱이 등록되어 있고 성공적으로 릴리스되어 있어야 함
  2. 프로젝트 루트 디렉터리에 .publish_env 파일이 있어야 함(.gitignore에 포함됨), 각 채널 자격 증명 포함
  3. 샤오미 공개 키 인증서 파일이 프로젝트 루트 디렉터리에 있어야 하며 .gitignore에 추가되어야 함
  4. 로컬 환경에 Python 3.8+ 및 requests, pycryptodome, cryptography 패키지 설치 필요
  5. 프로젝트 루트 디렉터리에 gradlew가 있어야 하며 Java / Android SDK가 구성되어 있어야 함

단일 채널 작업

각 채널은 독립적인 조회 및 심사 제출을 지원합니다. 자세한 내용은 README.md를 참조하세요.

Bugly 심볼 테이블

패키징 후 자동으로 mapping.txt를 Bugly에 업로드합니다(비차단). 온라인 충돌 스택을 복원할 수 있도록 합니다. jar 도구는 skill의 tools/ 디렉터리에 내장되어 있으며, 자격 증명은 .publish_env에서 읽어옵니다(BUGLY_APP_ID / BUGLY_APP_KEY).

관련 스킬