Understand Android app bundles and signing keys

Prepare your first Android bundle, understand which signing key does what, and know what to check if Play rejects it.

By The Draftbit team · Updated
Sources checked

This guide is for New Google Play apps using Android App Bundles and existing apps enrolled in Play App Signing.

You’re ready to upload your Android app, and Play is asking for a signed bundle. For a new app, that’s an Android App Bundle, usually an .aab file. There are two keys to keep track of: you sign the upload with your upload key, and Google signs the APKs people install with your app-signing key.

Set up the app’s identity

Choose the permanent package name and confirm which developer account will publish the app. Keep the signing files and recovery details somewhere secure that the app’s owner can access. If you plan to use several stores, decide whether they need the same signing identity before you set it up.

  1. Create the app record in Play Console and start a release in the testing track you intend to use.
  2. Set up Play App Signing. Google offers several ways to configure the keys; use the one that works with your build service and distribution plans.
  3. Sign the bundle with the app’s upload key. Google checks that signature before signing the APKs it delivers to users.
  4. Upload the bundle. Check its package name and version, then fix any blocking errors.

Google needs to accept the bundle into the right app and testing release before you continue. For later builds, keep the same app identity and use a valid version code you haven’t used before.

If Play rejects the signing key

Compare the certificate Play expects with your upload certificate. If you’ve lost the upload key, Play App Signing may let you reset it without creating a new app. Losing a self-managed app-signing key is a different problem.

Keep keystores and passwords out of public support posts.

Messages this guide can help with

AAB vs APK; upload key lost; Play App Signing; keystore; first Android upload

Official sources

We checked these instructions against the sources below. The console layout may change, and your review decision may call for different steps.

Your next stepChoose a Google Play testing track