Fastlane: що це, автоматизація збірок та публікацій

Fastlane — що це

Fastlane — це open-source інструмент, який автоматизує рутинні завдання мобільної розробки: збірку застосунку, запуск тестів, створення скріншотів, керування сертифікатами та вивантаження білдів до TestFlight, App Store та Google Play. Fastlane написаний на Ruby та поширюється через RubyGems командою gem install fastlane.

Fastlane з'явився у 2015 році як iOS-інструмент, але швидко розширився на Android. Сьогодні це екосистема з десятків actions — вбудованих команд, які можна комбінувати в сценарії, звані lanes. Кожен lane виконує конкретне завдання: наприклад, build_release збирає релізну версію, а deploy_beta вивантажує білд у TestFlight.

Fastlane використовують такі компанії, як Uber, Airbnb, Snapchat, Twitter та Shopify. За даними опитування 2024 року, понад 60% iOS-розробників застосовують Fastlane у своїх проєктах. Інструмент підтримує як локальний запуск, так і інтеграцію з хмарними CI-системами, що робить його стандартом де-факто для мобільного CI/CD.

# Встановлення Fastlane
sudo gem install fastlane -NV

# Ініціалізація в проєкті
fastlane init

Після ініціалізації Fastlane створює директорію fastlane/ з трьома файлами: Fastfile (сценарії), Appfile (налаштування застосунку) та Matchfile (налаштування сертифікатів). Ця структура залишається єдиною для обох платформ — iOS та Android.

Fastfile та lanes

Основний конфігураційний файл Fastlane — Fastfile. Він знаходиться в директорії fastlane/ у корені проєкту. Fastfile пишеться на Ruby: кожен lane — це іменований блок із послідовністю actions. Lane може приймати параметри, викликати інші lanes та повертати значення.

# fastlane/Fastfile — приклад для 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

Кожен lane запускається командою fastlane ios beta або fastlane ios release. Fastfile підтримує змінні, умови, цикли та виклик зовнішніх скриптів — це повноцінний Ruby-файл. Розробники можуть перевикористовувати код через private_lane (локальні методи) та import з інших Fastfile.

Fastlane надає понад 200 вбудованих actions для більшості завдань. Якщо потрібного action немає, можна написати власний на Ruby або викликати shell-команду через sh("..."). Actions можуть приймати параметри — налаштування збірки, шляхи, токени доступу — та повертати результат для використання в наступних кроках.

Автоматизація iOS-збірок

Fastlane для iOS вирішує три ключові проблеми: керування сертифікатами та provisioning profiles, збірка IPA через Xcode та публікація до App Store Connect і TestFlight. Кожне з цих завдань покривається окремим action.

match — action для керування сертифікатами. Він зберігає всі сертифікати та provisioning profiles у зашифрованому Git-репозиторії. Кожен розробник та CI-сервер використовують один і той самий набір файлів, що виключає конфлікти та проблеми з простроченими сертифікатами. Match автоматично оновлює профілі при додаванні нових пристроїв.

sigh — створює та завантажує provisioning profile через Apple Developer Portal. Використовується, коли потрібно швидко отримати профіль для конкретного типу: development, ad-hoc або appstore.

gym — збірка IPA. Gym обгортає xcodebuild з оптимальними параметрами, автоматично вибирає схему, конфігурацію, export options та створює підписаний IPA. Приклад: gym(scheme: "MyApp", export_method: "app-store").

pilot — керування TestFlight. Завантажує білд, додає тестувальників, відстежує статус рев'ю. deliver — повна публікація в App Store, включаючи метадані, скріншоти, ціну та версії.

# Збірка та публікація iOS-застосунку
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

Для роботи з App Store Connect потрібні токени доступу. Fastlane підтримує два способи автентифікації: App Store Connect API Key (рекомендований) та Apple ID з двофакторною автентифікацією. API-ключі зручніші для CI/CD, оскільки не потребують інтерактивного введення пароля.

Автоматизація Android-збірок

На Android Fastlane автоматизує збірку через Gradle, підпис APK та AAB, завантаження до Google Play Console та Firebase App Distribution.

gradle — основний action для збірки Android. Він викликає Gradle wrapper з потрібними завданнями: gradle(task: "assembleRelease") або gradle(task: "bundleRelease") для AAB. Можна передавати прапорці, змінні середовища та шлях до gradle.properties.

supply — завантаження APK або AAB до Google Play Console. Supply керує версіями, треками (internal, alpha, beta, production), release notes, ціною та країною-поширення. Приклад: supply(track: "beta", release_status: "completed").

screengrab — створення скріншотів для Google Play. Запускає instrumentation-тести, які роблять скріншоти екранів застосунку на різних пристроях та мовах. Отримані скріншоти завантажуються через supply.

# Збірка та публікація Android-застосунку
lane :deploy_android do
  gradle(task: "clean bundleRelease")
  supply(
    track: "beta",
    release_status: "completed",
    version_code: 42
  )
end

Інтеграція з CI/CD

Fastlane спроєктований для роботи в CI/CD-пайплайнах. Він коректно обробляє non-interactive режим, змінні середовища та артефакти збірки. Нижче — приклади інтеграції з популярними CI-системами.

У GitHub Actions Fastlane запускається як Ruby-скрипт. Типовий воркфлоу: встановлення Ruby та Fastlane, налаштування ключів (сертифікати, API-токени через secrets), запуск lane. Для iOS потрібен macOS-раннер; Android працює на ubuntu-latest.

У GitLab CI Fastlane використовується в .gitlab-ci.yml з аналогічною схемою: встановлення залежностей, запуск fastlane, передача артефактів. GitLab CI підтримує macOS та Linux раннери.

Bitrise — спеціалізована CI/CD для мобільних застосунків — має вбудовану підтримку Fastlane. Bitrise Workflow може викликати Fastlane Step або запускати довільні скрипти з fastlane. Bitrise керує сертифікатами через свій Code Signing-менеджер.

# Fastfile для CI/CD з умовним запуском тестів
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

Важливий аспект CI/CD-інтеграції — зберігання секретів. Fastlane використовує файл .env через dotenv та змінні середовища. Для iOS критичні змінні: MATCH_PASSWORD, FASTLANE_APPLE_API_KEY, FASTLANE_APPLE_API_KEY_ID. Для Android: SUPPLY_JSON_KEY_DATA — вміст сервісного акаунта Google Play.

Популярні actions Fastlane

Fastlane включає понад 200 вбудованих actions. Нижче — огляд найбільш затребуваних із зазначенням платформи та призначення.

Для пошуку потрібного action використовується команда fastlane action [ім'я], яка виводить документацію, параметри та приклади. Повний список доступний локально: fastlane actions.

Fastlane також підтримує plugins — community-розширення, які додають нові actions. Плагіни встановлюються через fastlane add_plugin [ім'я] та доступні в реєстрі RubyGems. Приклади популярних плагінів: fastlane-plugin-versioning (керування версіями), fastlane-plugin-sentry (завантаження debug symbols у Sentry), fastlane-plugin-teams (сповіщення в Microsoft Teams).