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

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

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

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

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

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

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

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

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

      На странице «Добавление устройств» портала разработчиков 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, используя функцию «Зарегистрировать несколько устройств» . Подробнее см. в документации 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 .
  2. Затем перейдите к Настройки и настройте параметры своей учетной записи для оповещений App Distribution .

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

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

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

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

  1. Настройка облачных функций для Firebase , которая включает в себя следующие задачи:

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

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

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

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