gplay-gradle-build

Build, sign, and package Android apps as AAB or APK with Gradle for Google Play.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/lettucebo/Skills --skill gplay-gradle-build-lettucebo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gplay-gradle-build
Source: https://github.com/lettucebo/Skills/tree/main/skills/google-play-console-cli/gplay-gradle-build
Command: npx skills add https://github.com/lettucebo/Skills --skill gplay-gradle-build-lettucebo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Preparing an Android app for Google Play requires correctly configuring Gradle builds, signing credentials, version codes, and ProGuard mapping files, and mistakes in any of these steps cause failed uploads or broken releases. ## Core Features & Use Cases - Release Builds: Generate signed AAB (recommended) or APK artifacts with ./gradlew bundleRelease or assembleRelease. - Signing & Versioning: Configure keystore credentials via environment variables and manage versionCode/versionName through gradle.properties. - CI/CD Integration: Build and upload releases in GitHub Actions, including ProGuard mapping file upload for crash symbolication. - Use Case: You need to ship a new release to the Play internal track. Use this Skill to increment the version code, build a signed AAB, and upload it with the gplay CLI in one workflow. ## Quick Start Build a signed release App Bundle for my Android project and increment the version code before uploading it to Google Play.

Frequently Asked Questions about gplay-gradle-build

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a signed AAB for Google Play with Gradle?▼

Run ./gradlew bundleRelease after configuring a release signingConfig in your app-level build.gradle. Provide the keystore path and passwords through environment variables such as KEYSTORE_FILE, KEYSTORE_PASSWORD, KEY_ALIAS, and KEY_PASSWORD.

Should I upload an AAB or APK to Google Play?▼

Use an Android App Bundle (AAB), since Google Play requires bundles for new apps. Build it with ./gradlew bundleRelease; APKs via assembleRelease are only for legacy distribution scenarios.

How do I increment the Android versionCode automatically?▼

Store VERSION_CODE in gradle.properties and reference it in defaultConfig. Increment it with a shell script that reads the current value with grep, adds one, and updates the file with sed before running the release build.

Why does my Gradle release build fail with signing errors?▼

Signing failures usually come from a missing keystore file or incorrect credentials in environment variables. Verify the keystore with keytool -list -v -keystore release.keystore and confirm all four signing variables are exported.

How do I upload the ProGuard mapping file to Play Console?▼

After a release build, the mapping file is at app/build/outputs/mapping/release/mapping.txt. Upload it with the gplay deobfuscation upload command, specifying the package name, edit ID, APK version code, and file path.