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

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

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

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

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

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

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

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

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

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

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

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

  1. Установите или обновите до последней версии Firebase CLI (мы рекомендуем загрузить автономный двоичный файл для CLI, специфичного для вашей ОС). Обязательно войдите в систему и проверьте, можете ли вы получить доступ к своим проектам.
  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
    

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

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

Шаг 3 . Зарегистрируйте дополнительные устройства

Когда тестировщики принимают приглашение протестировать сборку, не подписанную с помощью профиля Enterprise, у них запрашивается разрешение поделиться с вами идентификатором своего устройства. Если они согласны, App Distribution собирает UDID с устройства и уведомляет вас об этом по электронной почте.

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

  1. Добавьте устройства на портал разработчика Apple.
    • Вариант 1. Импортируйте UDID устройства в виде файла CSV.

      На вкладке « Тестировщики и группы » панели «Распространение приложений» выберите « Все тестировщики» , затем нажмите « Экспорт идентификаторов Apple UDID», чтобы загрузить файл CSV. Затем импортируйте файл в свою учетную запись разработчика Apple, используя параметр « Зарегистрировать несколько устройств» . Обратитесь к документации Apple, чтобы узнать больше.

      Обратите внимание, что ваша учетная запись разработчика Apple может позволять импортировать только ограниченное количество устройств в год.

    • Вариант 2. Соберите и введите UDID по электронной почте.

      На странице « Добавить устройства» портала разработчика Apple зарегистрируйте новый UDID, указанный в полученном вами электронном письме.

  2. Добавьте зарегистрированные устройства в свой профиль обеспечения .
  3. Загрузите профиль подготовки и используйте его для восстановления приложения. Если вы перестраиваете только для обновления зарегистрированных устройств, не обновляйте номер сборки или версию.
  4. Повторно распространите свое приложение из консоли Firebase или интерфейса командной строки. Если вы уже распространили сборку с тем же номером сборки и версией, уведомления по электронной почте будут получать только пользователи недавно зарегистрированных устройств.