fastlane / examples

📝 A collection of example fastlane setups

fastlane Example Setups

This repository contains a few fastlane example setups that help you getting started.

Acast

🎶 Simple setup, saving tons of time

• Slack notifications on failed builds or unsuccessful tests
  • Slack notifications are only fired if they're run on our CI
• Managed provisioning profiles using match
• Creation of screenshots using snapshot
  • Text and device frames are added to screenshots using frameit
  • Delivered to iTunes Connect using deliver
• Submission to App Store using gym and deliver

Overview • Fastfile • Appfile • Deliverfile • Gymfile • Matchfile • Scanfile • Snapfile • Framefile

---

Fitbay

👚 Full stack deployment

• Crashlytics, TestFlight, and App Store distribution
• Automatic build environment selection
• Managing of Provisioning Profiles
• Slack Team notifications
• Version number bump and Git commit
• Custom scripts
• Lane switching with private lanes

Overview • Fastfile

---

Fabric app

👚 Standard Setup

• Deploy updates through Crashlytics Beta
• Submit to the AppStore with screenshots and metadata
• Code generation for xib names, identifiers, etc using R.swift

Overview • Fastfile • Snapfile • Appfile

---

Artsy eidolon

💚 Standard Setup

• Building and Signing of the iOS App
• Version Bump & Git Actions
• Hockey Distribution
• Production Keys

Overview • Fastfile

---

Wikipedia by Wikimedia Foundation

📗 Advanced - Multiple Environments

• Different Bundle Identifiers per lane
• Advanced Testing
• Hockey Deployment
• App Store and TestFlight Deployment
• Custom fastlane actions like automatic change-logs based on git

Overview • Fastfile • Deliverfile • Appfile • Metadata

---

SoundCloud

🎵 Standard Setup

• Deployment to iTunes Connect
• Building acceptance tests builds with Frank
• Managing Certificates/Provisioning Profiles
• CI steps as lanes
• Project setup

Overview • Fastfile

---

MindNode

💻 Advanced iOS/Mac Setup

• Mac and iOS Universal App
• App Store and TestFlight Deployment
• Automated Screenshots
• Screenshot Framing & Adding of Titles
• Copying of example data for screenshots
• Custom xcodebuild command

Overview • Fastfile • Snapfile • MindNode.js • screenshots • Framefile.json • MacScreenshots

---

Product Hunt

📈 Standard Setup

• App Store and TestFlight Deployment
• Managing of Provisioning Profiles
• Push Notifications
• Version Bump & Git Actions

Overview • Fastfile • Deliverfile • metadata

---

Be My Eyes

👀 Standard Setup

• App Store and TestFlight Distribution
• Local action get_global_value
• Version Bump & Git Actions

Overview • Fastfile • Deliverfile • get_global_value

---

SunApps

🔧 App Factory

• Maintain and Deploy hundreds of Apps
• Automatically create new Apps
• Create profiles and push certificates
• Screenshots
• Remote configuration of Fastfile and snapshot scripts

A description on how the setup works is available in the Overview.

Overview • Fastfile • Deliverfile • Snapfile • Appfile • snapshot.js

---

Touchwonders

🚲 Shared Fastfile for multiple projects

• Maintain and Deploy multiple of Apps and Projects
• Import external Fastfile from external repo
• Load fastlane configuration YAML file
• Create/Renew/Download profiles for multiple targets
• Custom load_release_notes action

A description on how the setup works is available in the Overview.

Overview • Fastfile • Configuration file

---

QuizUp

⚡ Advanced - Multiple Environments

• Deployment to iTunes Connect
• Deployment to Hockey App
• Running unit tests
• Linting with Swiftlint
• Managing Certificates/Provisioning Profiles
• CI steps as lanes
• Project setup
• Version Bump & Git Actions
• Slack Notifications
• Custom action for internal translation tools
• Custom action for versioning
• Custom action for selecting changelogs

Overview • Fastfile

---

fastlane

🚀 Creative Uses

• Deploying fastlane updates using fastlane (so meta)
• Lane Switching
• Network Requests
• Custom Commands
• Get GitHub Release

Overview • Fastfile

---

SHOP·COM

‼️ Dual Platfrom Fastfile, Cordova project

• Configuration for both iOS and Android in the same Fastfile
• Saves archives to a common build folder, sorted by date
• Handles provisioning in a separate lane
• Includes working configuration for building both iOS and Android native projects
• Has configuration for CI (Jenkins) to auto release to Hockeyapp, and auto unlock the keychain

Overview • Fastfile

---

Zattoo

📺 Setup for tvOS

• App Store and Testflight deployments
• Certificates and Provisioning Profiles management
• Provision of Localizable strings
• Deployment of Preview and Promotional releases
• Unit and UI testing lanes for Travis
• Linter

Overview • Fastfile

---

Code of Conduct

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

examples's Issues

Include recommended gitignore

(Because fastlane-example is deprecated, I have updated this issue.)

