Fastlane: wat is het, automatisering van builds en publicaties

Fastlane — wat is het

Fastlane — is een open-source tool die routinetaken in mobiele ontwikkeling automatiseert: het builden van de app, het uitvoeren van tests, het maken van screenshots, het beheren van certificaten, het uploaden van builds naar TestFlight, App Store en Google Play. Fastlane is geschreven in Ruby en wordt verspreid via RubyGems met het commando gem install fastlane.

Fastlane verscheen in 2015 als iOS-tool, maar breidde zich snel uit naar Android. Tegenwoordig is het een ecosysteem van tientallen actions — ingebouwde commando's die kunnen worden gecombineerd in scenario's, lanes genoemd. Elke lane voert een specifieke taak uit: bijvoorbeeld build_release bouwt de releaseversie en deploy_beta uploadt de build naar TestFlight.

Fastlane wordt gebruikt door bedrijven zoals Uber, Airbnb, Snapchat, Twitter en Shopify. Volgens een enquête uit 2024 gebruikt meer dan 60% van de iOS-ontwikkelaars Fastlane in hun projecten. De tool ondersteunt zowel lokale uitvoering als integratie met cloud CI-systemen, wat het de de facto standaard maakt voor mobiele CI/CD.

# Installatie van Fastlane
sudo gem install fastlane -NV

# Initialisatie in het project
fastlane init

