App Store Release
App Store Connect API を使ってiOSアプリのApp Store提出を完全に自動化します。設計思想:ユーザーがクレデンシャルと config.json を 一度だけ 提供すれば、エージェントは自動化可能なすべての処理を実行し、AppleがAPIで公開していないごく一部の操作についてのみユーザーに確認を求めます。設定に記載されている項目や適切なデフォルト値がある項目について、ユーザーに再確認を求めないでください。
動作原則(最初に読んでください)
- 設定駆動、プロンプト駆動ではない。 すべてのアプリコンテンツは
config.jsonにあります。コマンドを実行してください。ユーザーにインタビューしないでください。 - UIのみの操作は2つだけ(AppleにAPIがありません):App Privacyのデータ収集 と 初回サブスクリプションのアタッチと提出。これらのツールはこれらの操作を検出し、正確なクリック手順を表示します。それ以外はすべてスクリプト化されています。
- ユーザーに確認を求めるのは以下の場合のみ: 設定に必須項目が欠けている場合(どの項目か正確に伝える)、ビジネス上の判断が設定にない場合(サブスクリプション価格、リリースタイミング)、または唯一の不可逆的な操作(最終提出)の前。それ以外は自動で進めてください。
- 冪等性: すべてのコマンドは再実行しても安全です。
node cli.mjs releaseは何度でも実行可能です。
アーキテクチャ(SOLID原則に基づき、拡張可能)
scripts/
cli.mjs 単一エントリポイント/ディスパッチャ(node cli.mjs <command>)
lib/ 注入されるサービス、各ファイルは単一責任
env.mjs 環境変数の解析と検証(クレデンシャル、アプリID)
jwt.mjs ES256トークンプロバイダ
client.mjs AscClient — 認証 + HTTP + 統一エラー処理
discovery.mjs ASCリソースを自然キーで検索(ハードコードされたIDは使わない)
assets.mjs 予約→アップロード→コミットのバイナリアップローダ
config.mjs 設定の読み込みと検証、不足項目のリスト表示
log.mjs 構造化結果 + 機械可読なサマリ
context.mjs コンポジションルート(依存性注入)
commands/ タスクごとに1ファイル。統一された契約に従う(_contract.md参照)
機能を追加するには = commands/x.mjs(メタデータ + run(ctx))を作成し、cli.mjs に登録します。
セットアップ(1回限り)— references/setup.md を参照
- ASC APIキー(App Manager):
AuthKey_XXXX.p8をダウンロードし、Key IDとIssuer IDをメモします。 - App Store Connectにアプリレコードが存在する(バンドルIDが登録されている)。
ASC_APP_ID= アプリのASC URLから取得した数値ID。 - EASプロジェクトが設定され、
eas loginが完了している。 references/config-template.jsonからconfig.jsonを記入します。任意のコマンドで検証可能:どのコマンドでも不足しているフィールドが正確に表示されます。
環境変数
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # .p8ファイルはgitignore
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # その後: node cli.mjs <command>
実行手順
1. 状況確認
node cli.mjs status # 読み取り専用の全体概要
node cli.mjs check # 準備状況 + まだ保留中のUIのみの手順
2. バイナリのビルド(EAS)
eas buildが古いクレデンシャルで失敗する場合("provisioning profile expired / no certificate with serial…"):その後、eas.jsonのプロダクションプロファイルでnode cli.mjs credentials # 新しい配布証明書とプロファイルを生成 → credentials.json"credentialsSource":"local"を設定します。- バイナリをビルドして提出します(非対話型実行のため
EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID+EXPO_APPLE_TEAM_ID+EXPO_APPLE_TEAM_TYPEをエクスポート):ビルドが VALID になるまで待ちます(eas build -p ios --profile production --non-interactive --no-wait eas submit -p ios --profile production --id <buildId>node cli.mjs statusで確認)。
3. リスティング全体を一括で設定
node cli.mjs release # ビルド添付 → メタデータ → 価格 → コンテンツ権利 →
# 年齢レーティング → カテゴリ → レビュー情報 → スクリーンショット →
# サブスクリプション → チェック
release はパイプライン全体を実行し(冪等)、最後に check を実行して残っている UIのみの 手順を表示します。スクリーンショットは事前に存在している必要があります(config.screenshots.dir)— 生成方法については references/screenshots.md を参照してください。
4. UIのみの2つの手順(正確なクリック手順を提示して引き継ぎ)
check は該当する場合にこれらをリスト表示します:
- App Privacy → データ収集: アプリのプライバシーマニフェストに一致するデータ型を宣言し、公開します。⚠️ バイナリに
NSUserTrackingUsageDescriptionが含まれているがトラッキングを宣言しない場合、公開がブロックされます → キーを削除して再ビルドします(references/gotchas.md 参照)。 - 初回サブスクリプション: バージョンページ → App内課金とサブスクリプション → 選択 → <プロダクト> → 保存 → レビュー用に追加 → 提出。(APIでは初回サブスクリプションをアタッチできません。)
5. 提出
node cli.mjs check # 不足がないことを確認
node cli.mjs submit --submit # アプリのみ / アップデート(初回サブスクリプションは含まない)
初回サブスクリプションがある場合、ユーザーはUIで提出します(手順4.2)。status で確認:バージョンとサブスクリプションの両方が WAITING_FOR_REVIEW になっていることを確認します。
リジェクト時
リジェクトされると、バージョンは再度編集可能になります(REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED)。Resolution Centerのメッセージを読み、修正し(メタデータは release で、バイナリの問題は再ビルドで)、再提出します。
参考資料
references/setup.md— キー作成、アプリレコード、EAS、シークレットの管理方法。references/gotchas.md— 実際に発生するすべての落とし穴(最初の実行前に読んでください)。references/screenshots.md— 正確なサイズのPNGを生成する方法(HTML → ヘッドレスChrome)。references/config-template.json— アプリごとの設定テンプレート(lib/config.mjsで検証)。