Настройка автоматической раздачи билдов через Firebase App Distribution

Настройка автоматической раздачи билдов через Firebase App Distribution

Отметим: когда билды тестовой версии нужно доставить команде до того, как App Store или Google Play одобрят сборку, каждый час ожидания — это простой. Firebase App Distribution (FAD) решает эту проблему: выгружает .apk или .ipa напрямую тестировщикам, минуя модерацию. Но ручная загрузка на веб-интерфейс — тоже потеря времени, особенно при нескольких коммитах в день. Мы автоматизируем этот процесс полностью: от подписи iOS через match до интеграции в GitHub Actions или GitLab CI. Под ключ с поддержкой в течение месяца.

Почему FAD выигрывает у TestFlight и Play Console? TestFlight требует включения в ревью Apple и лимит в 100 тестировщиков. Play Console — только Android, и внутреннее тестирование публикуется с задержкой до часа. FAD даёт до 1000 тестировщиков на проект, мгновенную доставку и встроенную интеграцию с Crashlytics — краш-репорты видны сразу после установки. Высвобожденное время разработчики тратят на фичи, а не на ожидание.

Отметим: как настроить автоматическую раздачу для Android через Fastlane. Fastlane — стандарт CI/CD для мобильной разработки. Плагин firebase_app_distribution делает раздачу одной командой:

lane :distribute_android do gradle( task: "assemble", build_type: "Debug", flavor: "staging" ) firebase_app_distribution( app: ENV["FIREBASE_APP_ID_ANDROID"], firebase_cli_token: ENV["FIREBASE_CLI_TOKEN"], groups: "qa-team, internal-testers", release_notes: "Branch: #{git_branch}\nCommit: #{last_git_commit[:message]}" ) end 

Токен получают одним firebase login:CI, его хранят в секретах CI. Альтернатива — Service Account JSON (Google Cloud IAM): такой ключ не истекает, поэтому для продакшн-CI предпочитают его. Мы всегда используем Service Account.

Настройка для iOS: подпись ad-hoc и UDID Для iOS процесс сложнее из-за provisioning profile. Нужен .ipa, подписанный ad-hoc или development. Устройства тестировщиков регистрируют в Apple Developer Portal. Firebase автоматически собирает UDID через onboarding-ссылку, но профиль придётся пересобрать. Fastlane + match автоматизируют и это:

lane :distribute_ios do match(type: "adhoc", readonly: true) build_app( scheme: "MyApp-Staging", export_method: "ad-hoc" ) firebase_app_distribution( app: ENV["FIREBASE_APP_ID_IOS"], firebase_cli_token: ENV["FIREBASE_CLI_TOKEN"], groups: "ios-testers", release_notes: "Build #{build_number}" ) end 

Fastlane documentation: firebase_app_distribution plugin При добавлении нового тестировщика UDID можно импортировать через сгенерированную FAD ссылку — firebase appdistribution:testers:invite или через интерфейс. После этого нужно обновить профиль. Match с опцией register_devices сделает это автоматически при следующей сборке.

Firebase App ID: не перепутайте FIREBASE_APP_ID — это не bundle identifier, а строка вида 1:123456789:android:abcdef. Его берут в Firebase Console → Project Settings → Your apps. Частая ошибка — указать идентификатор iOS вместо Android, и наоборот.

Интеграция в CI без Fastlane Если проект не использует Fastlane, Firebase CLI работает напрямую:

firebase appdistribution:distribute app-release.apk \ --app "$FIREBASE_APP_ID" \ --groups "qa-team" \ --release-notes "Automated build $CI_BUILD_NUMBER" \ --token "$FIREBASE_CLI_TOKEN" 

Команда подходит для любого CI: GitHub Actions, GitLab CI, Bitrise, CircleCI. Разница только в том, как передать токен — через переменные окружения.

Сравнение способов: Fastlane vs Firebase CLI