fastlane

fastlane is an open-source app automation tool for iOS, Android and for most cross-platform frameworks, for example, React Native, Xamarin and Flutter. fastlane Step helps you integrate your lane to your Bitrise Workflow and runs your lane based on the fastlane actions with minimal configuration. If your Apple Developer Portal account is connected to Bitrise, the FASTLANE_SESSION Environment Variable will pass on the session data to fastlane.

Configuring the Step

Before you start configuring the Step, make sure you've connected to Apple services either by API key, Apple ID or through Fastlane Step's input fields.

1. Add the fastlane Step to your Workflow after the Git Clone Repository Step or any other dependency Step.
2. Based on your project's fastlane setup, you can add your project's default lane or a custom lane in the fastlane lane input.
3. If your fastlane directory is not available in your repository's root, then you can add the parent directory of fastlane directory in the Working directory input.
4. If your project doesn't contain a fastlane gem in your project's Gemfile, you can use the Should update fastlane gem before run input. Set this input to true so that the Step can install the latest fastlane version to your project. If a gem lockfile (Gemfile.lock or gems.locked) includes the fastlane gem in the working directory, that specific fastlane version will be installed.
5. Select yes in the Enable verbose logging input if you wish to run your build in debug mode and print out error additional debug logs.
6. Select yes in the Enable collecting files to be included in the build cache to cache pods, Carthage and Android dependencies.

Troubleshooting

If you run your lane on Bitrise and your build fails on the fastlane Step, the logs won't reveal too much about the error since it's most likely related to the fastlane file's configuration. We recommend you swap your fastlane actions for Bitrise Steps which will bring out the problem.

Useful links

• About fastlane
• Connecting your Apple Developer Account to Bitrise
• Running fastlane on Bitrise

Related Steps

• Deploy to iTunes Connect/Deliver
• iOS Auto Provision
• Fastlane Match