asc submission health

このスキルを使用して、レビュー投稿の失敗を減らしレビュー状態を監視します。現在の準備状態確認コマンドは asc validate です。レガシーな submit-preflight と submit-create ショートカットは使用してはいけません。

前提条件

• 認証が設定され、アプリ/バージョン/ビルド ID が解決されている。
• ビルド処理が完了しているか、コマンドが --wait を使用した高レベルフローを実行している。
• メタデータ、アプリ情報、スクリーンショット、レビュー詳細、コンテンツ権、暗号化、価格、および提供状況が完全であると想定されている。

投稿前チェックリスト

1. ビルド状態の確認

asc builds info --build-id "BUILD_ID"

確認事項:

• processingState が VALID である。
• 投稿前に暗号化フィールドを理解している。

2. 標準的な準備状態の検証を実行

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

警告がオートメーションを失敗させるべき場合は厳密モードを使用します:

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

正確なバージョン ID がすでにある場合:

asc validate --app "APP_ID" --version-id "VERSION_ID" --platform IOS --output table

3. 暗号化コンプライアンス

ビルドが非免除暗号化を使用する場合:

asc encryption declarations list --app "APP_ID"

asc encryption declarations create \
  --app "APP_ID" \
  --app-description "Uses standard HTTPS/TLS" \
  --contains-proprietary-cryptography=false \
  --contains-third-party-cryptography=true \
  --available-on-french-store=true

asc encryption declarations assign-builds \
  --id "DECLARATION_ID" \
  --build "BUILD_ID"

アプリが真に免除トランスポート暗号化のみを使用する場合は、ローカル plist を更新し再ビルドすることをお勧めします:

asc encryption declarations exempt-declare --plist "./Info.plist"

4. コンテンツ権の宣言

asc apps content-rights view --app "APP_ID"
asc apps content-rights edit --app "APP_ID" --uses-third-party-content=false

5. バージョンメタデータとローカライズ

asc versions view --version-id "VERSION_ID" --include-build --include-submission
asc localizations list --version "VERSION_ID" --output table

標準的なメタデータ修復の場合:

asc metadata pull --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"
asc metadata validate --dir "./metadata" --output table
asc metadata push --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --dry-run --output table
asc metadata push --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"

6. アプリ情報のローカライズとプライバシーポリシー

asc apps info list --app "APP_ID" --output table
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --output table

サブスクリプションまたは IAP アプリの場合、プライバシーポリシー URL が設定されていることを確認します:

asc app-setup info set --app "APP_ID" --primary-locale "en-US" --privacy-policy-url "https://example.com/privacy"

7. スクリーンショット

asc screenshots list --version-localization "LOC_ID" --output table
asc screenshots sizes --output table
asc screenshots validate --path "./screenshots" --device-type "IPHONE_65" --output table

8. デジタル商品の準備

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

正確な診断が必要な場合は JSON を使用します:

asc validate subscriptions --app "APP_ID" --output json --pretty

9. アプリプライバシー説明

公開 API ではアプリプライバシー公開状態を完全に検証することはできません。検証がアドバイザリを報告する場合は、実験的な web セッションフローを使用するか、手動で確認してください。

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

手動フォールバック:

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

投稿

準備済みバージョンの投稿

明示的な App Store レビュー投稿には asc review submit を使用します:

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_ID" を使用します。

1 つのフローでアップロードと投稿

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

コマンドがビルド処理を待つべき場合は --wait を追加します。

複数アイテムのレビュー投稿

Game Center コンポーネントバージョンなど、投稿が複数のレビューアイテムを必要とする場合は、低レベルのレビュー投稿 API を使用します:

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 gameCenterChallengeVersions --item-id "GC_CHALLENGE_VERSION_ID"
asc review submissions-submit --id "SUBMISSION_ID" --confirm

監視

asc status --app "APP_ID"
asc submit status --id "SUBMISSION_ID"
asc submit status --version-id "VERSION_ID"
asc review submissions-list --app "APP_ID" --paginate

キャンセルと再試行

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

検証の問題を修正してから、asc review submit または asc publish appstore --submit --confirm で再投稿します。

よくある投稿エラー

バージョンが有効な状態ではない

確認事項:

1. ビルドが添付されており VALID である。
2. 暗号化宣言が解決されているか免除されている。
3. コンテンツ権宣言が設定されている。
4. 必要なローカライズとスクリーンショットが存在する。
5. レビュー詳細が存在する。
6. 価格と提供状況が存在する。
7. アプリプライバシーが App Store Connect でレビュー済みで公開されている。

エクスポートコンプライアンスを承認する必要がある

エクスポートコンプライアンスドキュメントをアップロードするか、アプリを正確に説明する場合は免除暗号化メタデータで再ビルドしてください。

複数のアプリ情報が見つかった

正確なアプリ情報 ID を使用します:

asc apps info list --app "APP_ID" --output table

注釈

• レガシーな submit-preflight または submit-create ショートカットは使用しないでください。削除されています。
• 準備状態確認には asc validate を使用します。
• 準備済みバージョンの投稿には asc review submit を使用します。
• 高レベルのアップロードと投稿には asc publish appstore --submit --confirm を使用します。
• アプリプライバシー公開状態は公開 API では完全に検証できません。
• 人間が読む状態には --output table を、オートメーションには JSON を使用します。
• macOS 投稿は同じレビューフローに従いますが、--platform MAC_OS を使用します。