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