I am requesting a recommended gitignore to use with fastlane. I have just gotten fastlane set up in my project and am ready to git commit. There is a lot of ugliness in git status including:

/fastlane/report.xml -- temporary fastlane profiling data
/fastlane/Error*.png -- temporary `deliver` error output
/fastlane/Preview.html -- temporary `deliver` preview output
/fastlane/screenshots/*/*-portrait.png -- generated screenshots
/fastlane/screenshots/*/*-landscape.png -- generated screenshots
/fastlane/screenshots/*/*-portrait_framed.png -- generated screenshots, framed
/fastlane/screenshots/*/*-landscape_framed.png -- generated screenshots, framed
/fastlane/screenshots/screenshots.html -- generated screenshot index

I am adding these all to my .gitignore, but it would be preferred if fastlane would have a baseline gitignore posted here or on https://github.com/KrauseFx/fastlane

Because users will need to paste this into .gitignore themselves, it would be reasonable that they will understand what is going on, and update the file, if they start changing default values which cause these above items to be inaccurate.

The Fastlane Fastfile link is broken

https://github.com/KrauseFx/fastlane/blob/master/fastlane/Fastfile

:)

Wikipedia Fastfile

get_beta_build_number isn't a lane.

Is this supposed to be get_build_number?

get_build_number from project fails if not only digits

I tried to use get_build_number(xcodeproj: "test.xcodeproj") where the build number contains also letter e.g TE102.
The letters let me know the environment.
The lane failed with the error "agvtool what-version -terse' was 6 instead of 0. (RuntimeError)"

uploading to itunesconnect an app preview video with fsatfile

Fust like the screenshots... but a short video.
Is it possible?

Any project sample available for android ?

Searching for sample project in android. If there is one , pls point to me thanks :-)

Issue while submitting to store

[04:17:13]: [Transporter]: INFO: The package: /tmp/1084529916.itmsp has been successfully uploaded.
04:17:14: iTunes Transporter successfully finished its job
04:17:14: [Transporter]: DBG-X: Returning 0

04:17:14: Successfully uploaded package to iTunes Connect. It might take a few minutes until it's visible online.

04:17:14: Finished the upload to iTunes Connect
[04:17:15]: Selecting the latest build...
[04:17:16]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:17:48]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:18:20]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:18:51]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:19:22]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:19:54]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:20:26]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:20:57]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:21:29]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:22:01]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:22:32]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:22:32]:
[04:22:32]: You can tweet: "iTunes Connect #iosprocessingtime 5 minutes"
[04:23:04]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:23:04]:
[04:23:04]: You can tweet: "iTunes Connect #iosprocessingtime 6 minutes"
[04:23:35]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:23:35]:
[04:23:35]: You can tweet: "iTunes Connect #iosprocessingtime 6 minutes"
[04:24:16]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:24:16]:
[04:24:16]: You can tweet: "iTunes Connect #iosprocessingtime 7 minutes"
[04:24:48]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:24:48]:
[04:24:48]: You can tweet: "iTunes Connect #iosprocessingtime 8 minutes"
[04:25:23]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:25:23]:
[04:25:23]: You can tweet: "iTunes Connect #iosprocessingtime 8 minutes"
[04:25:55]: Waiting iTunes Connect processing for build 1.0 (1.0)... this might take a while...
[04:25:55]:
[04:25:55]: You can tweet: "iTunes Connect #iosprocessingtime 9 minutes"
[04:26:27]: Selecting build 1.0 (1.0)...
[04:26:28]: Successfully selected build
[04:26:28]: Submitting the app for review...
[04:26:31]: Variable Dump:
[04:26:31]: {:DEFAULT_PLATFORM=>:ios, :PLATFORM_NAME=>:ios, :LANE_NAME=>"ios appstore", :CERT_FILE_PATH=>"/Users/viki/Desktop/fastlane/apps/proapps/platforms/ios/util/V52DKXD3X5.cer", :CERT_CERTIFICATE_ID=>"V52DKXD3X5", :SIGH_PROFILE_PATH=>"/Users/viki/Desktop/fastlane/apps/proapps/platforms/ios/util/AppStore_com.proappslive.proappstest.mobileprovision", :SIGH_PROFILE_PATHS=>["/Users/viki/Desktop/fastlane/apps/proapps/platforms/ios/util/AppStore_com.proappslive.proappstest.mobileprovision"], :SIGH_UDID=>"4c3eb709-c79e-4f84-9049-04eaecd1ee41", :SIGH_PROFILE_TYPE=>"app-store", :IPA_OUTPUT_PATH=>"/Users/viki/Desktop/fastlane/apps/proapps/platforms/ios/util/proapps.ipa", :DSYM_OUTPUT_PATH=>"/Users/viki/Desktop/fastlane/apps/proapps/platforms/ios/util/proapps.app.dSYM.zip", :XCODEBUILD_ARCHIVE=>"/Users/viki/Library/Developer/Xcode/Archives/2016-02-26/proapps 2016-02-26 04.13.27.xcarchive"}
[04:26:31]: Re-validating version produced errors.

