Зарегистрируйте дополнительные устройства 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-файл.

      На вкладке Testers & Groups панели App Distribution выберите All testers , затем нажмите Export Apple UDIDs для загрузки CSV-файла. Затем импортируйте файл в свою учетную запись разработчика Apple с помощью параметра Register Multiple Devices . Чтобы узнать больше, см. Distributing your app to registered devices .

      Обратите внимание, что ваша учетная запись разработчика 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 с помощью опции Register Multiple Devices . Чтобы узнать больше, см. документацию Apple . Обратите внимание, что ваша учетная запись разработчика Apple может позволить вам импортировать только ограниченное количество устройств в год.

  3. Добавьте зарегистрированные устройства в свой профиль подготовки .

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

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

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

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

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

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

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

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