Fastlane: Was es ist, Build-Automatisierung und Publishing

Fastlane — Was es ist

Fastlane ist ein Open-Source-Tool, das Routineaufgaben der mobilen Entwicklung automatisiert: App-Erstellung, Testausführung, Screenshot-Erstellung, Zertifikatsverwaltung und das Hochladen von Builds in TestFlight, App Store und Google Play. Fastlane ist in Ruby geschrieben und wird über RubyGems mit dem Befehl gem install fastlane vertrieben.

Fastlane erschien 2015 als iOS-Tool, erweiterte sich aber schnell auf Android. Heute ist es ein Ökosystem aus Dutzenden von Aktionen — integrierten Befehlen, die zu Szenarien namens Lanes kombiniert werden können. Jede Lane führt eine bestimmte Aufgabe aus: build_release erstellt beispielsweise die Release-Version, während deploy_beta den Build in TestFlight hochlädt.

Fastlane wird von Unternehmen wie Uber, Airbnb, Snapchat, Twitter und Shopify verwendet. Laut einer Umfrage von 2024 nutzen über 60 % der iOS-Entwickler Fastlane in ihren Projekten. Das Tool unterstützt sowohl die lokale Ausführung als auch die Integration in Cloud-CI-Systeme und ist damit der De-facto-Standard für mobiles CI/CD.

# Fastlane installieren
sudo gem install fastlane -NV

# Initialisierung im Projekt
fastlane init

Nach der Initialisierung erstellt Fastlane ein fastlane/-Verzeichnis mit drei Dateien: Fastfile (Szenarien), Appfile (App-Einstellungen) und Matchfile (Zertifikatseinstellungen). Diese Struktur bleibt für beide Plattformen — iOS und Android — gleich.

Fastfile und Lanes

Die Hauptkonfigurationsdatei von Fastlane ist das Fastfile. Es befindet sich im fastlane/-Verzeichnis im Projektstamm. Das Fastfile wird in Ruby geschrieben: Jede Lane ist ein benannter Block mit einer Sequenz von Aktionen. Eine Lane kann Parameter akzeptieren, andere Lanes aufrufen und Werte zurückgeben.

# fastlane/Fastfile — Beispiel für 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

Jede Lane wird mit dem Befehl fastlane ios beta oder fastlane ios release ausgeführt. Das Fastfile unterstützt Variablen, Bedingungen, Schleifen und externe Skriptaufrufe — es ist eine vollwertige Ruby-Datei. Entwickler können Code über private_lane (lokale Methoden) und import aus anderen Fastfiles wiederverwenden.

Fastlane bietet über 200 integrierte Aktionen für die meisten Aufgaben. Falls die benötigte Aktion nicht existiert, kann man eine eigene in Ruby schreiben oder einen Shell-Befehl mit sh("...") aufrufen. Aktionen können Parameter akzeptieren — Buildeinstellungen, Pfade, Zugriffstoken — und Ergebnisse für nachfolgende Schritte zurückgeben.

iOS-Build-Automatisierung

Fastlane für iOS löst drei Hauptprobleme: Verwaltung von Zertifikaten und Provisioning-Profilen, IPA-Erstellung über Xcode und Veröffentlichung in App Store Connect und TestFlight. Jede dieser Aufgaben wird durch eine eigene Aktion abgedeckt.

match ist eine Aktion zur Zertifikatsverwaltung. Es speichert alle Zertifikate und Provisioning-Profile in einem verschlüsselten Git-Repository. Jeder Entwickler und CI-Server verwendet denselben Dateisatz, was Konflikte und Probleme mit abgelaufenen Zertifikaten vermeidet. Match aktualisiert Profile automatisch, wenn neue Geräte hinzugefügt werden.

sigh erstellt und lädt ein Provisioning-Profil über das Apple Developer Portal herunter. Es wird verwendet, wenn schnell ein Profil für einen bestimmten Typ benötigt wird: Development, Ad-hoc oder App Store.

gym erstellt die IPA. Gym umschließt xcodebuild mit optimalen Parametern, wählt automatisch Schema, Konfiguration und Exportoptionen aus und erstellt eine signierte IPA. Beispiel: gym(scheme: "MyApp", export_method: "app-store").

pilot verwaltet TestFlight. Es lädt den Build hoch, fügt Tester hinzu und verfolgt den Überprüfungsstatus. deliver übernimmt die vollständige App Store-Veröffentlichung, einschließlich Metadaten, Screenshots, Preise und Versionierung.

