Firebase App Distribution: рассылаем Flutter-сборки тестировщикам
Хорошо это или плохо — время покажет. Мы же сегодня рассмотрим, как настроить эту технологию для рассылки сборок Flutter-приложения на macOS, используя Fastlane.
Когда мы только приступили к изучению данной технологии, то нашли эту статью. Она, бесспорно, полезная. Однако описывает только шаги для конфигурации Android-составляющей Flutter-приложения. Шаги для работы с iOS в ней опущены, а ведь там, как показала практика, есть, где споткнуться. Поэтому данная статья представляет собой перевод, расширенный и дополненный шагами, необходимыми для полноценной конфигурации рассылки как Android-, так и iOS-сборок Flutter-приложения. Итак, поехали.
Проверка подключения к Firebase
Предполагается, что к настоящему моменту ваш проект уже подключен к Firebase. Если вы еще этого не сделали, сейчас самое время. Воспользуйтесь сведениями из документации Firebase, описанными здесь. Обязательно перейдите на вкладку «App Distribution» и нажмите кнопку «Начать работу» — так вы подключите Firebase App Distribution к своему проекту. Позднее вам понадобится уникальный идентификатор вашего приложения в Firebase, который можно найти, перейдя по вкладкам: Настройки проекта → Общие настройки → Идентификатор приложения.
Учтите, что если у вас приложение для двух платформ: iOS и Android, то у каждой платформы будет свой идентификатор, и его нужно будет записать в соответствующей платформе Fastfile (конфигурационный файл для Fastlane). Но обо всем по порядку. Если вы не так давно обновились с Mojave (или другой, более старой версии macOS) до Catalina, то вы должны были заметить, что теперь macOS по умолчанию использует zsh вместо bash. В связи с этим вы должны переименовать свой $HOME/.bashrc в $HOME/.zshrc, а также выполнить команду: После выполнения этого шага в вашей командной строке вместо характерного для bash «‘$’» должен появиться «‘%’». Если этого не произошло (обычно такое случается, если у пользователя, под которым вы работаете, недостаточно прав), перейдите в Terminal → Preferences, выберите Command (complete path) и введите туда путь: Следующий шаг — настройка Ruby. По умолчанию macOS поставляет свою версию Ruby, в которую вам нельзя ничего устанавливать. Предполагается, что она используется исключительно системой и полностью контролируется Apple. Поэтому вам нужно использовать другую версию Ruby, где никто не будет «бить по рукам» и у вас будет полная свобода в вопросах установки gems. Для начала установим менеджер версий Ruby. Используем установку через Homebrew: Далее вам нужно дописать следующую строку в ваш $HOME/.bashrc или $HOME/.zshrc: Не забудьте перезагрузить терминал или выполнить команду: либо: Теперь установите нужную вам версию Ruby. Список всех версий можно получить командой: Установка нужной версии выполняется следующей командой (предположим, что вы решили установить версию 2.6.5): После установки Ruby делаем ее глобально доступной для использования: Убедимся, что все сделано правильно. Введите команду: Команда выдаст список всех версий Ruby, доступных на рабочей машине, и звездочкой выделит ту, которая в данный момент активна. Если все сделано правильно, то вывод должен выглядеть, например, так: username-admin ~ % rbenv versions system * 2.6.5 (set by /Users/username/.rbenv/version) Вот теперь можно перейти к Firebase. Установим Fastlane, если у вас его еще нет. Выполним команду: Установим утилиты командной строки Firebase CLI: Введите команду: В появившемся окне браузера выполните авторизацию через тот Google-аккаунт, в котором создавали проект в Firebase. Теперь рассмотрим процесс подключения Firebase App Distribution к вашим iOS- и Android-проектам. Перейдите в соответствующую подпапку (iOS/Android) в корне вашего Flutter-проекта и выполните команду: Находясь в той же папке, выполните команду: Тем самым вы подключили плагин Firebase к вашему проекту. Обратите внимание — выполнять эти две команды нужно дважды: отдельно для iOS-проекта, отдельно для Android. Возможно, с первого раза этот шаг выполнить не удастся. Если у вас в консоли появилось такое сообщение об ошибке: An error occurred while installing json (2.3.0), and Bundler cannot continue. Make sure that `gem install json -v ’2.3.0′ —source ’https://rubygems.org/’` succeeds before bundling. То принудительно установите gem необходимой версии: А затем выполните неудавшуюся команду еще раз. После этого плагин должен благополучно подключиться к проекту. Последний шаг — отредактировать наши Fastfile, которые находятся в подпапках проекта android/fastlane/ и ios/fastlane/. Вот как могут выглядеть файлы с простейшими lane для отправки сборок тестировщикам на Android: default_platform(:android) platform :android do desc «Some Android test deployment» lane :distribute_internal_android do gradle(task: «clean assembleRelease») firebase_app_distribution( app: «ID вашего проекта в Firebase», testers: «account1@gmail.com, account2@gmail.com», release_notes: «New Android build», firebase_cli_path: «/usr/local/bin/firebase», apk_path: «../build/app/outputs/apk/release/app-release.apk» ) end end И iOS, соответственно: default_platform(:ios) platform :ios do desc «Some iOS test deployment» lane :distribute_internal_ios do build_ios_app( export_options: { method: «ad-hoc», provisioningProfiles: { «com.your.app.bundle.id»: «Your sertificate ADHOC» }, signingStyle: «manual» } ) # build_ios_app is a built-in fastlane action. firebase_app_distribution( app: «ID вашего проекта в Firebase», testers: «account1@gmail.com, account2@gmail.com», release_notes: «New iOS build», firebase_cli_path: «/usr/local/bin/firebase» ) end end Обратите внимание — в случае с iOS в данном примере приводится конфигурация для ручного управления сертификатами (manual). Убедитесь, что у вас установлены все необходимые certificates и provisioning profiles (Ad Hoc, App Store, Development). Перед тем, как делать итоговую сборку, убедитесь, что ваши проекты собраны в релизной конфигурации. Если вы перед отправкой приложения запускали его под дебагом, чтобы убедиться, что все в порядке, то сборка тестировщикам также отправится в отладочной конфигурации. А это значит, что тестировщики ее увидят и даже установят, но при запуске приложение будет крашиться. Чтобы этого не произошло, предварительно соберите приложение в релизном режиме командами: Впрочем, команду build необходимо выполнять в любом случае. Дело в том, что во время сборки Flutter собирает свои конфигурационные файлы и подтягивает их к платформенным проектам. В том числе, например, редактирует номер сборки/версии, взятый из pubspec.yaml. Без этих конфигурационных файлов вы просто не сможете собрать свои.apk-/.ipa-файлы. Далее, в зависимости от того, в какой папке вы находитесь, выполните команду: Готово! Ваши сборки уже собираются для отправки тестировщикам! Иногда возникает странная ошибка — в консоли Firebase указано, что приглашения отправлены всем тестировщикам, однако некоторым на почту не приходит ничего. Делать сборку и отправлять ее повторно бесполезно. Чтобы это исправить, выберите нужных вам тестировщиков и нажмите «Resend invitation» / «Отправить приглашение еще раз». После этого сборки начнут послушно прилетать на указанные email-адреса. Оригинал статьи размещён на нашем сайте.
Подготовка командной строки macOS
Установка Fastlane и Firebase CLI
Подключение Firebase App Distribution
Рассылка приложения
