Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

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

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

      На вкладке «Тестеры и группы» панели управления распространением приложений выберите « Все тестировщики» , затем нажмите «Экспортировать идентификаторы UDID Apple» , чтобы загрузить файл 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 по электронной почте.

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

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

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

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

Чтобы включить или отключить оповещения о распространении приложений, выполните следующие действия.

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

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

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

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

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

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

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

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

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

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