Na initialisatie maakt Fastlane de map fastlane/ aan met drie bestanden: Fastfile (scenario's), Appfile (app-instellingen) en Matchfile (certificaatinstellingen). Deze structuur blijft hetzelfde voor beide platforms — iOS en Android.

Fastfile en lanes

Het belangrijkste configuratiebestand van Fastlane — Fastfile. Het bevindt zich in de map fastlane/ in de root van het project. Fastfile wordt geschreven in Ruby: elke lane is een benoemd blok met een reeks actions. Een lane kan parameters accepteren, andere lanes aanroepen en waarden retourneren.

# fastlane/Fastfile — voorbeeld voor iOS
default_platform(:ios)

platform :ios do
  desc "Build and upload to TestFlight"
  lane :beta do
    match(type: "appstore")
    gym(scheme: "MyApp", configuration: "Release")
    pilot(skip_waiting_for_build: true)
  end

  desc "Deploy to App Store"
  lane :release do
    ensure_git_status_clean
    match(type: "appstore")
    gym(scheme: "MyApp")
    deliver(
      skip_metadata: true,
      skip_screenshots: true
    )
    push_to_git_remote(tags: true)
  end
end

Elke lane wordt gestart met het commando fastlane ios beta of fastlane ios release. Fastfile ondersteunt variabelen, condities, loops en het aanroepen van externe scripts — het is een volwaardig Ruby-bestand. Ontwikkelaars kunnen code hergebruiken via private_lane (lokale methoden) en import uit andere Fastfile-bestanden.

Fastlane biedt meer dan 200 ingebouwde actions voor de meeste taken. Als de benodigde action niet bestaat, kan men een eigen action in Ruby schrijven of een shell-commando aanroepen via sh("..."). Actions kunnen parameters accepteren — buildinstellingen, paden, toegangstokens — en het resultaat retourneren voor gebruik in volgende stappen.

Automatisering van iOS-builds

Fastlane voor iOS lost drie belangrijke problemen op: het beheer van certificaten en provisioning profiles, het builden van IPA via Xcode en publicatie naar App Store Connect en TestFlight. Elk van deze taken wordt afgedekt door een aparte action.

match — action voor certificaatbeheer. Het slaat alle certificaten en provisioning profiles op in een versleutelde Git-repository. Elke ontwikkelaar en CI-server gebruiken dezelfde set bestanden, wat conflicten en problemen met verlopen certificaten elimineert. Match werkt profielen automatisch bij wanneer nieuwe apparaten worden toegevoegd.

sigh — maakt en downloadt een provisioning profile via de Apple Developer Portal. Wordt gebruikt wanneer snel een profiel nodig is voor een specifiek type: development, ad-hoc of appstore.

gym — builden van IPA. Gym omhult xcodebuild met optimale parameters, selecteert automatisch het schema, de configuratie, export options en maakt een ondertekende IPA. Voorbeeld: gym(scheme: "MyApp", export_method: "app-store").

pilot — beheer van TestFlight. Uploadt de build, voegt testers toe, volgt de reviewstatus. deliver — volledige publicatie in de App Store, inclusief metadata, screenshots, prijs en versies.

# Builden en publiceren van iOS-app
lane :deploy_ios do
  cocoapods
  match(type: "appstore", readonly: true)
  gym(scheme: "MyApp", export_method: "app-store")
  pilot(changelog: "Bug fixes and performance improvements")
end

Voor het werken met App Store Connect zijn toegangstokens vereist. Fastlane ondersteunt twee authenticatiemethoden: App Store Connect API Key (aanbevolen) en Apple ID met tweefactorauthenticatie. API-sleutels zijn handiger voor CI/CD omdat ze geen interactieve wachtwoordinvoer vereisen.

Automatisering van Android-builds

Op Android automatiseert Fastlane het builden via Gradle, het ondertekenen van APK en AAB, het uploaden naar Google Play Console en Firebase App Distribution.

gradle — de belangrijkste action voor Android-builden. Het roept de Gradle wrapper aan met de benodigde taken: gradle(task: "assembleRelease") of gradle(task: "bundleRelease") voor AAB. Vlaggen, omgevingsvariabelen en het pad naar gradle.properties kunnen worden doorgegeven.

supply — uploaden van APK of AAB naar Google Play Console. Supply beheert versies, tracks (internal, alpha, beta, production), releasenotes, prijs en distributieland. Voorbeeld: supply(track: "beta", release_status: "completed").

screengrab — het maken van screenshots voor Google Play. Het voert instrumentatietests uit die screenshots maken van app-schermen op verschillende apparaten en talen. De verkregen screenshots worden geüpload via supply.

# Builden en publiceren van Android-app
lane :deploy_android do
  gradle(task: "clean bundleRelease")
  supply(
    track: "beta",
    release_status: "completed",
    version_code: 42
  )
end

Integratie met CI/CD

Fastlane is ontworpen voor gebruik in CI/CD-pipelines. Het verwerkt non-interactieve modus, omgevingsvariabelen en build-artefacten correct. Hieronder — voorbeelden van integratie met populaire CI-systemen.

In GitHub Actions wordt Fastlane uitgevoerd als een Ruby-script. Typische workflow: installatie van Ruby en Fastlane, configuratie van sleutels (certificaten, API-tokens via secrets), uitvoeren van lane. Voor iOS is een macOS-runner vereist; Android werkt op ubuntu-latest.

In GitLab CI wordt Fastlane gebruikt in .gitlab-ci.yml met een vergelijkbaar schema: installatie van dependencies, uitvoeren van fastlane, overdracht van artefacten. GitLab CI ondersteunt macOS- en Linux-runners.

Bitrise — gespecialiseerde CI/CD voor mobiele apps — heeft ingebouwde ondersteuning voor Fastlane. Bitrise Workflow kan Fastlane Step aanroepen of willekeurige scripts uitvoeren met fastlane. Bitrise beheert certificaten via zijn eigen Code Signing Manager.

# Fastfile voor CI/CD met voorwaardelijk uitvoeren van tests
lane :ci_test do
  scan(scheme: "MyApp", code_coverage: true)
end

lane :ci_beta do
  ensure_git_status_clean
  version_bump_podspec(path: "MyApp.podspec")
  match(type: "appstore", readonly: true)
  gym(scheme: "MyApp", export_method: "app-store")
  pilot(distribute_external: true)
end

Een belangrijk aspect van CI/CD-integratie — het opslaan van geheimen. Fastlane gebruikt het .env-bestand via dotenv en omgevingsvariabelen. Voor iOS zijn kritieke variabelen: MATCH_PASSWORD, FASTLANE_APPLE_API_KEY, FASTLANE_APPLE_API_KEY_ID. Voor Android: SUPPLY_JSON_KEY_DATA — de inhoud van het Google Play-serviceaccount.

Populaire Fastlane-actions

Fastlane bevat meer dan 200 ingebouwde actions. Hieronder — een overzicht van de meest populaire met vermelding van platform en doel.

Voor het zoeken van een benodigde action wordt het commando fastlane action [naam] gebruikt, dat documentatie, parameters en voorbeelden toont. De volledige lijst is lokaal beschikbaar: fastlane actions.

Fastlane ondersteunt ook plugins — community-extensies die nieuwe actions toevoegen. Plugins worden geïnstalleerd via fastlane add_plugin [naam] en zijn beschikbaar in de RubyGems-registry. Voorbeelden van populaire plugins: fastlane-plugin-versioning (versiebeheer), fastlane-plugin-sentry (debug-symbolen uploaden naar Sentry), fastlane-plugin-teams (meldingen in Microsoft Teams).