Skip to main content

Connecting an app

Abstract

After successfully adding a new app to Release Management, you need to connect it to an existing app in the App Store or Google Play.

After successfully adding a new app to Release Management, connect it to an app in either the App Store or Google Play to be able to create releases for the app.

  • For iOS, this means an app with a valid bundle ID on App Store Connect.

  • For Android, this means an app with a valid package name on Google Play.

iOS

Android

  1. Make sure your iOS app is registered on the App Store.

    Later in the connecting process, you will have to enter the bundle ID of the app.

  2. Make sure you have a Bitrise project with a working Apple service connection.

    Release Management requires a working Apple Service connection to manage releases of a connected app in App Store Connect: Connecting to an Apple service with API key.

  3. Open your app in Release Management and select Releases in the left navigation.

  4. Click Connect app.

    release-man-connect-app.png
  5. The dialog will show you're connecting to the App Store and the selected API key. Review them and then click Next.

    You can change the API key at this stage. If you don't have one set up, click Go to settings.

  6. Enter the bundle ID and click the button next to the input field to validate it.

    The bundle ID must be an exact match of the bundle ID of an existing app on the App Store. If the validation is successful, the Connect button will be enabled.

  7. Click Connect.

Managed publishing

We strongly recommend turning off Managed publishing in Google Play for your app. Release Management works even with the feature enabled but you will need to finalize each release in the Play Console.

  1. Make sure your Android app is registered on Google Play.

  2. Make sure you have a Bitrise project with a working Google Play service account.

    Release Management requires a Google service account with Google API access to manage releases of a connected app in Google Play: Connecting a Google Play Console service account to Bitrise.

  3. Open your app in Release Management and select Releases in the left navigation.

  4. Click Connect app.

    release-man-connect-app.png
  5. The dialog will show that you're connecting to Google Play and the status of the Google service account. Review them and then click Next.

    You can change the service account at this stage. If you don't have one set up, click Go to settings.

  6. Enter the Google Play app's package name in the field and click the button next to the input field to validate it.

    If the package name is found on Google Play, the Connect button will be enabled.

    If the validation doesn't find a match, check if you typed the package name correctly and make sure your Google Play service account is working.

  7. Click Connect.