用途:把本地元数据文件与 App Store Connect 保持同步,覆盖应用级字段与版本级本地化字段,并提供关键词、App Clip、预览素材及旧版 fastlane 元数据的处理工作流。
主要能力:用规范的 asc metadata 工作流处理 app-info 与版本本地化字段,包括拉取、校验、预览与应用;支持仅改关键词的 diff/apply 与 CSV 导入同步;可用 review 制品(plan/approve/status/apply --confirm)在写入前显式审批;通过 --include localizations,app-clip,previews 选择资源范围;支持 .strings 本地化与 legacy fastlane 格式的导入导出。
必要用法:先执行 asc metadata pull --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata" 拉取,编辑本地文件后运行 asc metadata validate --dir "./metadata" --output table,写入前用 --dry-run 预览,确认后执行 asc metadata push(或等价的 asc metadata apply)。字段上限:Name 30、Subtitle 30、Keywords 100(逗号分隔)、Description 4000、What's New 4000、Promotional Text 170。快速编辑须显式指定 --version-id 或 --version 加 --platform,避免依赖不明确的“最新版本”。
限制与注意:预览校验需要 ffprobe;App Clip 头图替换会先删除旧头图,需要 --allow-deletes 明确授权。导出可能只含 HLS .m3u8 播放列表与 .preview.json 引用而非原始视频,重命名为 .mp4 不可上传。fastlane 目录外的路径默认失败,除非用 --allow-external-metadata 或 --allow-external-screenshots 显式信任,不可信导入应关闭这些开关。校验可能返回 valid: false 且 errorCount 非零但退出码为 0;导入也可能输出 partial 并以非零退出,不能仅凭 stdout 判断成功。Copyright 不属于本地化字段,需用 asc versions update 管理。其余未提及的收费、平台与效果信息暂未提供。