AngChow/android-publish

Android アプリのパッケージ化から審査提出までの全工程を自動化する Codex スキル:事前チェック → パッケージ化 → Bugly シンボルテーブルアップロード → マルチチャンネル審査提出(テンセント応用宝/シャオミ/ファーウェイ/OPPO/vivo)→ Git タグ作成

android-publish とは?

このスキルは、Android アプリのリリースパッケージをビルドし、中国の主要5つのアプリマーケット(テンセント応用宝、シャオミ、ファーウェイ、OPPO、vivo)に自動で審査提出を行うエンドツーエンドの自動化ツールです。ユーザーが「パッケージ化して審査提出」と指示するだけで、事前チェック(署名設定、バージョンコードの検証)、Gradle によるリリースビルド、Bugly へのシンボルファイルアップロード、各ストアへの並行アップロード、そして Git タグ作成までを一貫して実行します。各チャンネルごとに異なる API 認証方式(HmacSHA256、RSA、OAuth2)に対応し、安全ロック機構により誤操作を防止。ドライラン(応用宝のみ)や特定ステップのスキップも柔軟にサポートします。開発者は煩雑なリリース作業から解放され、安定したリリースプロセスを実現できます。

対応~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

リリースパッケージを作成し、テンセント応用宝/シャオミ/ファーウェイ/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 Client)非対応なし
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)。

関連スキル