Fastlane: какво е това, автоматизация на сборки и публикации

Fastlane — какво е това

Fastlane — е инструмент с отворен код, който автоматизира рутинните задачи на мобилната разработка: изграждане на приложението, стартиране на тестове, създаване на екранни снимки, управление на сертификати, качване на сборки в 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 с оптимални параметри, автоматично избира схема, конфигурация, опции за експорт и създава подписан 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), бележки към изданието, цена и държава на разпространение. Пример: 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 pipeline-ове. Той правилно обработва неинтерактивен режим, променливи на средата и артефакти от изграждане. По-долу — примери за интеграция с популярни CI системи.

В GitHub Actions Fastlane се стартира като Ruby скрипт. Типичен workflow: инсталиране на Ruby и Fastlane, настройка на ключове (сертификати, API токени чрез secrets), стартиране на lane. За iOS е необходим macOS runner; Android работи на ubuntu-latest.

В GitLab CI Fastlane се използва в .gitlab-ci.yml с подобна схема: инсталиране на зависимости, стартиране на fastlane, предаване на артефакти. GitLab CI поддържа macOS и Linux runners.

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.

Популярни Fastlane actions

Fastlane включва над 200 вградени actions. По-долу — преглед на най-популярните с посочване на платформа и предназначение.

За търсене на необходимото action се използва команда fastlane action [име], която показва документация, параметри и примери. Пълният списък е достъпен локално: fastlane actions.

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