gpc-metadata-sync

元数据同步

当你需要更新商店页面、管理截图和图片，或从本地目录同步元数据时，请使用此技能。

商店页面

列出所有语言区域

gpc listings list --package com.example.app

获取指定语言区域

gpc listings get --locale en-US --package com.example.app

更新页面字段

gpc listings update --locale en-US \
  --title "My App" \
  --short-description "A short tagline" \
  --full-description "Full store description here" \
  --package com.example.app

从目录同步

gpc listings sync --dir ./metadata --package com.example.app

图片和截图

图片类型

phoneScreenshots、sevenInchScreenshots、tenInchScreenshots、tvScreenshots、wearScreenshots、featureGraphic、icon、tvBanner、promoGraphic

列出图片

gpc images list --locale en-US --type phoneScreenshots --package com.example.app

上传图片

gpc images upload --locale en-US --type phoneScreenshots --file screenshot1.png --package com.example.app
gpc images upload --locale en-US --type featureGraphic --file feature.png --package com.example.app
gpc images upload --locale en-US --type icon --file icon.png --package com.example.app

删除指定图片

gpc images delete --locale en-US --type phoneScreenshots --sha1 abc123 --package com.example.app

删除某一类型的所有图片

gpc images delete-all --locale en-US --type phoneScreenshots --package com.example.app

从目录同步图片

gpc images sync --dir ./screenshots --package com.example.app

多语言工作流

1. 导出现有页面：

gpc listings list --package com.example.app -o json > listings.json

2. 更新各语言区域：

gpc listings update --locale ja --title "マイアプリ" --package com.example.app
gpc listings update --locale de --title "Meine App" --package com.example.app

3. 上传特定语言区域的截图：

gpc images upload --locale ja --type phoneScreenshots --file ja_screenshot1.png --package com.example.app

Agent 行为

• 覆盖之前先显示当前页面（gpc listings get --locale <locale>）。
• 批量更新多个语言区域前，先与用户确认。
• 从目录同步时，若支持则使用 --dry-run。
• 上传前验证图片尺寸是否符合 Google Play 要求。

注意事项

• Google Play 要求每个语言区域至少有 2 张手机截图。
• Feature graphic 必须为 1024x500 像素。
• 图标必须为 512x512 像素。
• 对于兼容 Fastlane 的目录结构，请使用 gpc listings sync --dir。