SuperAPI AI 工具集

gpc-metadata-sync

部署与运维

查看项目

更新于 10-16 02:28

技能介绍

用途:管理 Google Play 商店列表(标题、简短描述、完整描述)、在本地文件与 Play Console 之间同步元数据,以及管理截图和其他图片。

主要能力:

  • 查看列表:gpc listings get(可加 --lang,省略则全部语言,--output json 输出 JSON)。
  • 更新列表:gpc listings update --lang en-US --title ... --short ... --full ...,或 --full-file 从文件读取完整描述。
  • 本地校验:gpc listings lint,检查字符上限(标题 30、简短描述 80、完整描述 4000、视频 URL 256),超限返回退出码 1,可用于提交前门禁。
  • 线上校验:gpc listings analyze,可加 --expected 检查缺失语言,--json 输出。
  • 双向同步:gpc listings pull --dir metadata/ 与 push --dir metadata/;支持 --dry-run、--changes-not-sent-for-review、--error-if-in-review、--force;push 前会自动跑 lint,超限则中止。
  • Fastlane 兼容:可直接读写 Fastlane 元数据目录,如 gpc listings push --dir fastlane/metadata/android/。
  • 图片管理:images list/upload/delete,类型含 phoneScreenshots、icon、featureGraphic 等;推荐 images sync --dir(SHA-256 去重,整轮仅一次提交、节省配额),可配 --delete 保持顺序,absent 目录不动、不可读目录报 IMAGE_SYNC_DIR_UNREADABLE;v0.9.96+ 支持 --ai-generated 声明 AI 生成图片,--dry-run 预览。

使用方式:命令式调用,需包名(或用 GPC_APP 默认)、语言代码、本地目录路径、图片类型与文件路径。

限制与注意事项:需要授予 Google Play 权限并完成认证;语言需先在 Console 创建,否则报 LISTING_NOT_FOUND;存在每日保存配额,循环单图上传/删除会快速耗尽,应优先用 sync;本地文本需 UTF-8;截图顺序依赖文件名排序;dry-run 不发起 API 调用。

相关技能:gpc-setup、gpc-release-flow、gpc-ci-integration;发布说明生成见 gpc changelog generate。