gpc-release-flow

发布流程

在需要上传构建版本、发布到轨道、在轨道之间提升版本或管理分阶段发布时，使用此技能。

前提条件

• 已配置身份验证（gpc doctor 通过）。
• 每次上传都使用新的版本代码。
• 始终显式传递 --package。

上传和发布

将 AAB 上传到轨道

gpc bundles upload --file app.aab --track internal --package com.example.app

上传并附带版本说明和提交

gpc bundles upload --file app.aab --track beta \
  --release-notes "Bug fixes and improvements" \
  --release-notes-lang en-US \
  --commit \
  --package com.example.app

上传并进行分阶段发布

gpc bundles upload --file app.aab --track production \
  --rollout 0.1 \
  --package com.example.app

轨道管理

列出轨道

gpc tracks list --package com.example.app

获取轨道详情

gpc tracks get --track production --package com.example.app

更新轨道发布

gpc tracks update --track production \
  --version-code 42 \
  --status completed \
  --rollout-percentage 1.0 \
  --package com.example.app

在轨道之间提升版本

gpc tracks promote --from internal --to beta --package com.example.app
gpc tracks promote --from beta --to production \
  --rollout-percentage 0.05 \
  --package com.example.app

分阶段发布

逐步提高比例

gpc tracks update --track production --rollout-percentage 0.05 --package com.example.app
gpc tracks update --track production --rollout-percentage 0.20 --package com.example.app
gpc tracks update --track production --rollout-percentage 0.50 --package com.example.app

完成发布（100%）

gpc tracks complete --track production --package com.example.app

暂停发布

gpc tracks halt --track production --package com.example.app

手动编辑生命周期

在需要精确控制或在一次提交中进行多项更改时使用：

# 1. Create edit session
gpc edits create --package com.example.app

# 2. Make changes (upload, update tracks, etc.)
gpc bundles upload --file app.aab --package com.example.app

# 3. Validate before committing
gpc edits validate --edit-id $EDIT_ID --package com.example.app

# 4. Commit all changes atomically
gpc edits commit --edit-id $EDIT_ID --package com.example.app

等待 Bundle 处理

gpc bundles wait --version-code 42 --timeout 600 --interval 30 --package com.example.app

Agent 行为

• 上传前始终确认目标轨道。
• 对于生产环境发布，可用时使用 --dry-run。
• 在更改前后显示 gpc tracks get --track <track> 的输出。
• 对于生产环境，优先从 5% 开始分阶段发布，而非全面发布。

说明

• 使用 gpc tracks list 发现可用轨道（internal、alpha、beta、production、custom）。
• 版本说明支持使用 --release-notes-lang 指定特定区域设置。
• 上传时使用 --commit 会自动提交此次编辑；手动编辑生命周期中则省略此选项。