Publish to Google Play Store

Publish an update to Google Play Store, including the Alpha and Beta tracks from App Center.

Prerequisites

  • Google requires the first version of your Google Play application to be published to production through the Google console.
  • A Google Play Developer account. If you do not have one, you can sign up at the Google developer account portal.
  • Ensure that you have an API project and a Service account for App Center to create a Google Store connection and to access Google APIs on your behalf.
  • Review prerequisites for Beta and Alpha for more information on these tracks.
  • Set up App signing by Google to publish Android App bundles (AAB) files.

For more information, review How to use the Google Play console.

Linking your API Project

To access the Google API, you must link your Google Play Console to a Google API project. In most cases, we recommend that you create a new API project, although current API users can link to an existing API project. Keep in mind that each API project can only be linked to a single Google Play Console account.

Creating a new API project

  • Go to the Google API Access page on the Google Play Console.
  • Accept the Terms of Service.
  • Click on Create new project.
  • An API project is automatically generated and linked to your Google Play Console.

Using an existing API project

  • If you are already a user of the Google Play Developer API, you can link to your existing API project by following these steps. If the API project to link to is not listed, verify that your Google Play Console account is designated as an Owner, and the Google Play Developer API is enabled.
  • Go to the Google API Access page on the Google Play Console.
  • Accept the API Terms of Service.
  • Choose the project you would like to link.
  • Click on Link.

Setting Up API Access Clients

One of the added benefits of creating a Google service account is access to the API from a build server without providing your personal user credentials, below is a step-by-step guide on how to set up Google service account:

Go to the Google API Access page on the Google Play Console.

Google Play: configuring API access

Under Service Accounts, click the Create Service Account button to begin the process.

Google Play: Create a service account button highlighted

In the instructions, click the link to the Google API Console.

Google Play: Create Service Account instructions

Click the CREATE SERVICE ACCOUNT button, on the newly opened page.

Google Play: Service Accounts

The Create service account page opens.

Google Play: Create Service Account Dialog

Choose a name for the new Service Account, and click Create.

Google Play: Choose Project -> Owner as role

Click the Select a role in the drop-down menu. Select Project, then Owner. Navigate to the next step by clicking Continue.

On the new page click + Create Key (optional) and a modal appears.

Google Play: Click + Create Key to generate a JSON file

Select JSON and click CREATE and a file with the .json extension will download to your system; this file will be used in App Center to establish the connection to Google Play.

Google Play: Set key type as JSON

Once you've created the service account on the Google Developers Console, click Done. The API Access page automatically refreshes, and your service account will be listed.

Google Play: Service Account Created

Close the window and the new service account shows on the original page. Click the Grant Access button to complete the process. In the next section, you will learn how to connect App Center with Google Play.

Google Play: Original screen with new service account

Set up app signing by Google

  1. Select your app in the Google Play Developer Console
  2. Expand Release management in the left-hand menu
  3. Select App signing
  4. You can choose between three options:
    1. Upload a key exported from Android Studio
    2. Export and upload a key from a Java keystore
    3. Export and upload a key (not using a Java keystore)

Google Play: Set up app signing

  1. Click finish

Create a Google Play connection in App Center

  1. Click on Stores under Distribution in the left menu.
  2. In the middle of the page, click on the Connect to Store button.
  3. Select Google Play store.
  4. Click on Next.
  5. Upload the private key JSON file, which you downloaded while creating the service account. If the JSON fields are edited to incorrect values, the store creation might fail. Make sure you have the service account linked to your Google Play Developer console as per the prerequisite section above.
  6. Once the file is uploaded, click Connect.
  7. A Google Play connection should now be visible with the three tracks, Production, Alpha, and Beta in the Stores home page. Setting up this connection is a one time process for an app in App Center.

Publish your AAB to the Google Play Store

  1. From the Stores home page, select any of the tracks created above.
  2. Click on Publish to Store on the button in the upper-right corner.
  3. Upload the app package. A few points to note:
    • Application must be prepared for release and signed with a valid key store before uploading.
    • Google Play Store supports android app bundles up to a maximum of 2 GB. Apks generated from the aab cannot exceed 150 MB. You can read more about your options at Google's docs for AAB.
    • The version of the .aab must be strictly greater than the current version in production.
    • If you have app versions in other tracks like Alpha and Beta, your release version should be strictly less than versions in Alpha and Beta track versions.
    • App Center currently does not support promoting an app from one track to another. You cannot promote a version from alpha to beta or beta to production.
  4. After uploading your package, you can see some details of the application. Click Next.
  5. Click on Publish to push the app to the Google Play Store. The status for this release on the Distribute Store Details page will show as Submitted.
  6. Once App Center has completed the handover of the app to Google, the status of the app will change to Published. Google could take up to 24 hours to show the app in the Play store.
  7. In case publishing by Google fails, the app owner receives a notification to the registered Google mail.

Publish your APK to the Google Play Store

  1. From the Stores home page, select any of the tracks created above.
  2. Click on Publish to Store on the button in the upper-right corner.
  3. Upload the app package. A few points to note:
    • Application must be prepared for release and signed with a valid key store before uploading.
    • Google Play Store supports application packages up to a maximum of 100 MB. If the application exceeds 100 MB, use the Expansion files to support the application package by uploading those directly in the Google Play Developer Console as we currently don't support Expansion files in App Center. Review Expansion files.
    • The .apk must be zipaligned during the app-building process.
    • The version of the .apk must be strictly greater than the current version in production.
    • If you have app versions in other tracks like Alpha and Beta, your release version should be strictly less than versions in alpha and Beta track versions.
    • App Center currently does not support promoting an app from one track to another. You cannot promote a version from alpha to beta or beta to production.
  4. After uploading your package, you can see some details of the application. Click Next.
  5. Click on Publish to push the app to the Google Play Store. The status for this release on the Distribution Store Details page will show as Submitted.
  6. Once App Center has completed the handover of the app to Google, the status of the app will change to Published. Google could take up to 24 hours to show the app in the Play store.
  7. In case publishing by Google fails, the app owner receives a notification to the registered Google mail.