リリースフロー (readiness-first)

「今すぐアプリを submit できるか?」という質問の場合、またはユーザーが現在の asc コマンドで App Store バージョンを準備・submit したい場合に、このスキルを使用してください。

前提条件

• 必要に応じて APP_ID、バージョン文字列、VERSION_ID、BUILD_ID を事前に解決する。
• asc auth login または ASC_* 環境変数で認証が設定されていることを確認する。
• metadata-driven staging を使う場合、./metadata に正規メタデータを配置する。
• asc web ... コマンドは public API でカバーされていないフロー用の試験的な escape hatch として扱う。

回答順序

1. アプリが今すぐ ready かどうかを述べる。
2. ブロッキング課題を列挙する。
3. public API で解決可能な課題と web-session・手動での解決が必要な課題を分ける。
4. 実行する次のコマンドを正確に提示する。

ブロッカーは通常以下のカテゴリに分かれます:

• API で解決可能: build の有効性、メタデータ、スクリーンショット、review の詳細、コンテンツ権、暗号化、version/build の attach、IAP readiness、Game Center version と review-submission items。
• web-session で解決可能: 初期アプリ availability の bootstrap、初回 review の subscription attach、App Privacy の publish state。
• 手動フォールバック: CLI attach フローが存在しないときの初回 IAP selection (app-version ページ上)、またはユーザーが試験的 web-session コマンドを実行したくないフロー。

正規の現在のパス

1. Readiness check

asc validate を使用してください。古い submit-preflight ショートカットは現在の CLI には含まれていません。

asc validate --app "APP_ID" --version "1.2.3" --platform IOS --output table

警告が automation をブロックすべき場合は strict mode を使用:

asc validate --app "APP_ID" --version "1.2.3" --platform IOS --strict --output table

デジタル商品を販売するアプリの場合は、product readiness check も実行:

asc validate iap --app "APP_ID" --output table
asc validate subscriptions --app "APP_ID" --output table

2. Submit せずに stage する

ユーザーが version を準備し、メタデータを適用・コピーして build を attach し、review submission の前に停止したい場合は asc release stage を使用します。

asc release stage \
  --app "APP_ID" \
  --version "1.2.3" \
  --build "BUILD_ID" \
  --metadata-dir "./metadata/version/1.2.3" \
  --dry-run \
  --output table

plan が正しく見えた後、staging mutations を適用:

asc release stage \
  --app "APP_ID" \
  --version "1.2.3" \
  --build "BUILD_ID" \
  --metadata-dir "./metadata/version/1.2.3" \
  --confirm

--metadata-dir の代わりに --copy-metadata-from "1.2.2" を使用して、既存 version からメタデータを引き継ぐ場合:

3. 既に準備された version を submit する

明示的な App Store review submission には asc review submit を使用します。build attachment と review submission creation をラップしています。

asc review submit --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --dry-run --output table
asc review submit --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --confirm

既に正確な version ID を解決している場合は --version の代わりに --version-id "VERSION_ID" を使用:

4. 1 つのコマンドで upload と submit を実行

upload/build/local-build と submission を 1 つの高レベルフローにすべき場合は asc publish appstore を使用:

asc publish appstore --app "APP_ID" --ipa "./App.ipa" --version "1.2.3" --submit --dry-run --output table
asc publish appstore --app "APP_ID" --ipa "./App.ipa" --version "1.2.3" --submit --confirm

build processing 前に attach/submit する際、コマンドが待機すべき場合は --wait を追加:

5. モニタリングと cancel

asc status --app "APP_ID"
asc submit status --version-id "VERSION_ID"
asc submit status --id "SUBMISSION_ID"
asc submit cancel --id "SUBMISSION_ID" --confirm

初回 submission のブロッカー

初期アプリ availability が存在しない

症状:

• asc pricing availability view --app "APP_ID" が availability なしを報告。
• 既存の availability record がないため asc pricing availability edit ... で更新不可。

確認:

asc pricing availability view --app "APP_ID"

試験的 web-session フローで初回 availability record をbootstrap:

asc web apps availability create \
  --app "APP_ID" \
  --territory "USA,GBR" \
  --available-in-new-territories true

bootstrap 後、継続的な変更には public API を使用:

asc pricing availability edit \
  --app "APP_ID" \
  --territory "USA,GBR" \
  --available true \
  --available-in-new-territories true

Subscriptions は ready だが初回 review に attach されていない

まず subscription readiness を確認:

