Communitygithub.com

exiao/skills

使用 asc 工具大量在地化 App Store 所有地區的訂閱項目與 App 內購買顯示名稱。當您想要為每種語言填入訂閱/IAP 名稱,而不需在 App Store Connect 中逐一點選時使用。

skills 是什麼?

此技能提供一個自動化流程,用於在 App Store Connect 中跨所有支援的地區批量建立或更新訂閱項目、訂閱群組及 App 內購買 (IAP) 的顯示名稱(及描述)。它能消除開發者逐一在 App Store Connect 介面中為每種語言點選設定的繁瑣手動工作。技能依賴官方的 `asc` 命令列工具,並要求先完成驗證設定(如 `asc auth login` 或設定 `ASC_*` 環境變數)以及提供應用程式 ID。主要工作流程包括:先列出既有的在地化資料以避免重複,然後對缺少的地區逐一執行 `asc` 的 create 指令,最後驗證結果。技能支援 App Store Connect 定義的完整地區清單(超過 35 個語系),並可分別套用於訂閱項目、訂閱群組與 IAP。此外,也提供更新既有在地化資料的指令模式。對於大型應用程式,建議按群組依序處理以保持輸出可讀性,並且在批量建立過程中若發生錯誤會記錄地區與錯誤訊息,並在批次結束後一併回報。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

asc 訂閱在地化

使用此技能可跨所有 App Store Connect 地區批量建立或更新訂閱項目、訂閱群組與 App 內購買的顯示名稱(及描述)。這能消除在 App Store Connect 中逐一為每種語言點選設定相同顯示名稱的繁瑣手動流程。

前置條件

  • 已設定驗證(asc auth login 或 ASC_* 環境變數)。
  • 知道您的應用程式 ID(ASC_APP_ID 或 --app)。
  • 訂閱群組與訂閱項目已存在。

支援的 App Store 地區

以下是 App Store Connect 針對訂閱和 IAP 在地化所支援的地區:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

工作流程:批量在地化訂閱項目

1. 解析 ID

# 尋找訂閱群組
asc subscriptions groups list --app "APP_ID" --output table

# 尋找群組內的訂閱項目
asc subscriptions list --group "GROUP_ID" --output table

2. 檢查現有在地化資料

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

這會顯示哪些地區已設定名稱。僅為缺少的地區建立在地化資料。

3. 為所有缺少的地區建立在地化資料

針對尚未有在地化資料的每個地區,執行:

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "顯示名稱"

例如,要跨所有地區設定「每月專業版」:

# 每個地區一個指令(跳過已存在的地區)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"

4. 驗證

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

工作流程:批量在地化訂閱群組

訂閱群組也有其各自地區的顯示名稱(這是使用者在訂閱管理頁面中看到的「群組名稱」)。

1. 檢查現有群組在地化資料

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

2. 為缺少的地區建立在地化資料

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "群組顯示名稱"

可選:為群組設定自訂應用程式名稱:

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "群組顯示名稱" \
  --custom-app-name "我的 App"

3. 驗證

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

工作流程:批量在地化 App 內購買

App 內購買 (IAP) 有其自己的在地化指令,模式相同。

1. 解析 IAP ID

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

2. 檢查現有在地化資料

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

3. 為缺少的地區建立在地化資料

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "顯示名稱"

可選的描述:

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "解鎖所有功能" \
  --description "一次購買即可解鎖所有進階功能"

4. 驗證

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

更新現有在地化資料

若要變更現有在地化資料的顯示名稱:

訂閱項目

asc subscriptions localizations update --id "LOC_ID" --name "新名稱"

訂閱群組

asc subscriptions groups localizations update --id "LOC_ID" --name "新群組名稱"

App 內購買

asc iap localizations update --id "LOC_ID" --name "新名稱"

若要批量更新,請先列出現有在地化資料,擷取 ID,然後逐一更新。

批量在地化應用程式中的所有訂閱項目

針對包含多個訂閱群組與訂閱項目的完整應用程式:

# 1. 列出所有群組
asc subscriptions groups list --app "APP_ID" --paginate

# 2. 針對每個群組,在地化群組本身
#    (重複上述群組在地化工作流程)

# 3. 針對每個群組,列出訂閱項目
asc subscriptions list --group "GROUP_ID" --paginate

# 4. 針對每個訂閱項目,進行在地化
#    (重複上述訂閱在地化工作流程)

代理行為

  • 一律先列出現有在地化資料,以避免重複建立的錯誤。
  • 跳過已有在地化資料的地區;僅建立缺少的。
  • 當使用者提供單一顯示名稱時,將其用於所有地區(各處使用相同名稱)。
  • 當使用者提供每個地區的翻譯名稱時,對每個地區使用對應的地區特定名稱。
  • 若提供了描述,則在建立時傳入 --description。否則忽略它。
  • 驗證步驟使用 --output table,讓使用者可以視覺確認。
  • 中間自動化步驟使用預設的 JSON 輸出。
  • 批量建立後,一律執行 list 指令以驗證完整性。
  • 對於包含許多訂閱項目的應用程式,按群組依序處理以保持輸出可讀性。
  • 如果某個地區的 create 呼叫失敗,請記錄該地區和錯誤,然後繼續處理其餘地區。在批次完成後,一併回報所有失敗,以便使用者處理。

備註

  • 訂閱顯示名稱是使用者在訂閱管理頁面和購買對話框中看到的內容。
  • 為已存在的地區建立在地化資料將會失敗;請務必先檢查。
  • 沒有批量 API;每個地區需要個別的 create 呼叫。
  • 在 list 指令上使用 --paginate 以確保傳回所有現有在地化資料。
  • 如果您只有應用程式名稱而沒有 ID,請使用 asc-id-resolver 技能。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能