用途:从 git log、要点或自由文本生成 App Store 的「新功能」(What's New)发布说明,可附带促销文本(promotional text),并支持多语言本地化。
主要能力:自动识别三种输入(git log、要点列表、自由描述);按 New/Improved/Fixed 分类改动并省略空分类;撰写以用户感受为中心、使用直接称呼的文案;优化前约 170 个可见字符的开头;从 metadata/version/{版本}/{语言}.json 的 keywords 字段回声关键词;限制主语言 500–1500 字符(上限 4000),本地化后仍不超过 4000;可选生成 170 字符促销文本;翻译使用正式语体(如俄语 вы、德语 Sie、法语 vous、西语 usted 等),避免直译成语;输出各语言字符数汇总表并等待确认后再上传。
使用方式:先通过 asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata" 拉取元数据,或手动提供关键词;配置认证(asc auth login 或 ASC_* 环境变量)。可从 git log 采集提交,例如: git describe --tags --abbrev=0 git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges 上传可直接逐语言更新: asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "en-US" --whats-new "Your release notes here" 或写入 ./metadata/version/<version>/<locale>.json 后批量推送: asc metadata push --app "APP_ID" --version "1.2.3" --dir "./metadata" --dry-run asc metadata push --app "APP_ID" --version "1.2.3" --dir "./metadata" 促销文本可加 --promotional-text,或在推送前写入 JSON 的 promotionalText。
适用场景:需要为 App Store 更新撰写更新说明、跨多语言本地化并统一上传的开发者。What's New 不参与搜索索引,应面向人撰写;促销文本是唯一无需重新提交即可更新的字段。使用前需安装并配置 asc CLI,确切的命令语法可运行 asc --help 核对。资料未提供价格、平台限制等更多信息。