Вы можете распространять сборки среди тестировщиков с помощью интерфейса командной строки 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:
- Установите или обновите до последней версии интерфейс командной строки Firebase (мы рекомендуем загрузить отдельный двоичный файл для интерфейса командной строки, характерного для вашей ОС). Обязательно войдите в систему и проверьте, можете ли вы получить доступ к своим проектам.
- На странице «Распространение приложений» консоли Firebase выберите приложение, которое хотите распространить, и нажмите «Начать ».
Запустите команду
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 рядом с тестировщиком в выпуске. Приглашение можно обновить, отправив его повторно с помощью раскрывающегося меню в строке тестера.
Следующие шаги
- Чтобы зарегистрировать дополнительные устройства вручную или программно, см. раздел Регистрация дополнительных устройств iOS .