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

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

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

Получив электронное письмо с UDID, обновите свой профиль подготовки, добавив этот UDID, и распространите новую сборку среди тестировщиков. Вы можете экспортировать UDID вручную с помощью консоли Firebase или Firebase CLI , или же программно экспортировать UDID с помощью fastlane .

Экспорт UDID вручную

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

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

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

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

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

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

Программный экспорт UDID с помощью fastlane

  1. Экспортируйте все UDID ваших тестовых устройств в CSV-файл из fastlane. Например, создайте и запустите новый поток download_udids :

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Импортируйте UDID(-ы) в свою учетную запись разработчика Apple, используя опцию « Регистрация нескольких устройств» . Для получения дополнительной информации см. документацию Apple . Обратите внимание, что ваша учетная запись разработчика Apple может позволять импортировать только ограниченное количество устройств в год.

  3. Добавьте зарегистрированные устройства в свой профиль инициализации .

  4. Загрузите профиль подготовки и используйте его для пересборки вашего приложения. Если вы пересобираете приложение только для обновления зарегистрированных устройств, не меняйте номер сборки или версию.

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

Получайте оповещения

Получать оповещения по умолчанию

По умолчанию Firebase может отправлять уведомления App Distribution о регистрации новых устройств iOS по электронной почте.

Для получения оповещений App Distribution через этот механизм по умолчанию необходимо иметь разрешение firebase.projects.update . Следующие роли по умолчанию обладают этим необходимым разрешением: администратор Firebase , владелец проекта или редактор .

По умолчанию каждый участник проекта (имеющий необходимые права на получение уведомлений) будет получать электронное письмо при регистрации нового устройства iOS.

Включите/отключите оповещения для своей учетной записи.

В своей учетной записи вы можете включать/выключать оповещения App Distribution не затрагивая других участников проекта. Обратите внимание, что для получения оповещений вам по-прежнему необходимы соответствующие разрешения.

Чтобы включить или отключить оповещения App Distribution , выполните следующие действия:

  1. В консоли Firebase , в правом верхнем углу, перейдите по следующему пути: Firebase alerts .
  2. Затем перейдите к Настройте параметры своей учетной записи для оповещений App Distribution .

Настройте расширенные оповещения для сторонних сервисов.

Вы также можете отправлять оповещения App Distribution в предпочтительный канал уведомлений вашей команды, используя Cloud Functions for Firebase . Например, вы можете написать функцию, которая перехватывает событие оповещения о регистрации нового устройства iOS и отправляет информацию об оповещении в сторонний сервис, такой как Discord, Slack или Jira.

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

Для настройки расширенных возможностей оповещения с помощью Cloud Functions for Firebase выполните следующие шаги:

  1. Настройка Cloud Functions для Firebase включает в себя следующие задачи:

    1. Настройте среду разработки для Node.js или Python.
    2. Установите Firebase CLI и войдите в систему.
    3. Инициализация Cloud Functions for Firebase с помощью Firebase CLI.

  2. Напишите и разверните функцию , которая перехватывает событие оповещения из App Distribution и обрабатывает полезную нагрузку события (например, отправляет информацию об оповещении в сообщении в Discord).

Чтобы узнать обо всех событиях оповещения, которые вы можете отслеживать, перейдите к справочной документации по оповещениям App Distribution .

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