πŸš€ The easiest way to automate building and releasing your iOS and Android apps
Ruby Objective-C Shell HTML Java Swift
Switch branches/tags
Permalink
Failed to load latest commit information.
.assets Update Gemfile referenced from CONTRIBUTING (#8318) Feb 21, 2017
.github Put motivation and context above description (#8953) Apr 21, 2017
bin Detect running Ruby version and fail early (#8525) Mar 15, 2017
cert Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
credentials_manager Improve docs around env variables in credentials_manager (#8882) Apr 13, 2017
deliver Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
fastlane Don't report crashes from plugins (#9277) May 26, 2017
fastlane_core Don't report crashes from plugins (#9277) May 26, 2017
frameit Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
gym Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
match Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
pem Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
pilot Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
produce Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
rakelib Upgrade rubocop to 0.48 (#8652) Mar 27, 2017
scan Fix scan’s custom report name not working with multiple output types (#… May 29, 2017
screengrab Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
sigh Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
snapshot Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
spaceship Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
supply Remove version badges from individual tools from pre-mono-gem times (#… May 26, 2017
.gitignore Update fastlane spaceship to use the new TestFlight (#8871) Apr 20, 2017
.hound.yml Switched to fastlane mono repo Mar 7, 2016
.rspec Setting --default-path for rspec and made all testing directions accu… Dec 20, 2016
.rubocop.yml Fix string handling in print_table wrapping (#8951) Apr 21, 2017
Brewfile Add Brewfile Feb 2, 2017
CODE_OF_CONDUCT.md Move code of conduct to main repo and update links. Mar 7, 2016
CONTRIBUTING.md update header Mar 14, 2017
CORE_CONTRIBUTOR.md Add missing header (#8415) Mar 3, 2017
Dangerfile Add note in SnapshotHelper.swift about increment the version number (#… May 11, 2017
Gemfile Change eval to eval_gemfile for Pluginfile (#8299) Feb 19, 2017
LICENSE Update LICENSE for all repos Mar 7, 2016
README.md Add Stackdriver crash reporting (#9113) May 11, 2017
Rakefile Add Josh to have access to RubyGems (#8896) Apr 17, 2017
RespondingToIssuesAndPullRequests.md Update Gemfile referenced from CONTRIBUTING (#8318) Feb 21, 2017
ToolsAndDebugging.md Update Gemfile referenced from CONTRIBUTING (#8318) Feb 21, 2017
VISION.md Update the vision doc to remove Twitter references (#8815) Apr 7, 2017
YourFirstPR.md Update Your First PR instructions post monogem (#8754) Apr 3, 2017
circle.yml [CI] Cache dependencies (#8200) Feb 12, 2017
dependencyci.yml Create dependencyci.yml (#7702) Jan 3, 2017
fastlane.gemspec Add tests for TestFlight methods in spaceship and fastlane_core (#8962) Apr 28, 2017
spec_helper.rb Update fastlane tests to work with Ruby 2.4.0 (#8545) Mar 16, 2017

README.md

fastlane Logo

fastlane

Twitter: @FastlaneTools License Gem Build Status

✨ Check out docs.fastlane.tools on how to get started with fastlane ✨

fastlane is a tool for iOS and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.

Use a lane to define your process:

lane :beta do
  increment_build_number
  cocoapods
  match
  testflight
  sh "./customScript.sh"
  slack
end

Then to deploy a new 'beta' version of your app just run fastlane beta πŸš€

fastlane
✨ Connect iOS and Android build tools into one workflow (both fastlane tools and third party tools)
🚝 Define different deployment lanes for App Store deployment, beta builds, or testing
🚒 Deploy from any computer, including a CI server
πŸ”§ Extend and customise functionality
πŸ’­ Never remember any difficult commands, just fastlane
🎩 Easy setup assistant to get started in a few minutes
βœ‰οΈ Automatically pass on information from one build step to another (e.g. path to the ipa file)
πŸ“ƒ Store everything in Git. Never lookup build commands in Jenkins configs again.
πŸš€ Saves you hours for every app update you release
✏️ Flexible configuration using a fully customisable Fastfile
🚠 Implement a fully working Continuous Delivery process
πŸ‘» Jenkins Integration: Show output directly in test results
πŸ“– Automatically generate Markdown documentation of your lane configurations
🐣 Over 170 built-in integrations available
πŸ’» Support for iOS and Android apps
:octocat: Full Git and Mercurial support

Check out the new fastlane docs


Like this tool? Be the first to know about updates and new fastlane tools.

Installation

Make sure you have the latest version of the Xcode command line tools installed:

xcode-select --install

Choose your installation method:

Homebrew Installer Script Rubygems
macOS macOS macOS or Linux with Ruby 2.0.0 or above
brew cask install fastlane Download the zip file. Then double click on the install script (or run it in a terminal window). sudo gem install fastlane -NV

Quick Start

Get started distributing your first app with fastlane within minutes:

Create your first Fastfile

Want to learn more? Explore guides for iOS or Android.

Available Commands

Typically you'll use fastlane by triggering individual lanes:

fastlane [lane_name]

Other Commands

  • fastlane actions: List all available fastlane actions
  • fastlane action [action_name]: Shows a more detailed description of an action
  • fastlane lanes: Lists all available lanes with description
  • fastlane list: Lists all available lanes without description
  • fastlane new_action: Create a new action (integration) for fastlane
  • fastlane env: Print out the fastlane ruby environment when submitting an issue

If you'd like to take a look at a project already using fastlane check out fastlane-examples which includes fastlane setups by Wikipedia, Product Hunt, MindNode, and more.


Check out the new fastlane docs


fastlane Toolchain

In addition to fastlane's commands, you also have access to these fastlane tools:

  • deliver: Upload screenshots, metadata, and your app to the App Store
  • supply: Upload your Android app and its metadata to Google Play
  • snapshot: Automate taking localized screenshots of your iOS and tvOS apps on every device
  • screengrab: Automate taking localized screenshots of your Android app on every device
  • frameit: Quickly put your screenshots into the right device frames
  • pem: Automatically generate and renew your push notification profiles
  • sigh: Because you would rather spend your time building stuff than fighting provisioning
  • produce: Create new iOS apps on iTunes Connect and Dev Portal using the command line
  • cert: Automatically create and maintain iOS code signing certificates
  • spaceship: Ruby library to access the Apple Dev Center and iTunes Connect
  • pilot: The best way to manage your TestFlight testers and builds from your terminal
  • boarding: The easiest way to invite your TestFlight beta testers
  • gym: Building your iOS apps has never been easier
  • match: Easily sync your certificates and profiles across your team using Git
  • scan: The easiest way to run tests for your iOS and Mac apps

Metrics

fastlane tracks a few key metrics to understand how developers are using the tool and to help us know what areas need improvement. No personal/sensitive information is ever collected. Metrics that are collected include:

  • The number of successes, errors, and crashes for fastlane and each action run in a Fastfile
  • The running time of fastlane
  • The method by which fastlane was installed
  • Whether fastlane is being run on CI
  • The platform (e.g. iOS, Android) for which fastlane is run
  • A hash of the app identifier or package name, which helps us anonymously identify unique usage of fastlane

We have recently changed the destination service to which these metrics are reported, as well as the format of the data, but the data that is collected has not changed.

You can easily opt-out of metrics collection by adding opt_out_usage at the top of your Fastfile or by setting the environment variable FASTLANE_OPT_OUT_USAGE. Participating helps us provide the best possible support for fastlane, so we hope you'll consider it a plus! βž•

Crash Reporting

In order to continuously improve stability, fastlane will record crash reports with sanitized stacktraces. Sanitization removes personal information from the stacktrace and error message (including home directories, fastlane path, gem paths, environment variables, and parameters).

You can easily opt-out of crash reporting by adding opt_out_crash_reporting at the top of your Fastfile or by setting the environment variable FASTLANE_OPT_OUT_CRASH_REPORTING. Just like metrics mentioned above, participating helps us provide the best possible support for fastlane, so we hope you'll consider it a plus! βž•

Need Help?

Please submit an issue on GitHub and provide information about your setup.

Special Thanks

Thanks to all contributors for extending and improving fastlane.

Speakers

Are you giving a talk on fastlane? Great! Let us know so we can help you give the best possible presentation.

Code of Conduct

Help us keep fastlane open and inclusive. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.