Communitygithub.com

exiao/skills

使用 asc 命令批量本地化订阅和内购显示名称至所有 App Store 地区。当您想为每个语言填写订阅/IAP 名称而无需在 App Store Connect 中手动点击时使用。

skills 是什么?

此技能提供了一种高效的自动化工具体系,用于在 App Store Connect 中批量创建或更新订阅、订阅组和内购 (IAP) 的显示名称(及描述)到所有支持的地区。它通过 asc 命令行工具,消除了在 App Store Connect 界面中逐一点击每个语言手动设置的繁琐过程,显著提升了开发者的工作效率。技能详细说明了操作的前提条件(如认证、App ID 信息),并逐步指导用户完成从查找资源ID、检查现有本地化、批量创建缺失本地化到最终验证的完整工作流。它涵盖了订阅、订阅组和内购三种资源类型,每种都包含解决 ID、列出现有本地化和创建新本地化的具体命令示例。同时,技能也提供了更新现有本地化的方法以及处理拥有多个订阅组的复杂应用的策略。脚本的执行逻辑明确:始终先检查现有本地化以避免重复创建错误,支持对所有地区使用同一名称或针对不同地区提供特定翻译名称,并能处理描述信息。在执行批量操作时,如果某个地区的创建失败,它会记录错误并继续处理其他地区,最终一次性报告所有失败,方便用户统一排查。此技能适用于 macOS、Linux 等支持 asc 命令行工具的平台,是管理 App Store Connect 多语言本地化的理想助手。

兼容平台~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 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 技能。

Individual skills in this repo

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

相关技能