Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

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

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

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

  1. Установка или обновление до последней версии Firebase CLI (мы рекомендуем загрузить автономный двоичный файл для конкретных CLI для вашей операционной системы). Убедитесь , что вход и тест , который вы можете получить доступ к своим проектам.
  2. В странице App Distribution в Firebase консоли выберите приложение , которое вы хотите распространять, затем нажмите кнопку Начать.
  3. Выполните appdistribution:distribute команду , чтобы загрузить приложение и распространять его тестировщик. Используйте следующие параметры для настройки раздачи:

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

    Требуется: Ваше приложение в Firebase App ID. Вы можете найти идентификатор приложения в Firebase консоли, на странице Общих настроек .

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

    Освежать маркер , который печатается после проверки подлинности CI сред с Firebase CLI (чтение Используйте CLI с системами 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 рядом с тестером выпуска. Приглашение можно продлить, повторно отправив его с помощью раскрывающегося меню в строке тестера.

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

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

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

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

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

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

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

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

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