+------+-------------------------------------+-------------+
| fastlane summary |
+------+-------------------------------------+-------------+
| Step | Action | Time (in s) |
+------+-------------------------------------+-------------+
| 1 | Verifying required fastlane version | 0 |
| 2 | default_platform | 0 |
| 3 | cert | 4 |
| 4 | sigh | 6 |
| 5 | pem | 1 |
| 6 | update_project_provisioning | 11 |
| 7 | gym | 71 |
| 8 | deliver | 718 |
+------+-------------------------------------+-------------+

[04:26:32]: fastlane finished with errors
Successfully submitted a crash report. If this is a problem with one of the tools specifically,
please submit an issue on GitHub and attach the following number to it: 'baf21134185e391a2e55b74cf9207f9d'
The crash report has been stored locally '/tmp/sentry_baf21134185e391a2e55b74cf9207f9d.json'
/Library/Ruby/Gems/2.0.0/gems/spaceship-0.20.0/lib/spaceship/tunes/tunes_client.rb:207:in handle_itc_response': [!] Re-validating version produced errors. (Spaceship::TunesClient::ITunesConnectError) from /Library/Ruby/Gems/2.0.0/gems/spaceship-0.20.0/lib/spaceship/tunes/tunes_client.rb:683:insend_app_submission'
from /Library/Ruby/Gems/2.0.0/gems/spaceship-0.20.0/lib/spaceship/tunes/app_submission.rb:127:in complete!' from /Library/Ruby/Gems/2.0.0/gems/deliver-1.10.3/lib/deliver/submit_for_review.rb:25:insubmit!'
from /Library/Ruby/Gems/2.0.0/gems/deliver-1.10.3/lib/deliver/runner.rb:87:in submit_for_review' from /Library/Ruby/Gems/2.0.0/gems/deliver-1.10.3/lib/deliver/runner.rb:30:inrun'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/actions/deliver.rb:18:in run' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:143:inblock (2 levels) in execute_action'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/actions/actions_helper.rb:35:in execute_action' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:129:inblock in execute_action'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:128:in chdir' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:128:inexecute_action'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/fast_file.rb:149:in method_missing' from Fastfile:126:inblock (2 levels) in parsing_binding'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/lane.rb:36:in call' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/lane.rb:36:incall'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:52:in block in execute' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:46:inchdir'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/runner.rb:46:in execute' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/lane_manager.rb:46:incruise_lane'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/lib/fastlane/command_line_handler.rb:30:in handle' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/bin/fastlane:38:inblock (2 levels) in run'
from /Library/Ruby/Gems/2.0.0/gems/commander-4.3.5/lib/commander/command.rb:178:in call' from /Library/Ruby/Gems/2.0.0/gems/commander-4.3.5/lib/commander/command.rb:178:incall'
from /Library/Ruby/Gems/2.0.0/gems/commander-4.3.5/lib/commander/command.rb:153:in run' from /Library/Ruby/Gems/2.0.0/gems/commander-4.3.5/lib/commander/runner.rb:428:inrun_active_command'
from /Library/Ruby/Gems/2.0.0/gems/fastlane_core-0.36.8/lib/fastlane_core/ui/fastlane_runner.rb:23:in run!' from /Library/Ruby/Gems/2.0.0/gems/commander-4.3.5/lib/commander/delegates.rb:15:inrun!'
from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/bin/fastlane:156:in run' from /Library/Ruby/Gems/2.0.0/gems/fastlane-1.63.1/bin/fastlane:162:in<top (required)>'
from /usr/local/bin/fastlane:23:in load' from /usr/local/bin/fastlane:23:in

'

Example of 'resign' please!

I would like to see one.

I've got a target with three configurations corresponding to DEVELOPMENT, STAGING and PRODUCTION environments. I've configured three corresponding schemes in Xcode so that I can switch between them.

I actually want to configure Xcode so that the STAGING and PRODUCTION configurations both use the iOS Developer code signing identity. This is so that I can use Xcode to Run the schemes on the local developer machine.

My use case is I want to testing for the correct bundling of Javascript resources for React Native in the same configuration, for instance.

resign comes into play because I want to distribute these builds to TestFlight, and that demands that the code signing identity is iOS Distribution. So if I'm able to build the IPA as normal, and then use resign to supplant in the distribution code signing and provisioning profiles then bob's your uncle :)

How do we use fastlane with fabric without a developers account?

How do we use fastlane with fabric without a developers account? Would love to see a tutorial / documentation on this. Maybe even a video perhaps would work. Thankss!

create ipa

with this tool i need to create ipa first with xcodebuild? or this tool generate spa too? i need to send app on test flight and thank production. thanks

Create Crashlytics beta sharing link

Is there a way to create share link of ipa in Crashlytic Beta after upload? Like we get HOCKEY_DOWNLOAD_LINK as output variable for Hockey App.

Usage Example Updates

Any plans to update these examples with more recent usage patterns?

Asking as we are planning to shift to fastlane.