名称: asc-metadata-sync 描述: 使用asc同步和验证App Store的元数据和本地化，包括旧版元数据格式迁移。在更新元数据或翻译时使用。
asc元数据同步
使用此技能来保持本地元数据与App Store Connect同步。
两种类型的本地化
1. 版本本地化（每个发布版本）
字段：description, keywords, whatsNew, supportUrl, marketingUrl, promotionalText
# 列出版本本地化
asc localizations list --version "VERSION_ID"
# 下载
asc localizations download --version "VERSION_ID" --path "./localizations"
# 从.strings文件上传
asc localizations upload --version "VERSION_ID" --path "./localizations"
2. 应用信息本地化（应用级别）
字段：name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText
# 首先，找到应用信息ID
asc app-infos list --app "APP_ID"
# 列出应用信息本地化
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID"
# 上传应用信息本地化
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"
注意： 如果出现"多个应用信息找到"，你必须指定正确的ID使用--app-info。
旧版元数据格式工作流
导出当前状态
asc migrate export --app "APP_ID" --output "./metadata"
验证本地文件
# 使用--help来发现针对你的元数据目录的标志
asc migrate validate --help
这会检查字符限制和必填字段。
导入更新
# 使用--help来发现针对你的元数据目录的标志
asc migrate import --help
快速字段更新
版本特定字段
# 更新内容
asc app-info set --app "APP_ID" --locale "en-US" --whats-new "Bug fixes and improvements"
# 描述
asc app-info set --app "APP_ID" --locale "en-US" --description "Your app description here"
# 关键词
asc app-info set --app "APP_ID" --locale "en-US" --keywords "keyword1,keyword2,keyword3"
# 支持URL
asc app-info set --app "APP_ID" --locale "en-US" --support-url "https://support.example.com"
版本元数据
# 版权
asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company"
# 发布类型
asc versions update --version-id "VERSION_ID" --release-type AFTER_APPROVAL
TestFlight笔记
asc build-localizations create --build "BUILD_ID" --locale "en-US" --whats-new "TestFlight notes here"
.strings文件格式
对于批量更新，使用.strings文件：
// en-US.strings
"description" = "Your app description";
"keywords" = "keyword1,keyword2,keyword3";
"whatsNew" = "What's new in this version";
"supportUrl" = "https://support.example.com";
对于应用信息类型：
// en-US.strings（应用信息类型）
"privacyPolicyUrl" = "https://example.com/privacy";
"name" = "Your App Name";
"subtitle" = "Your subtitle";
多语言工作流
- 导出所有本地化：
asc localizations download --version "VERSION_ID" --path "./localizations"
-
翻译.strings文件（或使用翻译服务）
-
一次性上传所有：
asc localizations upload --version "VERSION_ID" --path "./localizations"
- 验证：
asc localizations list --version "VERSION_ID" --output table
字符限制
| 字段 | 限制 |
|---|---|
| 名称 | 30 |
| 副标题 | 30 |
| 关键词 | 100（逗号分隔） |
| 描述 | 4000 |
| 更新内容 | 4000 |
| 推广文本 | 170 |
在上传前使用asc migrate validate检查限制。
注意事项
- 版本本地化和应用信息本地化是不同的；使用正确的命令和
--type标志。 asc migrate validate在上传前强制执行字符限制。- 使用
asc localizations list来确认可用的区域设置和ID。 - 隐私政策URL在应用信息本地化中，不在版本本地化中。