Play Developer Console 是一个用于管理 Google Play 开发者控制台内容的本地命令行工具技能。它基于 Bun TypeScript CLI,通过本地链接的 play 命令暴露功能,可执行 play --help 查看帮助。
用途 该技能适用于管理 Google Play 开发者控制台的元数据、图形素材、发布轨道(tracks)、应用包(app bundles)、评论、订阅以及应用内商品。
主要能力 CLI 提供以下命令类别:元数据(metadata)、应用信息(app-info)、图片(images)、应用包(bundle)、发布轨道(tracks)和评论(reviews)。支持元数据校验、列表查看、应用信息展示、轨道列表与详情查看、评论列表等只读检查,以及发布轨道的创建与更新。
使用方式
对于 Moshi Android 项目,需在 /Users/jyo/projects/ai/moshi/marketing 目录下运行命令。Play 相关资源位于 play/ 目录,包含 .env、metadata/、images/、release-notes/。
工作流程要求:在更改商店素材前,先检查 play/CLAUDE.md 和相关本地文件;一次只运行一个 Play 编辑类命令,不要并行执行 play metadata、play app-info、play images、play bundle 或 play tracks 命令;上传前使用 play metadata validate 校验本地列表文本;更改前后使用只读检查命令,如 play metadata list、play app-info show、play tracks list --json、play tracks show production --json、play reviews list --limit 5。
发布工作流使用内置轨道命令,不要为常规发布任务编写针对 src/api.ts 的临时脚本。示例:附加或更新已上传到 Play 的发布,使用 play tracks release internal --version-code 6 --status completed --name "Moshi 2.8.2" --notes en-US=play/release-notes/en-US.txt;准备带发布说明的生产草稿,使用 play tracks release production --version-code 6 --status draft --name "Moshi 2.8.2" --notes en-US=play/release-notes/en-US.txt。如果草稿应用存在阻止校验的过期发布,先清除轨道再创建目标发布:play tracks clear internal,然后 play tracks release internal --version-code 6 --status draft --name "Moshi 2.8.2"。未提供 --notes 标志时,play tracks release 会读取 play/release-notes/ 中的所有文件作为本地化发布说明;仅在有意省略说明时使用 --no-notes。
对于 bug 或缺失的 Play API 行为,修补 /Users/jyo/projects/tools/play-cli,然后运行 cd /Users/jyo/projects/tools/play-cli、bun run typecheck、bun test,修复后从 /Users/jyo/projects/ai/moshi/marketing 重试。
认证
Moshi 使用通过 gcloud ADC 的无密钥本地认证,配额项目在 play/.env 中配置。除非用户明确要求,不要创建或要求服务账号 JSON 密钥。预期环境变量键:PLAY_AUTH_MODE=gcloud、PLAY_QUOTA_PROJECT=play-cli-moshi-260429103059、PLAY_PACKAGE_NAME=app.getmoshi.android。
适用场景 适用于需要以命令行方式管理 Google Play 商店元数据、素材、发布轨道、评论、订阅和应用内商品的场景,尤其是 Moshi Android 项目的发布流程。
限制 该技能依赖本地路径和特定项目结构;一次只能运行一个编辑类命令,不可并行;认证方式为 gcloud ADC,不默认使用服务账号密钥。