deliver • snapshot • frameit • pem • sigh • produce • cert • spaceship • pilot • boarding • gym • scan • match
-------fastlane
######fastlane lets you define and run your deployment pipelines for different environments. It helps you unify your apps release process and automate the whole process. fastlane connects all fastlane tools and third party tools, like CocoaPods and Slack.
Get in contact with the developer on Twitter: @FastlaneTools
Features • Installation • Quick Start • Example Setups • Documentation • Need help?
Features
Why should you have to remember complicated commands and parameters?
Store your configuration in a text file to easily test, build, and deploy from any computer.
Take a look at how Wikipedia and Product Hunt use fastlane
.
Define different environments (lanes
) in your Fastfile
: Examples are: appstore
, beta
and test
.
You define a lane
like this (more details about the commands in the Actions documentation):
lane :appstore do
increment_build_number
cocoapods
scan
snapshot
sigh
deliver
sh "./customScript.sh"
slack
end
To launch the appstore
lane, just run:
fastlane appstore
| fastlane
--------------------------|------------------------------------------------------------
fastlane
tools and third party tools)
deployment lanes
for App Store deployment, beta builds or testing
fastlane
ipa
file)
Jenkins
configs
Fastfile
| Full git and mercurial support
fastlane website for more information about why and when to use fastlane
.
Take a look at the Be the first to know about updates and new fastlane tools.
Like this tool?Installation
I recommend following the fastlane guide to get started.
sudo gem install fastlane --verbose
Make sure, you have the latest version of the Xcode command line tools installed:
xcode-select --install
If you experience slow launch times of fastlane, try running
gem cleanup
to clean up outdated gems.
System Requirements: fastlane
requires Mac OS X or Linux with Ruby 2.0.0 or above.
If you want to take a look at a project, already using fastlane
, check out the fastlane-examples with fastlane
setups by Wikipedia, Product Hunt, MindNode and more.
Quick Start
The setup assistant will create all the necessary files for you, using the existing app metadata from iTunes Connect.
cd [your_project_folder]
fastlane init
- Follow the setup assistant, which will set up
fastlane
for you - Further customise the
Fastfile
with actions.
For more details, please follow the fastlane guide or documentation.
There are also 2 Japanese fastlane guides available: qiita and mercari
Available commands
Usually you'll use fastlane by triggering individual lanes:
fastlane [lane_name]
Other commands
fastlane actions
: List all availablefastlane
actionsfastlane action [action_name]
: Shows a more detailed description of an actionfastlane lanes
: Lists all available lanes with descriptionfastlane list
: Lists all available lanes without descriptionfastlane docs
: Generates a markdown based documentation of all your lanesfastlane new_action
: Create a new action (integration) for fastlane
Examples
See how Wikipedia, Product Hunt and MindNode use fastlane
to automate their iOS submission process.
fastlane
Toolchain
fastlane
is designed to make your life easier by bringing together all fastlane
tools
deliver
: Upload screenshots, metadata and your app to the App Storesnapshot
: Automate taking localized screenshots of your iOS app on every deviceframeit
: Quickly put your screenshots into the right device framespem
: Automatically generate and renew your push notification profilessigh
: Because you would rather spend your time building stuff than fighting provisioningproduce
: Create new iOS apps on iTunes Connect and Dev Portal using the command linecert
: Automatically create and maintain iOS code signing certificatescodes
: Create promo codes for iOS Apps using the command linespaceship
: Ruby library to access the Apple Dev Center and iTunes Connectpilot
: The best way to manage your TestFlight testers and builds from your terminalboarding
: The easiest way to invite your TestFlight beta testersgym
: Building your iOS apps has never been easiermatch
: Easily sync your certificates and profiles across your team using git
Statistics
fastlane
tracks the number of errors for each action to detect integration issues. The data will be sent to fastlane-enhancer and is available publicly.
You can easily opt-out by adding opt_out_usage
to your Fastfile
or by setting the environment variable FASTLANE_OPT_OUT_USAGE
. To also disable update checks, set the FASTLANE_SKIP_UPDATE_CHECK
variable.
You can optionally submit crash reports, run fastlane enable_crash_reporting
to get started. This makes resolving issues much easier and helps improving fastlane. More information
Credentials
A detailed description about how fastlane
stores your credentials is available on a separate repo.
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
. Check out the project pages of the other tools for more sponsors and contributors.
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.