AI Skills
asc-metadata-sync

asc-metadata-sync

熱門

同步、驗證並套用 App Store 中繼資料，使用目前的 asc 標準中繼資料工作流程。適用於更新中繼資料、本地化、關鍵字，或遷移舊版 fastlane 中繼資料。

936星標
49分支
更新於 2026/7/21
獲取技能源代碼

相關技能

daily-prep3.8萬openhue39萬eightctl38萬
SKILL.md
唯讀
名稱
asc-metadata-sync
描述

同步、驗證並套用 App Store 中繼資料，使用目前的 asc 標準中繼資料工作流程。適用於更新中繼資料、本地化、關鍵字，或遷移舊版 fastlane 中繼資料。

asc metadata sync

使用此技能讓 App Store 中繼資料與 App Store Connect 保持同步。建議使用標準的 asc metadata 工作流程來處理 app-info 與版本本地化欄位。僅在使用者明確需要 .strings 檔案或舊版 fastlane 格式中繼資料時，才使用較低階的 asc localizations 與 asc migrate 指令。

目前標準工作流程

1. 拉取標準中繼資料

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

如果 App 有多筆 app-info 記錄，請先解析 app-info 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 用於 App 層級欄位：name、subtitle、privacyPolicyUrl、privacyChoicesUrl、privacyPolicyText
  • metadata/version/<version>/<locale>.json 用於版本欄位：description、keywords、marketingUrl、promotionalText、supportUrl、whatsNew

Copyright 不是本地化欄位。請使用以下指令管理：

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

3. 上傳前驗證

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

對於訂閱型 App，請加入額外的使用條款 / 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"

如需在變更前進行明確核准的審查工件工作流程，請使用 asc 2.6.1 引入的中繼資料審查指令：

asc metadata plan --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --review-dir ".asc/metadata/review"
asc metadata approve --review-dir ".asc/metadata/review" --all
asc metadata status --review-dir ".asc/metadata/review" --output table
asc metadata apply --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" --review-dir ".asc/metadata/review" --confirm

當使用者希望在受保護的套用之前進行選擇性核准時，請使用 asc metadata approve --key "version:en-US:whatsNew" 或 --scope app-info,version。

僅關鍵字工作流程

僅需變更版本本地化的 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"

快速欄位更新

對於一次性版本本地化編輯，請傳入明確的版本選擇器。當您已有版本 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"

對於 app-info 欄位，建議使用建立後的設定指令：

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 時，使用 .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"

對於 app-info 本地化：

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"

字元限制

欄位 限制
名稱 30
副標題 30
關鍵字 100 個逗號分隔字元
描述 4000
最新資訊 4000
促銷文字 170

代理行為

  • 除非使用者明確要求 .strings 或 fastlane 中繼資料，否則從 asc metadata pull 開始。
  • 在遠端寫入前，務必執行 asc metadata validate。
  • 當指令支援時，使用 --dry-run 預覽遠端變更。
  • 當使用者希望在套用前取得持久的審查工件時，使用 asc metadata plan 加上 approve/status。
  • 對於快速編輯，務必傳入 --version-id 或 --version 加上 --platform；不要依賴模糊的最新版本行為。
  • 將 app-info 欄位與版本欄位分開處理。
  • 使用 --output table 進行人工驗證，使用 JSON 進行自動化。