Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Распространяйте приложения Android среди тестировщиков с помощью fastlane

В этом руководстве описывается, как распространять сборки APK среди тестировщиков с помощью fastlane , платформы с открытым исходным кодом, которая автоматизирует создание и выпуск приложений для iOS и Android. Он следует простым инструкциям, определенным в Fastfile . После того, как вы настроили fastlane и свой Fastfile , вы можете интегрировать App Distribution со своей конфигурацией fastlane.

Прежде чем вы начнете

Если вы еще этого не сделали, добавьте Firebase в свой проект Android .

Если вы не используете какие-либо другие продукты Firebase, вам нужно только создать проект и зарегистрировать приложение. Однако, если вы решите использовать дополнительные продукты в будущем, обязательно выполните все шаги на странице, указанной выше.

Шаг 1 . Настроить скоростную полосу

  1. Установить и настроить fastlane .

  2. Чтобы добавить распространение приложений в конфигурацию Fastlane, выполните следующую команду из корня вашего проекта Android:

    fastlane add_plugin firebase_app_distribution

    Если команда предлагает вам вариант, выберите Option 3: RubyGems.org .

Шаг 2 . Аутентифицироваться с Firebase

Прежде чем вы сможете использовать плагин Fastlane, вы должны сначала пройти аутентификацию в своем проекте Firebase. Этого можно добиться тремя способами:

Шаг 3 . Настройте свой Fastfile и распространите свое приложение

  1. В ./fastlane/Fastfile полосу, добавить firebase_app_distribution блок. Используйте следующие параметры для настройки раздачи:

    параметры firebase_app_distribution
    app

    Обязательно : идентификатор приложения Firebase для вашего приложения. Вы можете найти идентификатор приложения в консоли Firebase на странице общих настроек .

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

    Токен обновления, который печатается при запуске действия входа в систему плагина (см. Аутентификация с использованием учетной записи Google выше) или при аутентификации среды CI с помощью интерфейса командной строки Firebase (дополнительные сведения см. В разделе Использование интерфейса командной строки с системами CI ).

    service_credentials_file

    Путь к json-файлу вашей учетной записи службы Google. См. Выше, как пройти аутентификацию с использованием учетных данных учетной записи службы .

    android_artifact_type

    Указывает тип файла Android (APK или AAB).

    android_artifact_path

    Заменяет apk_path (устарело). Абсолютный путь к файлу APK или AAB, который вы хотите загрузить. Если не указано, fastlane определяет местоположение файла по полосе, в которой файл был сгенерирован.

    release_notes
    release_notes_file

    Примечания к выпуску для этой сборки.

    Вы можете указать примечания к выпуску напрямую:

    release_notes: "Text of release notes"

    Или укажите путь к текстовому файлу:

    release_notes_file: "/path/to/release-notes.txt"
    testers
    testers_file

    Адреса электронной почты тестировщиков, которых вы хотите пригласить.

    Вы можете указать тестировщиков в виде списка адресов электронной почты, разделенных запятыми:

    testers: "ali@example.com, bri@example.com, cal@example.com"

    Или вы можете указать путь к текстовому файлу, содержащему список адресов электронной почты, разделенных запятыми:

    testers_file: "/path/to/testers.txt"
    groups
    groups_file

    Группы тестировщиков, которых вы хотите пригласить (см. Управление тестировщиками ). Группы указываются с помощью групповые псевдонимы , который вы можете найти в консоли Firebase.

    Вы можете указать группы в виде списка, разделенного запятыми:

    groups: "qa-team, trusted-testers"

    Или вы можете указать путь к текстовому файлу, содержащему список имен групп, разделенных запятыми:

    groups_file: "/path/to/groups.txt"
    debug

    Логический флаг. Вы можете установить значение true для вывода подробных отладочных данных.

    Например:

    platform :android do
        desc "My awesome app"
        lane :distribute do
            build_android_app(...)
            # build_android_app is a built-in fastlane action.
    
            firebase_app_distribution(
                app: "1:123456789:android:abcd1234",
                testers: "tester1@company.com, tester2@company.com",
                release_notes: "Lots of amazing new features to test out!"
            )
    
        end
    end
    
  2. Наконец, чтобы сделать сборку доступной для тестировщиков, запустите дорожку:

    fastlane <lane>
    .

После распространения сборки она становится доступной на панели управления распространением приложений консоли Firebase в течение 150 дней (пяти месяцев). Когда срок действия сборки составляет 30 дней, уведомление об истечении срока действия появляется как в консоли, так и в списке сборок вашего тестировщика на их тестовом устройстве.

Тестировщики, которые не были приглашены для тестирования приложения, получают приглашения по электронной почте, чтобы начать работу, а существующие тестировщики получают по электронной почте уведомления о том, что новая сборка готова к тестированию (прочтите руководство по настройке тестера, чтобы узнать, как установить тестовое приложение). Вы можете отслеживать статус каждого тестировщика - приняли ли они приглашение и загрузили ли приложение - в консоли Firebase.