asc 订阅本地化
使用此技能可跨所有 App Store Connect 地区批量创建或更新订阅、订阅组和内购的显示名称(和描述)。这消除了在 App Store Connect 中逐个点击每种语言来设置相同显示名称的繁琐手动过程。
前提条件
- 已配置身份认证(
asc auth login或ASC_*环境变量)。 - 已知您的 App ID(
ASC_APP_ID或--app)。 - 订阅组和订阅已存在。
支持的 App Store 地区
App Store Connect 支持用于订阅和内购本地化的地区如下:
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 "Display Name"
例如,要在所有地区设置“Monthly Pro”:
# 每个地区一条命令(跳过任何已存在的地区)
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 "Group Display Name"
可选:为组设置自定义应用名称:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name" \
--custom-app-name "My App"
3. 验证
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
工作流:批量本地化内购
内购有自己的本地化命令,模式相同。
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 "Display Name"
可选描述:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Unlock All Features" \
--description "One-time purchase to unlock all premium features"
4. 验证
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
更新现有本地化
要更改现有本地化的显示名称:
订阅
asc subscriptions localizations update --id "LOC_ID" --name "New Name"
订阅组
asc subscriptions groups localizations update --id "LOC_ID" --name "New Group Name"
内购
asc iap localizations update --id "LOC_ID" --name "New Name"
要批量更新,先列出现有本地化,提取 ID,然后逐一更新。
批量本地化 App 中的所有订阅
对于一个包含多个订阅组和订阅的完整应用:
# 1. 列出所有组
asc subscriptions groups list --app "APP_ID" --paginate
# 2. 对于每个组,本地化该组本身
# (重复上面的组本地化工作流)
# 3. 对于每个组,列出订阅
asc subscriptions list --group "GROUP_ID" --paginate
# 4. 对于每个订阅,本地化它
# (重复上面的订阅本地化工作流)
代理行为
- 始终先列出现有本地化,以避免重复创建错误。
- 跳过已存在本地化的地区;仅创建缺失的地区。
- 当用户提供一个显示名称时,对所有地区使用该名称(相同名称到处使用)。
- 当用户提供每个地区的翻译名称时,对每个地区使用特定地区的名称。
- 如果提供了描述,则在创建时传递
--description。否则省略。 - 验证步骤使用
--output table,以便用户直观确认。 - 中间自动化步骤使用默认的 JSON 输出。
- 批量创建后,始终运行 list 命令验证完整性。
- 对于包含许多订阅的应用,按组顺序处理以保持输出可读性。
- 如果某个地区的创建调用失败,记录该地区和错误信息,然后继续处理其余地区。在批量操作完成后,一次性报告所有失败,以便用户处理。
备注
- 订阅显示名称是用户在订阅管理界面和购买对话框中看到的内容。
- 为已存在本地化的地区创建本地化将会失败;务必先检查。
- 没有批量 API;每个地区需要单独的创建调用。
- 在列表命令中使用
--paginate以确保返回所有现有本地化。 - 如果您只有应用名称而没有 ID,请使用
asc-id-resolver技能。