In this blog we will explain how to auto-deploy builds from iOS to the App Store using Bitrise. First we will look at how to get the API key from the Apple App Store and how to connect the API key to Bitrise. Then we will take a look at how to connect your Apple Service to your apps team in Bitrise. In the last step we will add auto provision to your workflow in Bitrise.

Introduction

In order to set up auto deployment Bitris all builds must be signed properly with a correct provisioning profile. In this guide we will explain the steps needed to connect Bitrise to your App Store Connect account so each build will be uploaded automatically. This way no profiles need to be generated manually and uploaded manually. The first two steps of this guide are done in App Store Connect and require the roles Account Holder and Admin. In case you don't have one of these roles these steps must be performed by someone else. You can send them this guide and ask them to perform steps 1 and 2. At the end of step 2 some information needs to be collected. These steps clearly describe what is needed to setup the configuration in Bitrise later on. For this you need:

  • API key file (this is a .p8 file)
  • Issuer ID
  • KeyID

If someone else performs steps 1 and 2 make sure they provide you with those three things.

1. Request access to App Store Connect API

First of all we must request access to the App Store Connect API. This can be done by a user with the Account Holder role.

If you have this role you can request access by following these steps:

Auto Deploy iOS
  • You will receive an email when the request was approved. You cannot continue until this is approved. The mail will look something like this:
iOS auto provisioning in bitrise

2. Generate API Key in App Store Connect

Once App Store Connect API access is requested we must generate an API key. This can only be done by a user with the Admin role.

If you have this role you can request access by following these steps:

iOS api key in app store
  • Give the key the name Bitris and under Access select admin then tap Generate.
  • After the API key has been generated select Download API key and save the .p8 file somewhere you won't lose it. You will need this file in Bitrise later on.
ios deployment bitrise
  • Above the generated key you will see Issuer ID. You can select the Copy button next to it to copy the value. This value must be entered in Bitrise later on.
  • Next to the KeyID you can select the CopyKeyID button to copy the value. This value must be entered in Bitrise later on as well.

3. Connect Apple Service account in Bitrise

Once the key is generated and downloaded, we can use it in Bitrise to connect our Apple Account to our Bitrise account.
Perform the following steps:

bitrise and iOS deployment
  • Select Apple Service Connection in the menu on the left hand side (under CONNECTED ACCOUNTS).
apple service connection
  • Select the Add connection button.
  • In the pop up enter a name (recommend using your apple developer organization name here).
  • Under Issuer ID paste the issuer id you copied from App Store Connect.
  • Under KeyID paste the key id you copied from App Store Connect.
  • Finally select the Upload a Private Key (.p8) button and find the file you downloaded earlier.
  • After everything is setup select the Connect button to save your connection.
apple api key authentication

4. Add Apple Service connection to your app's team in Bitrise

Once the Apple Service Connection is made it still needs to be added to the team of your app. This must be for every app:

  • Open the app you wish to add the connection to (either via dashboard or via the Search for app… search bar in the top left corner).
  • Once you have your app open select the Team Tab.
iOS deployment to your app's team in bitrise
  • Scroll all the way down to Apple service connection and select Connection not set underneath API key authentication (recommended). This will show a dropdown with all your connections.
  • Select the connection you made in the previous step.
apple service connection iOS and Bitrise
  • That's it! Changes have been saved automatically.

5. Add iOS Auto Provision to your workflow in Bitrise

Once we have an Apple Service connection setup and connected to our team we can use it to auto provision our apps during our workflow:

  • Open the correct app.
  • Select the Workflow tab to open the workflow editor.
iOS auto-provisioning
  • In the editor select the + button somewhere in you flow to add a new step. Make sure to add this above any step that builds your app (for example above the Export Archive & Export for iOS).
ios deployment
  • The steps selector will be opened. Type iOS Auto Provision in the search bar to filter the results and select iOS Auto Provision with App Store Connect API (of not select the option with Apple ID).
  • In the step editor for the step, you just created, we only need to change one thing. Scroll down until you see Distribution Type (Required). In the text field it probably says development. We need to change this. Select the button Insertvariable on the right-hand side of this section.
distribution ios and bitrise
  • In the popup that is opened select $BITRISE_EXPORT_METHOD. You can filter the results by typing in the search bar. Selecting this makes sure the export method is always used from the environment variables and you can change it without changing your workflow itself.
  • Remove any other profiling step from your workflow. You probably have a step called Certificate and profile installer. Select this step to open the editor and select the trash can icon to delete it.
certificate and profile installer
  • Last but not least, make sure to save your changes. Do this by selecting the button in the top right corner or using the keyboard shortcut CMD + S (on mac).
bitrise yml

ALWAYS AWARE OF THE CURRENT NEWS?FOLLOW OUR SOCIAL MEDIA ACCOUNTS.

Marketer

CONTACT US

Ready to create something awesome together? Give us a call. We are looking forward to it!

Contact us

CONTACT

Do you have a question? Contact us without obligation and I will be happy to help you.

Contact us
Marketer