Skip to main content

Android Keystores

You need to sign your Android applications with a keystore in order to install and test your application on virtual or real devices and submit your application to Google Play store.

Android keystores can be generated in Appcircle or pre-obtained keystores can be uploaded to use for signing Android applications. If you want to generate keystore in your machine, you can use KeyStore Explorer.

1. Generate Android Keystores

You can create a keystore just by entering the necessary information. No additional software is needed.

2. Upload Android Keystore File

Upload your readily available keystore file along with the password(s).

info

Only files with .keystore extension can be uploaded.

Builds with debug type will be signed with a default keystore and don't need a keystore file to be uploaded to Appcircle. If you are building your app for distribution, you need to upload your keystore file in order to have your application signed.

In-Project Keystore Usage

You can alternatively have your signing details stored in your Gradle file and use your in-project keystore to sign your app.;

Go to build workflow editor and disable Sign Application step to use your keystore in your Gradle file.

FAQ

What to Do if I Lost My Keystore (Signing File)

First, the keystore is essential for verifying app ownership and enabling updates on platforms like Google Play or Huawei AppGallery.

If you have lost your keystore, here are the steps you can take:

Google Play:

The Google Play Console can't restore a lost signing file, but it does let you reset it. To reset your signing file, follow these steps:

Only the account owner on Google Play Console can reset the signing file.

  1. Go to Google Play Console.
  2. Select the app for which you want to reset the signing file.
  3. Click the App signing under the ⚙️ Setup section.
  4. Scroll down and click the Request upload key reset button.
  1. Choose I lost my upload key.
  1. Generate a new upload key via Appcircle or follow these instructions..
  2. Export the upload key certificate as a PEM file using the provided command.
  3. Upload the PEM file.
  4. Click the Request button.
  5. You’ll receive an email within a few days if your request is approved by the Google Play Console team.
tip

To cancel the reset request, click Cancel Request under the Request upload key reset header after step 9.

warning

Resetting your upload key doesn’t affect the app signing key that Google Play uses to re-sign APKs before delivering them to users.

For more details, please check Google Play's documentation:

Huawei AppGallery:

Whether you can release the same app after losing the keystore on Huawei AppGallery depends on if you have previously used Huawei App Signing Service.

  • Without App Signing Service: You cannot update the app. You'll need either a new package name or a key change, which will require all users to reinstall the app.

  • With App Signing Service: Your key is protected on the server. You only need to manage your upload key, and even if it's lost, you can still update the app without user impact.