asc 订阅本地化
使用此技能可在所有 App Store Connect 语言环境中批量创建或更新订阅、订阅组和内购项目的显示名称(及描述),从而省去在 App Store Connect 中逐个语言手动设置的繁琐过程。
前置条件
- 已配置认证(通过
asc auth login或ASC_*环境变量)。 - 知道您的应用 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-id "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 "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "月度专业版"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "月度专业版"
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 "我的应用"
3. 验证
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
工作流程:批量本地化内购项目
内购项目具有相同模式的本地化命令。
1. 解析内购项目 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 "新组名称"
内购项目
asc iap localizations update --id "LOC_ID" --name "新名称"
要批量更新,先列出现有本地化,提取 ID,然后逐个更新。
批量本地化应用中的所有订阅
对于具有多个订阅组和订阅的完整应用:
# 1. 列出所有组
asc subscriptions groups list --app "APP_ID" --paginate
# 2. 对每个组,本地化组本身
# (重复上面的组本地化工作流程)
# 3. 对每个组,列出订阅
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. 对每个订阅,进行本地化
# (重复上面的订阅本地化工作流程)
代理行为
- 始终先列出现有本地化,以避免重复创建错误。
- 跳过已有本地化的语言环境;仅创建缺失的。
- 当用户提供一个显示名称时,对所有语言环境使用该名称(所有地方名称相同)。
- 当用户提供每个语言环境的翻译名称时,对每个语言环境使用特定名称。
- 如果提供了描述,则在创建时传递
--description。否则省略。 - 验证步骤使用
--output table,以便用户直观确认。 - 中间自动化步骤使用默认的 JSON 输出。
- 批量创建后,始终运行列表命令以验证完整性。
- 对于包含多个订阅的应用,按组顺序处理以保持输出可读性。
- 如果某个语言环境的创建调用失败,记录该语言环境和错误,然后继续处理其余语言环境。批次完成后,汇总报告所有失败,以便用户处理。
备注
- 订阅显示名称是用户在订阅管理界面和购买对话框中看到的名称。
- 为已存在的语言环境创建本地化将失败;务必先检查。
- 没有批量 API;每个语言环境需要单独创建调用。
- 在列表命令中使用
--paginate以确保返回所有现有本地化。 - 如果您只有应用名称而非 ID,请使用
asc-id-resolver技能。