Fastlane — cos'è, strumenti e automazione del build di app mobili

Cos’è Fastlane e come automatizza i build mobili

Fastlane è uno strumento di automazione dei build mobili, scritto in Ruby e distribuito sotto licenza MIT. Automatizza le attività di routine dello sviluppatore mobile: build dell’app, esecuzione dei test, creazione di screenshot, firma del codice e caricamento dei binari nell’App Store o Google Play. Invece di 15–20 comandi manuali, lo sviluppatore esegue un unico comando fastlane con il nome dello scenario.

Fastlane funge da wrapper per gli utility di Xcode (xcodebuild, xcrun) e Android SDK (gradlew, apksigner, bundletool), fornendo un’interfaccia unificata per entrambe le piattaforme. Ciò è particolarmente prezioso per i team che mantengono versioni iOS e Android della stessa app — Fastfile identici possono descrivere build per entrambe le piattaforme con differenze minime nei parametri.

Secondo GitHub, Fastlane ha oltre 39.000 stelle ed è lo standard di automazione nello sviluppo mobile. Lo strumento è mantenuto dalla comunità e da Google — Fastlane è integrato in Firebase come metodo consigliato per distribuire app Android a Google Play Console.

Architettura di Fastlane: Actions, Lanes e strumenti

L’architettura di Fastlane si basa su tre livelli: actions (comandi di base), lanes (scenari) e strumenti (utility specializzate). Le actions sono funzioni individuali di Fastlane, ciascuna delle quali esegue un’azione specifica: creare uno screenshot, compilare IPA, caricare in TestFlight. Le lanes combinano più actions in uno scenario sequenziale descritto nel Fastfile.

Fastlane Actions

Actions sono i mattoni di Fastlane. Ogni action accetta parametri ed esegue un singolo compito. Ad esempio, l’action gym compila l’app iOS, scan esegue i test, pilot carica il build in TestFlight. Fastlane ha oltre 200 actions integrate, con documentazione per ciascuna accessibile tramite il comando fastlane action [nome].

Se le actions integrate non sono sufficienti, lo sviluppatore può creare una custom action in Ruby e collegarla nel Fastfile. Le custom action vengono distribuite tramite plugin Fastlane, pubblicati su Rubygems e installati tramite il file FastfilePlugin nella radice del progetto.

Lanes e loro composizione

Lane è uno scenario di automazione nominato che combina più actions in una sequenza logica. Una lane può chiamare altre lanes (private lanes), passare parametri e gestire errori. Ciò consente di costruire una gerarchia di scenari: lane di build base, lane di deploy, lane di ciclo CI/CD completo.

Principali strumenti Fastlane: scan, gym, match, deliver

Fastlane include una serie di strumenti specializzati, ciascuno dei quali risolve un compito specifico di automazione mobile. Gli strumenti vengono eseguiti come actions all’interno delle lanes o direttamente dalla riga di comando. Esaminiamo quattro strumenti chiave che coprono le principali esigenze CI/CD per iOS e Android.

Scan semplifica l’esecuzione dei test Xcode, selezionando automaticamente il simulatore appropriato e formattando il report. Gym compila l’app con flag di compilazione ottimali e supporta exportOptions.plist per diversi tipi di build (development, adhoc, appstore). Deliver consente di caricare non solo il binario, ma anche screenshot, descrizione, versioni e prezzi tramite un unico file di metadati.

Lo strumento Match merita un’attenzione particolare — risolve il problema di archiviazione e sincronizzazione dei certificati iOS in team. Match crittografa e memorizza certificati e profili di provisioning in un repository Git, e gli sviluppatori li ottengono automaticamente eseguendo fastlane match. Ciò elimina la configurazione manuale di ogni postazione di lavoro.

Snapshot: generazione di screenshot

Snapshot è uno strumento per la creazione automatica di screenshot di app mobili su diversi dispositivi e lingue. Snapshot esegue test UI su simulatori iOS, catturando lo schermo a ogni passo del test. I risultati vengono salvati nella directory fastlane/screenshots e possono essere caricati in App Store Connect tramite deliver.

Per Android, screengrab svolge una funzione simile sugli emulatori Android. Entrambi gli strumenti supportano la localizzazione — gli screenshot vengono creati per ogni lingua, semplificando la preparazione dei materiali per la pubblicazione in store di app multilingue.

Configurazione di Fastlane per app iOS

Per i progetti iOS, Fastlane viene configurato tramite il Gemfile (installazione della gem fastlane) e il Fastfile nella directory fastlane. La configurazione iniziale viene eseguita con il comando fastlane init, che crea la struttura di directory di base, richiede i dati di App Store Connect e genera un modello di Fastfile con le lanes principali.