# iOS-App erstellen und veröffentlichen
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

Für die Arbeit mit App Store Connect sind Zugriffstoken erforderlich. Fastlane unterstützt zwei Authentifizierungsmethoden: App Store Connect API Key (empfohlen) und Apple ID mit Zwei-Faktor-Authentifizierung. API-Schlüssel sind für CI/CD praktischer, da sie keine interaktive Passworteingabe erfordern.

Android-Build-Automatisierung

Unter Android automatisiert Fastlane den Build über Gradle, die Signierung von APK und AAB, das Hochladen in die Google Play Console und Firebase App Distribution.

gradle ist die Hauptaktion für Android-Builds. Sie ruft den Gradle-Wrapper mit den erforderlichen Aufgaben auf: gradle(task: "assembleRelease") oder gradle(task: "bundleRelease") für AAB. Sie können Flags, Umgebungsvariablen und den Pfad zu gradle.properties übergeben.

supply lädt APK oder AAB in die Google Play Console hoch. Supply verwaltet Versionen, Tracks (internal, alpha, beta, production), Release Notes, Preise und Länderverteilung. Beispiel: supply(track: "beta", release_status: "completed").

screengrab erstellt Screenshots für Google Play. Es führt Instrumentierungstests aus, die Screenshots der App auf verschiedenen Geräten und Sprachen erfassen. Die resultierenden Screenshots werden über supply hochgeladen.

# Android-App erstellen und veröffentlichen
lane :deploy_android do
  gradle(task: "clean bundleRelease")
  supply(
    track: "beta",
    release_status: "completed",
    version_code: 42
  )
end

CI/CD-Integration

Fastlane ist für den Einsatz in CI/CD-Pipelines konzipiert. Es verarbeitet den nicht-interaktiven Modus, Umgebungsvariablen und Build-Artefakte korrekt. Nachfolgend finden Sie Integrationsbeispiele mit gängigen CI-Systemen.

In GitHub Actions wird Fastlane als Ruby-Skript ausgeführt. Ein typischer Workflow: Ruby und Fastlane installieren, Schlüssel konfigurieren (Zertifikate, API-Token über Secrets), Lane ausführen. iOS benötigt einen macOS-Runner; Android funktioniert auf ubuntu-latest.

In GitLab CI wird Fastlane in .gitlab-ci.yml mit ähnlicher Einrichtung verwendet: Abhängigkeiten installieren, fastlane ausführen, Artefakte übergeben. GitLab CI unterstützt macOS- und Linux-Runner.

Bitrise — eine spezialisierte CI/CD-Plattform für mobile Apps — hat integrierte Fastlane-Unterstützung. Bitrise Workflow kann den Fastlane Step aufrufen oder benutzerdefinierte Skripte mit fastlane ausführen. Bitrise verwaltet Zertifikate über seinen Code-Signing-Manager.

# Fastfile für CI/CD mit bedingter Testausführung
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

Ein wichtiger Aspekt der CI/CD-Integration ist die Speicherung von Geheimnissen. Fastlane verwendet die .env-Datei über Dotenv und Umgebungsvariablen. Für iOS sind kritische Variablen: MATCH_PASSWORD, FASTLANE_APPLE_API_KEY, FASTLANE_APPLE_API_KEY_ID. Für Android: SUPPLY_JSON_KEY_DATA — der Inhalt des Google Play-Dienstkontos.

Beliebte Fastlane-Aktionen

Fastlane enthält über 200 integrierte Aktionen. Nachfolgend finden Sie eine Übersicht der beliebtesten mit Plattform und Beschreibung.

Um die gewünschte Aktion zu finden, verwenden Sie den Befehl fastlane action [Name], der Dokumentation, Parameter und Beispiele anzeigt. Die vollständige Liste ist lokal verfügbar: fastlane actions.

Fastlane unterstützt auch Plugins — Community-Erweiterungen, die neue Aktionen hinzufügen. Plugins werden über fastlane add_plugin [Name] installiert und sind in der RubyGems-Registry verfügbar. Beispiele für beliebte Plugins: fastlane-plugin-versioning (Versionsverwaltung), fastlane-plugin-sentry (Debug-Symbole zu Sentry hochladen), fastlane-plugin-teams (Benachrichtigungen in Microsoft Teams).