用途:通过 GPC 管理 Google Play Games Services 的成就与排行榜配置,调用 Games Configuration API(gamesconfiguration v1configuration)。这是发布方侧的配置管理(成就/排行榜目录),不是玩家运行时解锁逻辑。不适用于应用发布、轨道或 AAB 上传(见 gpc-release-flow),也不适用于应用内购买与订阅(见 gpc-monetization)。
前提:需要已认证的 GPC 环境(gpc-setup),使用与发布相同的服务账号或 OAuth;需要数字游戏应用 ID(Play Games 的 Application ID,不同于 Android 包名)。创建/更新需提供 JSON 配置文件。
用法:先运行 gpc doctor 确认认证。游戏 ID 可通过 --game-id 参数、GPC_GAME_ID 环境变量或 .gpcrc.json 中 games.applicationId 设置,优先级依次降低。成就命令包括 list、get、create、update、delete;排行榜命令类似。所有写操作支持 --dry-run。diff 可逐字段比较本地 JSON 与远端配置,用于同步前检查漂移。push/pull 可批量同步整个目录(v0.9.90+)。set-icon 上传 512x512 PNG 或 JPG 图标。runtime 命令为只读,按应用包名读取已发布游戏的玩家侧定义。
限制:set-icon 依赖 Google 已下线的端点,若被关闭会返回 API_ENDPOINT_RETIRED,此时需在 Play Console 设置图标;其余命令不受影响。gpc games events 已在 v0.9.86 移除,事件仅能在 Play Console 配置。运行时命令已移至 gpc games runtime。权限错误需服务账号拥有 Play Games Services 中该游戏的访问权。