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

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

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

Получив электронное письмо с UDID, обновите профиль инициализации, указав в нем этот идентификатор, и распространите новую сборку среди тестировщиков. Вы можете экспортировать UDID вручную с помощью консоли Firebase или интерфейса командной строки Firebase, а также программно с помощью 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 или 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, используя функцию 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.

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