Deploying an iOS app to

Deploy an app to Bitrise to be able to download the .ipa file and install it on devices specified in the app’s Development type provisioning profile. This way, your internal testers can easily test the app.

Before you start

Make sure that you have:

Developer certificate and Development profile

To deploy an iOS app, you will always need a Developer type certificate and a Development type provisioning profile. Even if you want to deploy to the App Store, the these are still required: they are used to create the .xcodearchive file from the provided code in the process of exporting the .ipa file.

Deploying the app

  1. Make sure the Certificate and profile installer Step or the iOS Auto Provision Step is in your Workflow.

    Do NOT use both!

  2. Make sure the Xcode Archive & Export for iOS Step is in your Workflow.
  3. Set the Select method for export input of the Step to development.

    You can use other export methods, too, but if you only deploy to Bitrise and want to install your app on the specified devices of internal testers, development is sufficient.

  4. Make sure the Deploy to Step is in your Workflow.

    By default, the value of the Enable public page for the App? input is set to true. This way, once the build runs, a public install page will be available with a long and random URL which can be shared with others who are not registered on Bitrise. This URL is sent to the users in an email. The Notify: User Roles and the Notify: Emails inputs determine which users get the email.

  5. Start a build.
  6. When the build is finished, go to the app’s Builds page and click the latest build.
  7. Click the APPS & ARTIFACTS tab to find your .ipa file.

    You can also find the public install URL here.

And that’s it! The file can now be installed on all the devices included in the app’s provisioning profile.