SuperAPI AI 工具集

asc-metadata-sync

数据与分析

查看项目

更新于 10-15 23:34

技能介绍

用途:让 App Store 元数据与 App Store Connect 保持同步。优先使用 asc 规范元数据工作流处理 app-info 与版本本地化字段;仅当用户明确需要 .strings 文件或旧版 fastlane 格式元数据时,才使用 asc localizations 与 asc migrate 等底层命令。

主要能力:拉取规范元数据、编辑本地文件、上传前校验、预览与应用变更,并支持关键词专用流程、快速字段更新、底层本地化文件与旧版 fastlane 元数据迁移。

使用方式:先执行 asc metadata pull --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata";若存在多个 app-info 记录,先用 asc apps info list 解析 app-info ID 并显式传入。规范文件位于 metadata/app-info/<locale>.json(name、subtitle、privacyPolicyUrl 等)与 metadata/version/<version>/<locale>.json(description、keywords、whatsNew 等)。版权不是本地化字段,用 asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company" 管理。上传前运行 asc metadata validate --dir "./metadata" --output table,订阅类应用加 --subscription-app。先 dry-run 预览,再执行 asc metadata push 或 asc metadata apply。需要审批工件时使用 asc metadata plan/approve/status/apply 系列命令。关键词流程使用 asc metadata keywords diff/apply/import/sync。快速编辑使用 asc apps info edit,并显式传 --version-id 或 --version 加 --platform。

适用场景:更新元数据、本地化、关键词,或迁移 fastlane 元数据。

限制:字符上限为 Name 30、Subtitle 30、Keywords 100 个逗号分隔字符、Description 4000、What's New 4000、Promotional Text 170。Deliverfile 的 metadata_path 与 screenshots_path 优先且相对 Deliverfile 解析;外部路径需 --allow-external-metadata 或 --allow-external-screenshots,不可信导入应保持关闭。asc migrate validate 可能返回 valid: false 且 errorCount 非零但退出码为 0;确认导入可能输出 status: "partial" 且退出码非零,非空 stdout 不代表成功。其他细节暂未提供。