Skip to main content

CONFIGURATION GUIDE

Configuring Android App Distribution

It's time to set up your Android app distribution. We'll configure the necessary credentials to publish your apps to the Google Play Store.

New to Google Play Console?

Creating a Google Play Console Account​

If you haven't set up your Google Play Console account yet:

  1. Visit play.google.com/console/signup
  2. Sign in with your Google account
  3. Accept the developer agreement
  4. Pay the one-time registration fee ($25)
  5. Complete your account details:
    • Developer name (public)
    • Contact information
    • Address details

Choose your developer name carefully

Choose your developer name carefully - this will be visible to users on the Play Store, especially important for business accounts.

Setting Up Android Code Signing​

Full Video

Every Android app needs a digital signature - think of it as your app's unique fingerprint that verifies its authenticity to the Play Store. We'll create a new one and add it to Codemagic.

Creating Your Keystore​

To generate a keystore, you'll need to use Java's Keytool utility from the command line. This command will ask you to enter your details and set up passwords for both the keystore and the key. It will create a codemagic_your_team_name.keystore file valid for 10,000 days.

Keystore Name

Make sure to replace your_team_name with your actual team name in snake case.

keytool -genkey -v -keystore codemagic_your_team_name.keystore -storetype JKS \
        -keyalg RSA -keysize 2048 -validity 10000 -alias codemagic_your_team_name

Adding Your Keystore to Codemagic​

Now let's securely store your keystore in Codemagic:

  1. Open your Codemagic Team settings
  2. Navigate to Code signing identities
  3. Select the Android keystores tab
  4. Upload your keystore file (drag and drop or choose file)
  5. Enter the required credentials:
    • Keystore password
    • Key alias
    • Key password
  6. For the reference name, enter Android Keystore (YOUR_TEAM_NAME)
  7. Click Add keystore to save

Important Security Note

Keep your keystore file somewhere safe! While Codemagic stores it securely, you won't be able to download it again later. So make sure to save it in a secure location and save the password in a secure place. Never commit it to a public repository.

What's Next?​

Perfect! Your Android signing credentials are now set up. Let's move on to configuring Shorebird for live app updates.