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

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

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

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

Как вручную экспортировать UDID

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

      На вкладке Тестировщики и группы на панели управления App Distribution выберите Все тестировщики и нажмите Экспортировать UDID Apple, чтобы скачать CSV-файл. Затем импортируйте файл в аккаунт разработчика Apple, используя параметр Register Multiple Devices (Зарегистрировать несколько устройств). Подробнее о том, как распространять приложение на зарегистрированных устройствах…

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

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

      На странице Add Devices (Добавить устройства) на портале для разработчиков Apple зарегистрируйте новый UDID, указанный в полученном письме.

  2. Добавьте зарегистрированные устройства в профиль инициализации.
  3. Скачайте профиль инициализации и используйте его, чтобы пересобрать приложение. Если вы пересобираете приложение только для того, чтобы обновить зарегистрированные устройства, не меняйте номер сборки или версию.
  4. Повторно распространите приложение через консоль Firebase или интерфейс командной строки. Если вы не измените версию, номер сборки или код приложения, 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, используя вариант Register Multiple Devices(Зарегистрировать несколько устройств). Дополнительную информацию можно найти в документации Apple. Обратите внимание, что в аккаунт разработчика Apple можно импортировать ограниченное количество устройств в год.

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

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

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

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

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

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

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

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

Как включить или отключить оповещения для своего аккаунта

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

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

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

Как настроить расширенные оповещения для сторонних сервисов

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

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

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

  1. Настройте Cloud Functions for Firebase, выполнив следующие задачи:

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

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

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

Дальнейшие действия