How to Publish a Capacitor or Ionic App on Google Play

1. Prepare the web build

Run your framework’s production build (for example npm run build) so the output folder Capacitor uses (webDir in capacitor.config) is fresh.

2. Sync and open

• npx cap sync android copies web assets and updates native plugins.
• npx cap open android opens Android Studio.

3. Set IDs and versions

• appId in capacitor.config must match applicationId in android/app/build.gradle. It’s permanent once uploaded.
• versionCode and versionName in android/app/build.gradle. Increase versionCode for every upload.
• Check android/variables.gradle for compileSdkVersion and targetSdkVersion. Target API 36 has been required since August 31, 2026. Upgrading Capacitor usually updates these.

4. Generate a signed bundle

In Android Studio choose Build → Generate Signed App Bundle / APK → Android App Bundle, create or select your keystore, choose the release variant, and build. The .aab lands in android/app/release/ (or the path Studio shows). Keep the keystore backed up.

5. Avoid “minimum functionality” problems

Google Play’s policies require apps to provide a stable, engaging experience. Apps that only load a website in a WebView are a classic rejection risk. Strengthen yours with:

• Native features: push notifications, offline support, camera, share sheet, biometrics.
• Content that works without a network, or a graceful offline screen.
• Native-feeling navigation (no browser chrome, proper back button handling).

6. Capacitor gotchas

After the bundle is built: same path for every app

1. Create the app in Play Console and complete the store listing and App content. See does a closed test need a store listing.
2. Upload the .aab to a closed testing track (internal first is optional). See upload your first AAB.
3. Attach a tester list and publish. Share the opt-in link.
4. On a new personal account: keep 12+ testers opted in for 14 days, then apply for production access.

Frequently asked questions