Steps requiring Apple authentication

In this guide we list all the Steps that require authentication and the authentication methods that you can choose from depending on your project’s requirement.

Manage iOS Code Signing Step

This Step takes care of setting up the required code signing assets before your project is built on Bitrise. The Step uses your API key or your Apple ID and password authentication to connect to an Apple service. Once connection is configured, the Step will:

  • Generate, update and download the provisioning profiles needed for your iOS project.

  • Verify and register the project's Bundle IDs on the Apple Developer Site.

  • Register the iOS devices connected to your Bitrise account with the App Store Connect.

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Xcode Archive & Export for iOS Step

The Step archives your Xcode project by running the xcodebuild archive command and then exports the archive into an IPA file with the xcodebuild -exportArchive command. This IPA file can be shared, installed on test devices, or uploaded to the App Store Connect.

The Step can also perform iOS code signing if the Automatic code signing method input specifies a method. By default, it's turned off. To perform iOS code signing, it can use API key or Apple ID authentication.

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Export iOS and tvOS Xcode archive Step

Exports an IPA from an existing iOS and tvOS .xcarchive file. You can add multiple Export iOS and tvOS Xcode archive Steps to your Workflows to create multiple different signed IPA files.

The Step can also perform iOS code signing if the Automatic code signing method input specifies a method. By default, it's turned off. To perform iOS code signing, it can use API key or Apple ID authentication.

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Xcode Build for testing for iOS Step

The Step runs Xcode's xcodebuild command with the build-for-testing option. This builds your app and associated tests so that you can, for example, upload it to a third-party testing service to run your tests on a real device. The Step also creates an .xctestrun file. To be able to run your tests on a real device it needs code signing.

The Automatic code signing method Step input allows you to log you into your Apple Developer account based on the Apple service connection you provide on Bitrise and download any provisioning profiles needed for your project based on the Distribution method.

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Deploy to App Store Connect with Deliver Step

With this Step, you can upload screenshots, metadata and binaries to https://appstoreconnect.apple.com/ and submit your app for App Store review using the fastlane deliver action. The Deploy to App Store Connect with Deliver (formerly iTunes Connect) Step can connect to your Apple Developer Account either with Apple ID or with the App Store Connect API, or through Step inputs. Please note that in the case of 2FA enabled Apple ID, the Deploy to App Store Connect with Deliver (formerly iTunes Connect) Step can only work with Apple ID authentication which you can set on the Apple Service page of your profile. The default method is the API key authentication. Choose the connection method that works with your project:

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Connecting to an Apple Service with Step inputs

Deploy to App Store Connect - Application Loader (formerly iTunes Connect) Step

With this Step, you can upload binaries (.ipa or .pkg files) to https://appstoreconnect.apple.com/. The Deploy to App Store Connect - Application Loader (formerly iTunes Connect) Step can connect to your Apple Developer Account either with the App Store Connect API, the Apple ID and password, or through Step inputs. Choose the connection method that works with your project:

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Connecting to an Apple Service with Step inputs

fastlane Step

With this Step you can run your fastlane lanes on Bitrise just like you would locally. Please note that in the case of 2FA enabled Apple ID, the Fastlane Step can only work with Apple ID authentication which you can set on the Apple Service page of your profile.

Connecting to an Apple service with API key

Connecting to an Apple service with Apple ID

Connecting to an Apple Service with Step inputs