asc validate subscriptions --app "APP_ID" --output table

診断にメタデータ不足が報告される場合、attach 前にそれらの前提条件を修正してください。よくある不足は、広範な pricing coverage、review スクリーンショット、promotional images、app/build evidence です。

初回 review subscription state をリスト:

asc web review subscriptions list --app "APP_ID"

初回 review 用にグループを attach:

asc web review subscriptions attach-group \
  --app "APP_ID" \
  --group-id "GROUP_ID" \
  --confirm

1 つの subscription を attach:

asc web review subscriptions attach \
  --app "APP_ID" \
  --subscription-id "SUB_ID" \
  --confirm

後の review では、public review path 経由で subscriptions を submit:

asc subscriptions review submit --subscription-id "SUB_ID" --confirm

In-app purchases に review readiness または初回 version 含有が必要

asc validate iap --app "APP_ID" --output table

欠落している review スクリーンショットをアップロード:

asc iap review-screenshots create --iap-id "IAP_ID" --file "./review.png"

公開済みアプリ上の IAP の場合:

asc iap submit --iap-id "IAP_ID" --confirm

アプリ上の初回 IAP、または初めて新しい IAP type を追加する場合、Apple は app version の「In-App Purchases and Subscriptions」セクションから IAP を選択してから app version を submit するよう要求することがあります。IAP を localization、pricing、review screenshot データで先に準備してください。

Game Center は app-version と review-submission items が必要

asc game-center app-versions list --app "APP_ID"
asc game-center app-versions create --app-store-version-id "VERSION_ID"

Game Center component version を app version と共に ship すべき場合、explicit review-submission API を使用して、submit 前にすべての items を追加できます:

asc review submissions-create --app "APP_ID" --platform IOS
asc review items-add --submission "SUBMISSION_ID" --item-type appStoreVersions --item-id "VERSION_ID"
asc review items-add --submission "SUBMISSION_ID" --item-type gameCenterLeaderboardVersions --item-id "GC_LEADERBOARD_VERSION_ID"
asc review submissions-submit --id "SUBMISSION_ID" --confirm

asc review items-add は gameCenterAchievementVersions、gameCenterActivityVersions、gameCenterChallengeVersions、gameCenterLeaderboardSetVersions もサポート。

App Privacy がまだ unpublished

public API は privacy advisories を表示できますが、App Privacy の publish state は完全に検証できません。

asc web privacy pull --app "APP_ID" --out "./privacy.json"
asc web privacy plan --app "APP_ID" --file "./privacy.json"
asc web privacy apply --app "APP_ID" --file "./privacy.json"
asc web privacy publish --app "APP_ID" --confirm

ユーザーが試験的 web-session コマンドを避ける場合、App Store Connect で手動で App Privacy を確認:

https://appstoreconnect.apple.com/apps/APP_ID/appPrivacy

Review 詳細が不完全

asc review details-for-version --version-id "VERSION_ID"

詳細を作成または更新:

asc review details-create \
  --version-id "VERSION_ID" \
  --contact-first-name "Dev" \
  --contact-last-name "Support" \
  --contact-email "dev@example.com" \
  --contact-phone "+1 555 0100" \
  --notes "Explain the reviewer access path here."

asc review details-update \
  --id "DETAIL_ID" \
  --notes "Updated reviewer instructions."

App Review が本当にデモ認証情報を必要とする場合のみ demo-account フィールドを設定:

Ready チェックリスト

アプリが effectively ready な場合:

• asc validate --app "APP_ID" --version "VERSION" --platform IOS にブロッキング課題がない。
• asc release stage --dry-run が期待される plan を出力する、または asc release stage --confirm がターゲット version を正常に準備している。
• build が VALID でターゲット version に attach されている。
• メタデータ、スクリーンショット、app info、コンテンツ権、暗号化、年齢評価、review 詳細が完全。
• App availability が存在する。
• デジタル商品に localization、pricing、review スクリーンショット、および初回 review attachment または手動選択が処理されている。
• 必要に応じて Game Center app-version と component review items が含まれている。
• App Privacy が確認または publish されている。

注記

• 古い submit-preflight、submit-create、release-run ショートカットは使用しないでください。これらは現在の CLI には含まれていません。
• readiness には asc validate を使用。
• pre-submit 準備には asc release stage を使用。
• 明示的な App Store review submission には asc review submit を使用。
• 高レベルの upload + submission には asc publish appstore --submit --confirm を使用。
• submission 後は asc status と asc submit status を使用。