rudrankriyam

gpd-submission-health

Preflight Google Play releases, validate edits, and verify listing completeness with gpd. Use when shipping to production or troubleshooting a failed release.

rudrankriyam 982 57 Updated 6mo ago
GitHub

Install

npx skillscat add rudrankriyam/app-store-connect-cli-skills/gpd-submission-health

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no superlatives, no calls to action. No bullet points, no headings, no markdown formatting. At most 60 words. Must be plain text, no quotes. Provide only the summary text. We need to explain: what the skill does (preflight Google Play releases, validate edits, verify listing completeness with gpd), what problem it solves (reduce submission failures, validate readiness), when to use it (when shipping to production or troubleshooting a failed release).

SKILL.md

GPD Submission Health

Use this skill to reduce Play Console submission failures and validate readiness.

Preconditions

  • Auth configured and package name resolved.
  • Build uploaded and available for the target track.
  • Store listing metadata and assets updated.

Pre-submission checklist

1. Validate edit (if using edit lifecycle)

gpd publish edit validate EDIT_ID --package com.example.app

2. Confirm release status

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

Check:

  • Release status is expected (draft, inProgress, or completed).
  • Version code matches the uploaded build.

3. Verify store listing metadata

gpd publish listing get --package com.example.app
gpd publish details get --package com.example.app

4. Verify screenshots and assets

gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish assets spec

5. Upload deobfuscation mapping (if needed)

gpd publish deobfuscation upload mapping.txt --package com.example.app --type proguard --version-code 123

Submit to production

gpd publish release --package com.example.app --track production --status inProgress --version-code 123

Common submission issues

Release not in valid state

Check:

  1. Version code uploaded and attached to the track.
  2. Edit validation passes.
  3. Required store listing fields present for all locales.

Missing screenshots or assets

Use:

gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish images upload icon icon.png --package com.example.app --locale en-US

Policy declarations not complete

Some policy/compliance items must be completed in Play Console UI. Confirm in the console if CLI operations pass but submission is blocked.

Notes

  • Use gpd publish edit validate before committing large changes.
  • Use --dry-run where available before destructive actions.