Android Keystore Manager

The Keystore Manager is a window which allows you to create, configure or load Android keystores and keys. For further information see Android’s Keys, Certificates and Keystores documentation.

To open the Keystore Manager, open the Android publishing window and select the Keystore Manager button.

Note: You cannot change this keystore, key or certificate information once you sign your Android app.

Creating a new keystore

Use the Keystore dropdown to create a new keystore.

1. From inside the dropdown, click Create New.
2. Select Anywhere or In Dedicated Location.
3. Enter a password in Keystore password.
4. Re-enter the password in Confirm password.

Creating a new keystore automatically creates a new key. Fill in the New Key fields in the keystore manager.

Choosing your keystore location

When you create a new keystore, the storage location you choose changes the default location that Unity opens your file explorer in to save your file. You can still change this after the file explorer opens. - Choose Anywhere to open the file explorer. By default, Unity stores your keystore inside your project folder. However, you can store this anywhere on your machine. If you store your keystore outside of your project folder, Unity saves an absolute path. - Choose In Dedicated Location to open the file explorer in a custom default location. By default, this path points to $HOME/ on MacOS and to %USER_HOME%\ on Windows.

To define a new project-wide dedicated location, go to Unity > Preferences > External Tools > Android > Keystores Dedicated Location, then click Browse to select a location or enter a path in the text box.

If you store a keystore to a dedicated location, Unity saves a relative path. This relative path is equal to the dedicated location paths on other machines. Therefore, the folders don’t need to be in the same place on both machines.

Note that if you save the new keystore outside of your project folder or a shared directory, collaborators on your project might not have access to it.

Loading an existing keystore within the Keystore Manager

Use the Keystore dropdown to load an existing keystore.

1. Select Select Existing.
2. Select Browse to load a keystore from your file system, or select a keystore stored in a Dedicated Location from below the partition.
3. Enter the password in Keystore password.
4. Select Load Keys.

If you have multiple keys in your keystore, select a key for your project in the Android Publishing Settings Project Key fields.

Note: You can also choose an existing keystore directly from the Android Publishing Settings, without using the Keystore Manager window.

Adding a new key to an existing keystore

Use the following steps to store multiple keys in a keystore.

1. Load an existing keystore (see Loading an existing keystore within the Keystore Manager).
2. Fill in the New Key Values.
3. Select Add Key. A Key and Keystore Created dialogue window appears.
4. Select the new key as your project key.