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

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

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

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

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

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

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

  • Чтобы распространять ваше приложение за пределами вашей группы разработчиков, вы должны использовать профиль распространения Ad Hoc или Enterprise.
  • Если ваше приложение использует Game Center, APN (и, соответственно, Cloud Messaging ) или iCloud, убедитесь, что в вашем профиле подготовки используется явный идентификатор приложения, а не подстановочный идентификатор.
  • Если вы используете профиль распространения Ad Hoc, включите уникальные идентификаторы устройств (UDID) устройств ваших тестировщиков. По мере того как новые тестировщики iOS будут регистрироваться в вашей тестовой программе, вам нужно будет обновить профиль подготовки, указав UDID их устройств. См. Регистрация дополнительных устройств тестера .
  • Вы обновили видимый пользователю номер версии цели сборки ( Version ) и уникальный номер сборки ( Build ). Если вы внесли изменения в код с момента последней сборки (то есть вы не выполняете перестроение только для обновления зарегистрированных устройств), вам не нужно обновлять номер версии и сборки.

Когда сборка завершается, она сохраняет файл IPA и некоторые файлы журналов в указанной вами папке. Вы распространяете файл IPA среди тестировщиков, выполняя следующие шаги.

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

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

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

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

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

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

    --app 1:1234567890:ios: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.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    Помимо распространения выпусков, вы также можете использовать 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 рядом с тестировщиком в выпуске. Приглашение можно обновить, отправив его повторно с помощью раскрывающегося меню в строке тестера.

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