Skip to content

README.md

Latest commit

 

History

History
72 lines (60 loc) · 3.15 KB

README.md

File metadata and controls

72 lines (60 loc) · 3.15 KB

Fastlane documentation

We use Fastlane for automating the iOS application build and submission

Installation

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

xcode-select --install

Install fastlane using

[sudo] gem install fastlane -NV

or alternatively using brew cask install fastlane

Project setup

  1. Generate certificate and profiles for each target
  2. Disable automatic signing for each target in XCode and associate to the right provisioning profile
  3. For uploading the builds to TestFlight, AppStore Connect API keys are required
  4. For uploading the builds to S3, AWS keys with valid permissions are required

Required environment variables

  • FASTLANE_USER : Your App Store Connect / Apple Developer Portal id used for managing certificates and submitting to the App Store
  • FASTLANE_PASSWORD : Your App Store Connect / Apple Developer Portal password, usually only needed if you also set the
  • FASTLANE_TEAM_ID : Developer Portal team id
  • LANG and LC_ALL : These set up the locale your shell and all the commands you execute run at. These need to be set to UTF-8 to work correctly,for example en_US.UTF-8
  • APPLE_CERT : Local path to distribution certificate file to be used for signing the build
  • APPLE_KEY : Private key (.p12 file) used for encrypting certificate
  • APPLE_KEY_PASSWORD : Password to private key file
  • APP_STORE_CONNECT_API_KEY_KEY_ID : AppStore Connect API ID
  • APP_STORE_CONNECT_API_KEY_ISSUER_ID : AppStore Connect issuer ID
  • APP_STORE_CONNECT_API_KEY_FILE : location of .p8 API key file
  • AWS_ACCESS_KEY_ID : credentials for uploading files to S3
  • AWS_SECRET_ACCESS_KEY
  • AWS_REGION
  • BUILDS_BUCKET : S3 bucket to upload the build to
  • SLACK_CHANNEL : Slack webhook url for sending notifications upon completion
  • SLACK_URL : Slack channel name

Available Actions

build_*

  • Runs pod install
  • If needed downloads and installs the corresponding distribution certificate and profile
  • Builds and archive corresponding target (.ipa file is kept locally)
fastlane build_develop

share_*

  • Runs the build steps for the corresponding target
  • Gathers build version
  • Uploads the resulting .ipa to S3
  • Sends a Slack notification
fastlane share_develop

release_*

  • Checks for the Git status
  • Runs the build steps for the corresponding target
  • Generates changelog
  • Pushes the resulting .ipa to TestFlight
  • Sends a Slack notification
fastlane release_develop