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

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

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

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

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

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

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

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

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