Swiftpack.co - Package - fastlane/fastlane

fastlane Logo

Twitter: @FastlaneTools License Gem Build Status PRs welcome!

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

✨ All fastlane docs were moved to docs.fastlane.tools

Need Help?

Before submitting a new GitHub issue, please make sure to

If the above doesn't help, please submit an issue on GitHub and provide information about your setup, in particular the output of the fastlane env command.

Note: If you want to report a regression in fastlane (something that has worked before, but broke with a new release), please mark your issue title as such using [Regression] Your title here. This enables us to quickly detect and fix regressions.

fastlane team

Fumiya Nakamura

Stefan Natchev

Andrew McBurney

Aaron Brager

Jimmy Dee

Maksym Grebenets

Felix Krause

Max Ott

Jorge Revuelta H

Kohki Miki

Joshua Liebowitz

Olivier Halligon

Daniel Jankowski

Jan Piotrowski

Luka Mirosevic

Josh Holtz

Helmut Januschka

Matthew Ellis

Danielle Tomlinson

Iulian Onofrei

Manu Wallner

Jérôme Lacoste

Special thanks to all contributors for extending and improving fastlane.

Contribute to fastlane

Check out CONTRIBUTING.md for more information on how to help with fastlane.

Code of Conduct

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


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 fastlane runs
  • A salted hash of the app identifier or package name, which helps us anonymously identify unique usage of fastlane

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. Check out the metrics code on GitHub


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.

✨ All fastlane docs were moved to docs.fastlane.tools


Stars: 29801


Used By

Total: 0


