| name | gpd-release-flow |
| description | End-to-end release workflows for Google Play using gpd publish commands, tracks, rollouts, and edit lifecycle. Use when uploading builds or managing releases. |
Release flow (Google Play)
Use this skill when you need to upload a build, publish to a track, or manage rollout.
Preconditions
- Ensure credentials are set (
GPD_SERVICE_ACCOUNT_KEY).
- Use a new version code for each upload.
- Always pass
--package explicitly.
Preferred end-to-end commands
Upload and release to a track
gpd publish upload app.aab --package com.example.app
gpd publish release --package com.example.app --track internal --status completed
Promote between tracks
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.
EDIT_ID=$(gpd publish edit create --package com.example.app | jq -r '.data.editId')
gpd publish upload app.aab --package com.example.app --edit-id $EDIT_ID --no-auto-commit
gpd publish release --package com.example.app --track internal --status draft --edit-id $EDIT_ID
gpd publish edit validate $EDIT_ID --package com.example.app
gpd publish edit commit $EDIT_ID --package com.example.app
Staged rollout
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
gpd publish halt --package com.example.app --track production --confirm
gpd publish rollback --package com.example.app --track production --confirm
Track status
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.