Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

В этом руководстве описывается, как распространять APK среди тестировщиков с помощью интерфейса командной строки Firebase. Инструмент CLI позволяет указать тестировщиков и примечания к выпуску для сборки, а затем распределяет сборку соответствующим образом.

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

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

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

Шаг 1. Создайте свое приложение

Когда вы будете готовы распространить предварительную версию своего приложения среди тестировщиков, создайте APK, используя обычный процесс. Вы должны подписать APK своим ключом отладки или ключом подписи приложения.

Шаг 2. Распространите свое приложение среди тестировщиков

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

  1. Установите или обновите до последней версии интерфейс командной строки Firebase (мы рекомендуем загрузить отдельный двоичный файл для интерфейса командной строки, характерного для вашей ОС). Обязательно войдите в систему и проверьте, можете ли вы получить доступ к своим проектам.
  2. На странице «Распространение приложений» консоли Firebase выберите приложение, которое хотите распространить, и нажмите «Начать» .

  3. Запустите команду appdistribution:distribute , чтобы загрузить приложение и распространить его среди тестировщиков. Используйте следующие параметры для настройки раздачи:

    appdistribution: параметры распространения
    --app

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

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

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

    --token "$FIREBASE_TOKEN"
    --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

    Флаг, который вы можете включить для печати подробного лога.

    Например:

    firebase appdistribution:distribute test.apk  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

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

    • firebase_console_uri — ссылка на консоль Firebase, отображающая один выпуск. Вы можете поделиться этой ссылкой с другими разработчиками в вашей организации.
    • testing_uri — ссылка на выпуск в интерфейсе тестировщика (собственное приложение для Android), которая позволяет тестировщикам просматривать примечания к выпуску и устанавливать приложение на свое устройство. Тестировщику необходим доступ к выпуску, чтобы использовать ссылку.
    • binary_download_uri — подписанная ссылка, которая напрямую загружает и устанавливает двоичный файл приложения (файл APK или AAB). Ссылка действительна через час.

    Помимо распространения выпусков, вы также можете использовать appdistribution:testers:add и appdistribution:testers:remove , чтобы пригласить новых тестировщиков или удалить существующих тестировщиков из вашего проекта Firebase. После добавления тестировщика в ваш проект Firebase вы можете добавить его в отдельные выпуски. Как только вы удалите тестировщика, у него больше не будет доступа к релизам вашего проекта. Обратите внимание, что недавно удаленные тестировщики могут сохранить доступ к вашим выпускам в течение определенного периода времени.

    Например:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    Электронные письма тестировщика должны быть разделены пробелом. Вы также можете указать тестировщиков, используя --file /path/to/testers.txt .

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

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

У тестировщиков есть 30 дней, чтобы принять приглашение протестировать приложение до истечения срока его действия. Когда срок действия приглашения истекает через 5 дней, уведомление об истечении срока действия появляется в консоли Firebase рядом с тестировщиком в выпуске. Приглашение можно обновить, отправив его повторно с помощью раскрывающегося меню в строке тестера.

Следующие шаги