2.160.0 Deliver supports App Store Connect API Key - 2020-09-16 16:45:00

  • [spaceship] support PENDING_APPLE_RELEASE (#17254) via Josh Holtz
  • [deliver] add support for App Store Connect API Key (#17238) via Josh Holtz
  • [deliver] add retry when fetching edit app version and edit app info (#17235) via Josh Holtz
  • [frameit] allow setting font_weight for keyword/title (#17159) via Herbert Poul
  • [actions] add filter date to download_dsyms (#17228) via Mark Woollard

2.159.0 Improvements - 2020-09-10 22:59:38

  • [spaceship] add skip_select_team to Spaceship::ConnectAPI.login (#17215) via Josh Holtz
  • [Fastlane.swift] Swift Package Manager support (#16844) via Jorge
  • [actions] fixing an issue where last_git_tag command sometimes didn't return the correct tag based on pattern when the commit has multiple tags applied (#17204) via Gligor Kotushevski
  • [match] fixed an issue that caused match import command to create wrong names for some provisioning profiles. (#17213) via Nikola Nikolov
  • [deliver] fix UploadMetadata taking too long to run (#17169) via Pierluigi D'Andrea
  • [snapshot] fix snapshot landscape orientation issue (#17180) via Jari Kalinainen
  • [spaceship] fix Spaceship::ConnectAPI.get_app_price_points (#17200) via Josh Holtz

2.158.0 Improvements - 2020-09-04 22:31:47

  • [precheck] migrate to App Store Connect API (except for IAPs) (#17167) via Josh Holtz
  • [spaceship] pause, resume and complete a appstore version in phased release (#17165) via polmum

2.157.4 Improvements - 2020-09-04 17:47:29

  • [spaceship][match] fix and improve team selection flow with Spaceship::ConnectAPI client (#17160) via Josh Holtz

2.157.3 Improvements - 2020-09-04 00:58:05

  • [actions] fix download_dsyms, app_store_build_number, and test_flight_build_number (#17148) via Josh Holtz
  • [deliver] update example rating config json (#17138) via Josh Holtz
  • [spaceship] automatically select Spaceship::Portal or Spaceship::Tunes team if env is set when logging into Spaceship:: ConnectAPI (#17136) via Josh Holtz
  • [match] fix occasional auth issues with App Store Connect (#17133) via Josh Holtz
  • [resign] add full sed path for resign.sh (#17075) via Keith Smiley
  • [spaceship] add endpoint AppPricePoint (#17078) via Bolo Michelin
  • [spaceship] get selected build from App Store Version (#17118) via Josh Holtz

2.157.2 Improvements - 2020-08-28 16:12:05

  • [spaceship] share tunes and portal session when logging in with apple id from connect api (#17110) via Josh Holtz

2.157.1 Improvements - 2020-08-28 04:54:08

  • [deliver] fix upload screenshot when display type not yet created (#17106) via Josh Holtz
  • [screengrab] handle permission denied during screengrab adb pull (#17101) via Aman Gupta Karmani
  • [screengrab] pass adb_path into AdbHelper (#17099) via Aman Gupta Karmani
  • [spaceship] separate portal team id and tunes team id (#17104) via Josh Holtz

2.157.0 Improvements - 2020-08-27 16:27:47

  • [deliver] improve screenshot uploading verification (#17060) via Satoshi Namai
  • [screengrab] Wait for device to reconnect after adb root (#17077) via Olivier Halligon
  • [action] fix formatting syntax error on commit_version_bump (#17092) via Sandeep M
  • [gym] safer logic getting last 5 lines of logs (#17096) via Christian Schmidt
  • [pilot][spaceship][action] set ASC API key in pilot, new app_store_connect_api_key action, and spaceship fixes for both of those (#17061) via Josh Holtz
  • [spaceship] improve multiple sessions and multiple auth types (#17042) via Josh Holtz
  • [action] Add support to exclude files from sonar qube analysis (#17049) via David Cacenabes

Using the App Store Connect API Key

  • pilot is the first tool to fully support authorization with the API Key
  • Go to https://docs.fastlane.tools/app-store-connect-api/ to read more on fastlane and the App Store Connect API
    • Learn about the new app_store_connect_api_key action
    • Learn about the fastlane App Store Connect JSON API Key file format
    • See that status of tools that support the App Store Connect API Key

2.156.1 Improvements - 2020-08-13 18:55:40

  • [deliver] fix upload_screenshots when not using upload_to_app_store for screenshots (#17051) via Satoshi Namai
  • [deliver] fix upload screenshots when no screenshots (#17040) via Josh Holtz

2.156.0 Improvements - 2020-08-11 15:34:20

  • [deliver] make uploading and deleting screenshots more efficient (#16972) via Satoshi Namai
  • [gym][scan][snapshot] xcodebuild -resolvePackageDependencies missing -derivedDataPath (#16986) via Adriaan Duz
  • [screengrab] fix permission Issues on API > 21 (#17006) via Greg Billetdeaux

2.155.3 Hotfix - 2020-08-07 19:08:52

  • [sigh] fix for sending up template_name to ASC API (#17022) via Josh Holtz

2.155.2 Hotfix - 2020-08-07 12:36:33

  • [sigh] improve device logic and tests (#17018) via Josh Holtz

2.155.1 Hotfix - 2020-08-06 21:23:38

  • [sigh] fix issue with dev development devices (#17009) via Josh Holtz

2.155.0 Improvements - 2020-08-06 18:13:28

  • [spaceship] use created_date for fetching latest app store version (#17005) via Josh Holtz
  • [snapshot] add suppress_xcode_output option (#16982) via Roger Oba
  • [supply] add support for ack_bundle_installation_warning - updated (#16971) via Michael Miko
  • [deliver] fix language detection for HtmlGenerator (#16979) via Mattias Pfeiffer
  • [match] fix Google Cloud Storage Crash When No Fastfile Is Being Used (#16983) via Roger Oba
  • [match][sigh][gym] migrate to new App Store Connect API and improve building with Catalyst (#16158) via Josh Holtz
  • [action] create_keychain - Populate KEYCHAIN_NAME to lane variables upon creation of keychain (#16920) via Alex Benoit
  • [spaceship] allow modify is_opted_in_to_distribute_ios_app_on_mac_app_store on Spaceship::ConnectAPI:App (#16973) via Josh Holtz

2.154.0 Improvements - 2020-07-29 23:17:46

  • [match] fix failing tests from merge (#16968) via Josh Holtz
  • [deliver] Fixed filename for review information of AppStoreConnect (#16963) via はるふ
  • [match] add git private key support for match (#16457) via Morten Bøgh
  • [fastlane] adds git_pull rebase option (#16592) via Benjamin Borowski
  • [deliver] fixed crash on running 'deliver download_metadata' (#16964) via はるふ
  • [gym] iOS Export Options "Destination" Handling (#16609) via DomenicBianchi01
  • [frameit] look for title.strings in parent folders (#16630) via Robert Sasak
  • [spaceship] add shortcuts for getting current pending release and current in revi… (#16808) via Addison Brickey
  • [snapshot] add headless option (#16863) via Andreas Ganske
  • [fastlane_core] update the simulator device state (#16936) via Lyndsey Ferguson
  • [action] add --use-netrc option to carthage action (#16942) via Tatsuya Tanaka
  • [spaceship ]fix: infinite retry of with_asc_retry (#16953) via Valerio Castelli
  • [pilot] remove < from pilot changelog (#16933) via Alex Benoit

2.153.1 Improvements - 2020-07-24 20:58:06

  • [deliver] fix for reverse attribute mapping for app store review detail (#16930) via Josh Holtz

2.153.0 Improvements - 2020-07-24 13:26:35

  • [deliver] verify all screenshot deleted succesfully (#16842) via Josh Holtz
  • [frameit] Add font_size parameter (#16870) via Andreas Ganske
  • [action] download_dsyms - add option to pass build_number as an integer (#16900) via Alex Benoit
  • [spaceship] add endpoint availableTerritories (#16877) via Bolo Michelin
  • [fastlane] fix other_action to run in root project directory (#16889) via Jorge
  • [scan] fix empty simulator logs (#16833) via Lyndsey Ferguson
  • [spaceship] feat: support appStoreVersionReleaseRequests (#16765) via Valerio Castelli
  • [action] erb uses ErbTemplateHelper and adds trim mode (#16882) via Josh Holtz
  • [deliver] reimplementing tests from 2.150.0 (#16880) via Josh Holtz
  • [deliver] fetches app with Spaceship::ConnectAPI (#16857) via Josh Holtz

2.152.0 Improvements - 2020-07-14 03:09:36

  • [deliver] update app version before localization to prevent invalid state (#16843) via Josh Holtz
  • [fastlane] ignore vendor debug check when running tests (#16822) via Ben Scheirman
  • [actions] update danger to 8, lock faraday to <1 (#16793) via Anton Rieder
  • [pilot] add new distribute_only option (similar to 'fastlane pilot distribute' command) (#16816) via Josh Holtz
  • [action] git_branch - add support for CircleCI env variable (#16794) via Dalton Claybrook
  • [deliver] make individual_metadata_items optional to fix deprecation warning (#16805) via Roger Oba
  • [deliver][copy] fix & improve example IDFA copy (#16807) via Roger Oba

2.151.2 Improvements - 2020-07-09 03:46:58

  • [fastlane] replace blank? with to_s.empty? (#16804) via Josh Holtz
  • [deliver][spaceship] fix some small typos (#16801) via Josh Holtz
  • Fixes issue where Aws::Credentials were being initialized with blank (#16798) via Austin Treat Emmons
  • [fastlane_core] escape xcrun itmstransporter password for special characters (#16795) via Josh Holtz
  • [deliver] Update fakefs to 1.2.x (#16791) via Anton Rieder
  • [spaceship] return model (not response) from create) (#16786) via Josh Holtz
  • [deliver] implement parallel screenshot download (#16654) via Vadim Smal

2.151.1 Improvements - 2020-07-08 04:24:37

  • [spaceship] remove xml parser from Spaceship::ConnectAPI::FileUploader (#16787) via Josh Holtz

2.151.0 Improvements - 2020-07-07 22:29:22

  • [fastlane_core] strip upload param env before checking (#16783) via Josh Holtz
  • [deliver] set default ITMSTransporter transport flag to blank #16749 (#16774) via Krzysztof Romanowski
  • [action] add retry to notarize when request uuid isn't ready (#16782) via Josh Holtz
  • [match] always checkout the specified branch as master may not be the default branch (#16622) via Morten Bøgh
  • [spaceship] loosen jwt dependency (#16778) via Anton Rieder
  • [spaceship] update sinatra to 2.x (uses rack 2.x) (#16776) via Anton Rieder
  • [fastlane] fix S3ClientHelper side effects (#16687) via Austin Treat Emmons
  • [deliver] set type of auto release date to integer (#16767) via Josh Holtz
  • [action] run setup_keychain on macOS environments only (#16733) via Sean Reinhardt
  • [match] add s3_object_prefix option to match's S3Storage. (#16682) via Austin Treat Emmons
  • [sigh][resign] fix typo in resign.rb (#16705) via Eduardo Pelitti
  • [fastlane] extend socket failure payload (#16632) via Ray Deck
  • [sigh][resign] OnDemandResources (#16669) via steven 'haji' hajducko
  • [fastlane] change the brew cask install fastlane in any output to brew install fastlane (#16670) via Steven Conaway
  • [Fastlane.swift] add formatter to Fastlane.swift (#16693) via Jorge
  • [pilot] update docs to include App Store Connect roles (#16766) via Josh Holtz
  • [spaceship] remove multi_xml dependency (#16697) via Anton Rieder
  • [spaceship] remove babosa fix (#16699) via Anton Rieder
  • [deliver] fix typo: delcaration => declaration (#16756) via Koen Punt
  • [action] upload_symbols_to_crashlytics - add support for debug flag (#16745) via Yang Su
  • [action] add synchronous option to pod_push (#16698) via Ivan Artemiev

2.150.3 Improvements - 2020-07-04 13:21:02

  • [deliver] fix iPad iMessage Screenshot Typo (#16752) via Chandler Huff
  • [spaceship] add requester fields Spaceship::ConnectAPI::Certificate (#16753) via Addison Brickey
  • [deliver] use utc for autoreleasdate (#16754) via Josh Holtz

2.150.2 Improvements - 2020-07-04 03:29:08

  • [deliver] fix auto_release_date to work with timezones with minutes (#16750) via Josh Holtz
  • [spaceship] upload screenshots and previews to specific position (#16743) via Josh Holtz
  • [spaceship] added Spaceship::ConnectAPI::SandboxTester (#16742) via Josh Holtz
  • [spaceship] get app info categories easier (#16741) via Josh Holtz
  • [deliver] add platform to reject_if_possible and fix order to happen before meta (#16735) via Josh Holtz
  • [action] slather - added support to output coverage results as simple JSON (#16703) via Sam Lu

2.150.1 Improvements - 2020-07-02 14:03:44

  • [spaceship] rename model to appStoreViewAttachments (#16730) via Josh Holtz

2.150.0 Improvements and updates for App Store Connect API - 2020-07-01 23:46:50

  • [deliver][produce][spaceship] Update to use new App Store Connect API endpoints (#16640) via Josh Holtz
  • [Fastlane.swift] Increase default command timeout (#16675) via Jean Mainguy
  • [Fastlane.swift] Fix function hanging with error from command (#16692) via Jorge
  • [fastlane-core] Require rubyzip >= 2.0.0 (#16660) via Anton Rieder
  • [pilot] Strip Unicode 13 emoji (#16662) via Anton Rieder
  • [fastlane_core] fix: paths with spaces fail (#16636) via Igor Randjelovic
  • [spm] Adds disable_sandbox parameter (#16602) via Michał Matoga
  • [Fastlane.swift] Fix swift function nesting (#16578) via Jorge
  • [fastlane] remove blacklist and whitelist references (#16583) via Josh Holtz
  • [snapshot] Remove double word (#16572) via Morten Bjerg Gregersen
  • [actions] add action google_play_track_release_names (#15961) via Rob Aldred
  • [actions] download_dsyms - add explicit proxy specification for dsyms file downloading in case when 'http_proxy' env variable was specified (#16434) via zhelanov
  • [actions] update upload_symbols_to_crashlytics.rb (#16551) via Dmitry
  • [Fastlane.swift] [snapshot] Fix html_template default value (#16564) via Jean Mainguy

2.150.0.rc7 - 2020-07-01 02:48:17

  • [deliver] fix first version logic now uses number of versions, reject_if_possible, and automatic_release_date uses ms again (#16715) via @joshdholtz

  • [deliver] give better error message when edit or live version is not found when downloading screenshots (#16714) via @joshdholtz

  • [produce][spaceship] add users to app when created (#16695) via @joshdholtz
  • [deliver] updated docs on how to use submission and fix for submission information when using CLI (#16706) via @joshdholtz
  • [deliver][spaceship] wait for screenshots to be completed after processing and download properly formatted screenshots and error on processing error (#16709) via @joshdholtz
  • [deliver][spaceship] choose highest edit version, retry on 500, submit without app version (#16713) via @joshdholtz

  • [spaceship] waiting_for_review is editable (ish) (#16680) via @joshdholtz
  • [spaceship] retry file uploader and poll app preview to set frame (#16684) via @joshdholtz
  • [deliver][fastlane_core] run iTMSTransporter with xcrun if Xcode 11 or up (#16689) via @joshdholtz
  • [deliver][spaceship] fix 500 with appInfos and skip already uploaded screenshots with deliver (#16694) via @joshdholtz

  • [deliver] more helpful errors when missing values when submitting with deliver (#16646 ) via @joshdholtz
  • [deliver] fix issue with categories being deleted ($16652) via @joshdholtz
  • [deliver] warn about deprecated age rating values (#16655) via @joshdholtz
  • [produce] warn about deprecated language names (#16656) via @joshdholtz
  • [deliver] set all countries when first price tier is set (#16656 ) via @joshdholtz
  • [deliver] allow default meta language (#16657) via @joshdholtz
  • [action] fix set_changelog action to work again (#16658) via @joshdholtz
  • [spaceship][deliver] multithread screenshot deletes and and retry request on 504 response (#16667) via @joshdholtz
  • [spaceship] increase timeout from 300 to 1200 for web session app store connect api requests (#16676) via @joshdholtz

  • [deliver][produce][spaceship] Update to use new App Store Connect API endpoints (#16626) via @joshdholtz

Instructions on testing the release candidate


Update your Gemfile to include the following:

gem "fastlane", ">= 2.150.rc7"

And then run:

bundle update fastlane


gem install fastlane --pre


gem install fastlane -v 2.150.0.rc7

2.149.1 Fix for dervice data issues - 2020-06-04 01:06:06

  • [fastlane_core] fix issues with -derivedDataPath on scan, gym, and snapshot (#16560) via Josh Holtz

2.149.0 Improvements - 2020-06-03 15:43:13

  • [fastlane] update fastlane logo default in actions (#16556) via Josh Holtz
  • [match] delete the correct files when working with multiple teams on S3 (#16542) via Krzysztof Romanowski
  • [Fastlane.swift] add support for Float and Double variables that can be 0 initialized. (#16512) via Jorge
  • [upload_symbols_to_crashlytics] fix gsp_path parameter will not expand when use with api_token parameter. (#16477) via r-plus
  • [fastlane] allow newer rake versions (#16522) via Anton Rieder
  • [fastlane_core] add -derivedDataPath when SwiftPM dependencies resolving (#16534) via sudachi808
  • [screengrab] Improved screengrab documentation for use with kotlin (#16476) via Thorsten Knöller
  • [spaceship] retry request when Developer Portal responds with a 403 status code (#16478) via Erick Camacho
  • [gym] fix typo in installer_cert_name description (#16517) via Morten Bjerg Gregersen
  • [deliver] fix app_screenshot comments (#16503) via Jan Piotrowski
  • [snapshot] add disable_xcpretty option from scan (#16466) via Jean Mainguy
  • [snapshot] specify custom path for erb (#15349) via Nikolay Derkach
  • [pilot] changelog bytesize truncate tests (#14485) via Albert
  • [action] added support for Slather's SonarQube option (#16500) via Alberto Salas
  • [scan] fix test result parser issue with disable_xcpretty (#16481) via Jean Mainguy

2.148.1 Improvements for plugin searching - 2020-05-18 21:28:55

  • [fastlane] fix searching for plugins where the name contains “action” in it (#16470) via Josh Holtz

2.148.0 Improvements - 2020-05-14 14:49:56

  • [deliver] add fix for app_version and build_number matching (#16091) via onurpolattimur
  • [fastlane] load additional .env files from within CLIToolsDistributor (#16096) via Liam Nichols
  • [match] improve match macOS support (#16456) via Davide De Rosa
  • [gym] move AppStoreInfo.plist to build output directory if generated … (#16133) via Ashton Williams
  • [actions] push_to_git_remote - raise an error if get current branch failed (#16141) via Jierong Li
  • [deliver] fix crash when metadata_path is outside of the fastlane path (#16146) via Bruno Virlet
  • [Fastlane.swift] add options to beforeAll (#16220) via Niil Öhlin
  • [supply] added in_app_update_priority option to set the InAppUpdatePriority … (#16452) via jomisj
  • [Ruby 2.7] fix deprecated warnings (#16409) via Jakub Kašpar
  • [snapshot] fix warning in SnapshotHelper.swift (#16244) via Cédric Luthi
  • [sigh][match] add :fail_on_name_taken in sigh, use in match (#16281) via Michal Laskowski
  • [snapshot] erase simulator only when erase_simulator is true (#16299) via Theodore Gonzalez
  • [spaceship][pilot] expire TestFlight Builds (#16332) via Steven Sherry
  • [gym] add info on passing plist into export_options on gym (#16345) via Bahadır Öncel
  • [doc][crashlytics] remove duplicated deprecation message (#16363) via JAEHYUN OH
  • [scan] add only_test_configurations and skip_test_configurations options for use with test plans (#16367) via Rob Nadin
  • [snapshot] add -only-testing and -skip-testing options from scan (#16312) via Jean Mainguy
  • [screengrab] adding locales in all the paths where screenshots could be saved (#16370) via Nicolas Brosy
  • [action] upload_symbols_to_crashlytics include Path Suggested by Carthage Instructions (#16401) via Stefan Herold
  • [action] dd missing env_names to swiftlint action (#16445) via Tóth Balázs