Il comando chiave per iOS è fastlane match, che deve essere eseguito per primo per ottenere certificati e profili di provisioning. Dopo una firma riuscita, Fastlane può compilare l’app (gym), eseguire i test (scan) e caricare il binario (pilot o deliver).

# Fastfile per app iOS
default_platform(:ios)

lane :build do
  cocoapods
  scan(scheme: 'App', devices: ['iPhone 15'])
  gym(scheme: 'App', export_method: 'app-store')
end

lane :deploy do
  match(type: 'appstore')
  build
  pilot(skip_waiting_for_build_processing: true)
  slack(message: 'Nuova versione caricata in TestFlight')
end

Per lavorare con TestFlight, utilizza l’action pilot — carica l’IPA e gestisce i tester. Fastlane supporta upload_to_testflight (sinonimo di pilot) e gestisce automaticamente l’attesa dell’elaborazione del build da parte di Apple, che può richiedere da 5 a 30 minuti.

Configurazione di Fastlane per app Android

Per i progetti Android, Fastlane viene configurato in modo simile, ma invece degli strumenti Xcode vengono utilizzati Gradle e Android SDK. Fastlane per Android supporta la compilazione di APK e AAB, la firma tramite apksigner o jarsigner, l’esecuzione di test strumentali e il caricamento in Google Play Console tramite l’action Supply.

La differenza principale è che il build Android non richiede la gestione dei certificati tramite match (la firma Android è gestita tramite Keystore, archiviato separatamente). Fastlane per Android utilizza l’action gradle per eseguire qualsiasi attività Gradle e l’action supply per lavorare con Google Play.

# Fastfile per app Android
default_platform(:android)

lane :build do
  gradle(task: 'clean assembleRelease')
  gradle(task: 'testReleaseUnitTest')
end

lane :deploy do
  build
  supply(
    track: 'internal',
    aab: 'app/build/outputs/bundle/release/app-release.aab'
  )
end

Per lavorare con Google Play Console, è necessario un account di servizio Google Cloud con accesso all’API Google Play. Fastlane accetta la chiave JSON dell’account di servizio tramite la variabile d’ambiente SUPPLY_JSON_KEY o il parametro json_key nell’action supply. Il track di pubblicazione può essere internal, alpha, beta o production.

Integrazione di Fastlane con sistemi CI/CD

Fastlane si integra con qualsiasi sistema CI/CD in grado di eseguire script Ruby: Jenkins, Travis CI, GitHub Actions, GitLab CI, Bitrise e CircleCI. L’integrazione si riduce all’installazione della gem fastlane e all’esecuzione del comando fastlane [lane_name] nella fase script della pipeline.

Per CI/CD, è importante configurare variabili d’ambiente per memorizzare dati sensibili: MATCH_PASSWORD (password di crittografia dei certificati), FASTLANE_USER (Apple ID), FASTLANE_PASSWORD (password Apple ID). In Travis CI, le variabili vengono crittografate tramite travis encrypt; in GitHub Actions, tramite i Secrets del repository.

La pratica consigliata è utilizzare fastlane match in CI/CD con il flag readonly per evitare modifiche accidentali al repository dei certificati. Per Android, utilizza il Keystore codificato in Base64 e salvato in una variabile d’ambiente, che viene decodificato e salvato in un file temporaneo nella fase before_install.

Fastlane Match: gestione dei certificati e profili

Fastlane Match è uno strumento per automatizzare la gestione dei certificati iOS e dei profili di provisioning, una delle funzionalità più preziose di Fastlane per i team. Match crea un repository Git crittografato (o ne utilizza uno esistente) dove memorizza tutti i certificati e i profili, sincronizzandoli tra sviluppatori e server CI/CD.

Match supporta cinque tipi di profili: development, adhoc, appstore, enterprise e developer_id. Ogni tipo viene memorizzato in una directory separata all’interno del repository. Il comando fastlane match development installa i certificati di sviluppo sulla macchina locale, mentre fastlane match appstore installa i profili App Store per i build CI.

# Utilizzo di Match in Fastfile
lane :setup_signing do
  match(
    type: 'appstore',
    readonly: true,
    git_branch: 'main'
  )
end

lane :update_profiles do
  match(
    type: 'development',
    force: true,
    app_identifier: ['com.example.app', 'com.example.app.watchkitapp']
  )
end

La sicurezza di Match è garantita dalla crittografia di tutti i file prima del commit in Git. La password di crittografia viene impostata tramite la variabile d’ambiente MATCH_PASSWORD e deve essere uguale per tutti i membri del team. Match utilizza OpenSSL per la crittografia e non memorizza la password in chiaro nel repository.