asc メタデータ同期

このスキルを使用して、App Store メタデータを App Store Connect と同期させます。アプリ情報とバージョンローカライゼーションフィールドについては、標準的な asc metadata ワークフローを優先的に使用します。ユーザーが特に .strings ファイルまたはレガシー fastlane 形式のメタデータを必要とする場合のみ、下位レベルの asc localizations および asc migrate コマンドを使用します。

現在の標準的なワークフロー

1. 標準的なメタデータをプル

asc metadata pull --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"

アプリに複数のアプリ情報レコードがある場合は、まずアプリ情報 ID を解決して、明示的に渡します:

asc apps info list --app "APP_ID" --output table
asc metadata pull --app "APP_ID" --app-info "APP_INFO_ID" --version "1.2.3" --platform IOS --dir "./metadata"

2. ローカルファイルを編集

標準的なファイルは以下の場所に書き込まれます:

• metadata/app-info/<locale>.json - アプリレベルのフィールド: name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText
• metadata/version/<version>/<locale>.json - バージョンフィールド: description, keywords, marketingUrl, promotionalText, supportUrl, whatsNew

著作権はローカライゼーションフィールドではありません。以下を使用して管理します:

asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company"

3. アップロード前に検証

asc metadata validate --dir "./metadata" --output table

サブスクリプションアプリの場合は、追加の利用規約 / EULA ヒューリスティックを含めます:

asc metadata validate --dir "./metadata" --subscription-app --output table

4. プレビューと適用

まずドライランを実行します:

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"

ユーザーが同じ標準的なファイルに対して apply という名前のコマンドを望む場合は asc metadata apply を使用します:

asc metadata apply --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --dry-run
asc metadata apply --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"

キーワードのみのワークフロー

バージョンローカライゼーションの keywords フィールドのみを変更する場合に使用します:

asc metadata keywords diff --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"
asc metadata keywords apply --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --confirm

キーワード調査をインポートする場合:

asc metadata keywords import --dir "./metadata" --version "1.2.3" --locale "en-US" --input "./keywords.csv"
asc metadata keywords sync --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --input "./keywords.csv"

クイックフィールド更新

1 回限りのバージョンローカライゼーション編集の場合は、明示的なバージョンセレクターを渡します。既にバージョン ID を持っている場合は --version-id を使用して決定論的な更新を行うか、バージョン文字列から作業する場合は --version と --platform を使用します。

asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "en-US" --whats-new "Bug fixes and improvements"
asc apps info edit --app "APP_ID" --version "1.2.3" --platform IOS --locale "en-US" --description "Your app description here"
asc apps info edit --app "APP_ID" --version "1.2.3" --platform IOS --locale "en-US" --keywords "keyword1,keyword2,keyword3"
asc apps info edit --app "APP_ID" --version "1.2.3" --platform IOS --locale "en-US" --support-url "https://support.example.com"

アプリ情報フィールドの場合は、作成後のセットアップコマンドを優先します:

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

下位レベルのローカライゼーションファイル

ユーザーが標準的な JSON ではなく import/export ファイルの .strings ファイルを特に望む場合に使用します:

asc localizations list --version "VERSION_ID" --output table
asc localizations download --version "VERSION_ID" --path "./localizations"
asc localizations upload --version "VERSION_ID" --path "./localizations" --dry-run
asc localizations upload --version "VERSION_ID" --path "./localizations"

アプリ情報のローカライゼーション:

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
asc localizations download --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations" --dry-run
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

レガシー fastlane メタデータ

既存の fastlane 形式のツリーでのみ使用します:

asc migrate export --app "APP_ID" --version-id "VERSION_ID" --output-dir "./fastlane"
asc migrate validate --fastlane-dir "./fastlane"
asc migrate import --app "APP_ID" --version-id "VERSION_ID" --fastlane-dir "./fastlane" --dry-run
asc migrate import --app "APP_ID" --version-id "VERSION_ID" --fastlane-dir "./fastlane"

文字数制限

フィールド	制限
Name (名前)	30
Subtitle (サブタイトル)	30
Keywords (キーワード)	100 (カンマ区切り)
Description (説明)	4000
What's New (新機能)	4000
Promotional Text (プロモーションテキスト)	170

Agent の動作

• ユーザーが特に .strings ファイルまたは fastlane メタデータを求めない限り、asc metadata pull で開始します。
• リモート書き込みの前に常に asc metadata validate を実行します。
• コマンドがサポートしている場合は --dry-run でリモート変更をプレビューします。
• クイック編集の場合は、常に --version-id または --version と --platform を渡します。曖昧な最新バージョン動作に依存しないでください。
• アプリ情報フィールドとバージョンフィールドを分けておきます。
• 人間による検証には --output table を、自動化には JSON を使用します。