用途:当需要管理多个 Google Play 应用时使用该技能,例如组合应用、白标、变体或包含多个 Android 模块的 Monorepo。
主要能力:GPC 目标应用的解析顺序为 --app 命令行参数(最高优先级)、GPC_APP 环境变量、项目目录中的 .gpcrc.json、用户配置 ~/.config/gpc/config.json,以及活动 profile 覆盖。可用 gpc status --all-apps 一次检查所有已配置应用的健康状态。
按应用配置:为每个应用创建 profile(需 GPC v0.9.95+,旧版本会静默忽略 --profile): gpc auth login --service-account /keys/main-sa.json --profile main 随后在 ~/.config/gpc/config.json 中为每个 profile 添加 app 等设置。按命令使用 profile:gpc releases list --profile main,或通过 export GPC_PROFILE=enterprise 设置。Monorepo 可在各应用目录放置 .gpcrc.json,GPC 会从当前目录向上查找。
批量操作:可用 shell 脚本对多个应用循环执行相同命令,例如 gpc releases upload "build/$app/app-release.aab" --track internal --app "$app";也可批量检查崩溃率:gpc vitals crashes --threshold "$THRESHOLD" --app "$app"。CI/CD 方面可用 GitHub Actions matrix 策略按应用独立部署,使用 GPC_APP 指定包名。
不同服务账号:当应用属于不同开发者账号时,可对每条命令使用不同的 GPC_SERVICE_ACCOUNT,或通过 profiles 为各应用配置不同 serviceAccount。批量元数据同步可循环执行 gpc listings push --dir "$dir" --app "$app" --dry-run。
验证与限制:可用 gpc config list --profile <name> 确认各 profile 的 app 与认证;批量脚本应正确处理错误并返回非零退出码。常见问题包括未设置 --app 导致目标错误、服务账号缺少某应用权限(API_FORBIDDEN)、profile 名称拼写错误、.gpcrc.json 未生效等。需要已认证的 GPC(gpc auth status 显示有效凭据)、各应用的包名以及可能按应用或开发者账号不同的服务账号密钥。其他收费、价格、平台细节暂未提供。