Skip to content

gplay release

Create a complete release: create edit, upload bundle/apk, configure track, commit.

gplay release --package <name> --track <track> --bundle <path> [--release-notes <json>] [--rollout <fraction>] [--wait]

The release command is a high-level workflow that combines:

  1. Create a new edit
  2. Upload app bundle or APK
  3. Update store listings (if –listings-dir is provided)
  4. Upload screenshots (if –screenshots-dir is provided)
  5. Configure track with release notes and rollout
  6. Validate and commit the edit

This replaces the manual workflow of: gplay edits create gplay bundles upload gplay listings update gplay images upload gplay tracks update gplay edits commit

Example: gplay release –package com.example.app –track production –bundle app.aab –release-notes @notes.json –rollout 0.1 gplay release –package com.example.app –track internal –bundle app.aab –listings-dir ./metadata –screenshots-dir ./screenshots

Flag Description Default
--apk Path to .apk file (use –bundle or –apk, not both) ``
--bundle Path to .aab bundle file ``
--changes-not-sent-for-review Changes not sent for review false
--listings-dir Path to listings metadata directory (locale/title.txt, short_description.txt, etc.) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--poll-interval Polling interval when waiting 10s
--pretty Pretty-print JSON output false
--release-notes Release notes: plain text (en-US), JSON array, or @file path ``
--rollout Staged rollout fraction (0.0-1.0, default: 1.0 for full rollout) 1
--screenshots-dir Path to screenshots directory (locale/deviceType/files) ``
--skip-metadata Skip listings metadata update even if –listings-dir is set false
--skip-screenshots Skip screenshot uploads even if –screenshots-dir is set false
--status Release status: draft, inProgress, halted, completed completed
--track Target track (production, beta, alpha, internal) internal
--version-name Version name (optional, defaults to versionName from bundle/apk) ``
--wait Wait for processing to complete false