app-store-connect-cli

App Store Connect CLI（`asc`）は、iOS、macOS、tvOS、visionOSプラットフォーム全体でApp Store Connectワークフローを自動化するための高速でスクリプト可能なコマンドラインツールです。 ### インストール - Homebrew: `brew install asc` - インストールスクリプト: `curl -fsSL https://asccli.sh/install | bash` - WinGet: `winget install Rorkai.ASC --exact` - リリースバイナリはGitHubリリースから入手可能。ソースビルドにはgo.modで宣言されたGoバージョンが必要。 ### 認証 APIキーはappstoreconnect.apple.comで生成します。認証方法: ```bash asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network ``` 個別APIキーは`--issuer-id`を省略し、`--key-type individual`を使用します。CIやヘッドレス環境では`--bypass-keychain`を渡します。`asc auth status --validate`または`asc auth doctor`で検証できます。 ### 出力のデフォルト `asc`は対話型ターミナルでは`table`出力、パイプ/CIでは`json`を使用します。`ASC_DEFAULT_OUTPUT`でグローバルに、または`--output json --pretty`でコマンドごとに上書きできます。 ### 一般的なワークフロー **TestFlightとビルド:** ```bash asc apps list --output table asc builds upload --app "APP_ID" --ipa "/path/to/MyApp.ipa" asc testflight groups list --app "APP_ID" ``` **App Store提出:** ```bash asc publish appstore --app "APP_ID" --ipa "/path/to/MyApp.ipa" --version "1.2.3" --submit --confirm asc status --app "APP_ID" --watch ``` **検証とレビュー:** ```bash asc validate --app "APP_ID" --version "1.2.3" asc review status --app "APP_ID" asc validate --app "APP_ID" --version "1.2.3" --deep ``` ディープ検証は、対話型プロンプトなしでAppleのサインイン済みWebエンドポイントを介して、App Privacy、契約、サブスクリプションの添付をチェックします。 **メタデータとローカライゼーション:** ```bash asc localizations list --app "APP_ID" --type app-info asc metadata apply --app "APP_ID" --version "1.2.3" --dir "./metadata" --dry-run asc metadata keywords audit --app "APP_ID" --version "1.2.3" --blocked-terms-file "./blocked-terms.txt" ``` キーワード監査は、重複、アプリ名/サブタイトルとの重なり、バイトバジェットの使用量、ブロックされた用語を報告します。 **スクリーンショットとメディア:** ```bash asc screenshots plan --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" asc screenshots apply --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" --confirm ``` デバイス、ロケール、外観にわたるマトリックスベースのスクリーンショットキャプチャは、JSONCプランファイルを介してサポートされています。 **署名とバンドルID:** ```bash asc bundle-ids capabilities list --bundle "BUNDLE_ID" asc signing fetch --bundle-id com.example.app --profile-type IOS_APP_STORE --output .asc/signing asc signing sync pull --repo [email protected]:team/signing.git --password-file ~/.config/asc/signing-sync-password --output-dir .asc/signing/pulled ``` `signing fetch`は証明書とプロビジョニングプロファイルをダウンロードします。`signing sync`は暗号化されたGitストアを通じてIDを共有します。`--create-missing`を使用すると、不足しているキー/証明書/プロファイルを一度に生成できます。 **ワークフロー自動化:** ```bash asc workflow validate --output json asc workflow run --dry-run testflight_beta VERSION:1.2.3 ``` **Xcode Cloud:** ```bash asc xcode-cloud run --workflow-id "WORKFLOW_ID" --pull-request-id "PR_ID" asc xcode-cloud build-runs get --id "BUILD_RUN_ID" ``` **Apple AdsとStoreKit:** Apple AdsキャンペーンとStoreKit Retention Messagingには別々のOAuth認証情報が使用されます。セットアップについては`asc ads auth login`と`asc storekit auth login`を参照してください。 ### エージェントスキル 25のレビュー済み`asc`自動化スキルがhttps://github.com/rorkai/app-store-connect-cli-skillsで利用可能です。`asc install-skills`でグローバルにインストールでき、チェックアウトされたコミットを固定し、すべてのファイルを検証します。 ### プライバシーとテレメトリ メンテナーが信頼性を追跡できるよう、デフォルトで仮名のコマンドレベルテレメトリが送信されます。イベントにはCLIバージョン、OS、アーキテクチャ、コマンドパス、期間、失敗時のHTTPステータスが含まれます。生の引数、認証情報、Appleアカウント識別子、バンドルID、ファイルパスは除外されます。`ASC_TELEMETRY_DISABLED=1`、`DO_NOT_TRACK=1`、または`asc telemetry disable`で無効化できます。 ### ドキュメント - `docs/CI_CD.md` — GitHub Actions、GitLab、Bitrise、CircleCI統合 - `docs/WORKFLOWS.md` — ローカルXcodeからTestFlightへのパターン - `commands/signing.mdx` — 署名IDのセットアップとCIローテーション - `guides/apple-ads-playbooks.mdx` — Apple Adsオペレーターガイド - `docs/API_NOTES.md` — APIの癖と動作 - `docs/PARITY.md` — 残りのパリティ領域 組み込みヘルプが正式な情報源です: `asc <command> --help`。 ライセンス: MIT。非公式ツールであり、Apple Inc.とは提携していません。