Back to Details

gpd-release-flow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Release flow (Google Play)

Google Play 发布工作流

Use this skill when you need to upload a build, publish to a track, or manage rollout.
当你需要上传构建版本、发布至指定渠道或管理分阶段发布时，可使用此Skill。

Preconditions

前置条件

  • Ensure credentials are set (
    GPD_SERVICE_ACCOUNT_KEY
    ).
  • Use a new version code for each upload.
  • Always pass 
    --package
    explicitly.
  • 确保已配置凭证（
    GPD_SERVICE_ACCOUNT_KEY
    ）。
  • 每次上传需使用新的版本号。
  • 请始终显式传入
    --package
    参数。

Preferred end-to-end commands

推荐的端到端命令

Upload and release to a track

上传并发布至指定渠道

bash
gpd publish upload app.aab --package com.example.app
gpd publish release --package com.example.app --track internal --status completed
bash
gpd publish upload app.aab --package com.example.app
gpd publish release --package com.example.app --track internal --status completed

Promote between tracks

在渠道间推广版本

bash
gpd publish promote --package com.example.app --from-track beta --to-track production
bash
gpd publish promote --package com.example.app --from-track beta --to-track production

Manual sequence with edit lifecycle

使用编辑生命周期的手动操作流程

Use when you need precise control or multiple changes in one commit.
bash
undefined
当你需要精确控制或在一次提交中完成多项更改时使用此流程。
bash
undefined

1. Create edit

1. 创建编辑会话

EDIT_ID=$(gpd publish edit create --package com.example.app | jq -r '.data.editId')
EDIT_ID=$(gpd publish edit create --package com.example.app | jq -r '.data.editId')

2. Upload build without auto-commit

2. 上传构建版本且不自动提交

gpd publish upload app.aab --package com.example.app --edit-id $EDIT_ID --no-auto-commit
gpd publish upload app.aab --package com.example.app --edit-id $EDIT_ID --no-auto-commit

3. Configure release

3. 配置发布

gpd publish release --package com.example.app --track internal --status draft --edit-id $EDIT_ID
gpd publish release --package com.example.app --track internal --status draft --edit-id $EDIT_ID

4. Validate and commit

4. 验证并提交

gpd publish edit validate $EDIT_ID --package com.example.app gpd publish edit commit $EDIT_ID --package com.example.app
undefined
gpd publish edit validate $EDIT_ID --package com.example.app gpd publish edit commit $EDIT_ID --package com.example.app
undefined

Staged rollout

分阶段发布

bash
gpd publish release --package com.example.app --track production --status inProgress --version-code 123
gpd publish rollout --package com.example.app --track production --percentage 5
gpd publish rollout --package com.example.app --track production --percentage 50
gpd publish rollout --package com.example.app --track production --percentage 100
bash
gpd publish release --package com.example.app --track production --status inProgress --version-code 123
gpd publish rollout --package com.example.app --track production --percentage 5
gpd publish rollout --package com.example.app --track production --percentage 50
gpd publish rollout --package com.example.app --track production --percentage 100

Halt or rollback

暂停或回滚发布

bash
gpd publish halt --package com.example.app --track production --confirm
gpd publish rollback --package com.example.app --track production --confirm
bash
gpd publish halt --package com.example.app --track production --confirm
gpd publish rollback --package com.example.app --track production --confirm

Track status

渠道状态查询

bash
gpd publish status --package com.example.app --track production
gpd publish tracks --package com.example.app
bash
gpd publish status --package com.example.app --track production
gpd publish tracks --package com.example.app

Notes

注意事项

  • Use 
    --status draft
    first for risky releases.
  • Use 
    --confirm
    only after reviewing 
    gpd publish status
    output.
  • 对于风险较高的发布，先使用
    --status draft
    状态。
  • 仅在查看
    gpd publish status
    输出结果后，再使用
    --confirm
    参数。