Автоматическая подготовка для Xamarin.iOS

Установив Xamarin.iOS для разработки приложений для iOS можно приступать к подготовке устройства iOS. В этом руководстве описано, как использовать функцию автоматической подготовки для запроса сертификатов и профилей разработки.

Требования

Автоматическая подготовка доступна на Visual Studio для Mac, Visual Studio 2019 и Visual Studio 2017 (версия 15.7 и более поздние).

Примечание.

Для использования этой функции у вас также должна быть платная учетная запись разработчика Apple. Дополнительные сведения об учетных записях разработчика Apple можно найти в статье Подготовка устройства для Xamarin.iOS. Если у вас нет платной учетной записи разработчика Apple, см. руководство Бесплатная подготовка для Xamarin.iOS.

Примечание.

Прежде чем начать, обязательно примите все лицензионные соглашения на портале разработчика Apple или App Store Connect.

Включение автоматической подготовки

Прежде чем начинать процесс автоматического подписывания, следует убедиться, что в Visual Studio добавлен идентификатор Apple, как описано в руководстве Управление учетными записями Apple.

После добавления идентификатора Apple вы можете использовать любую связанную команду. Это позволяет создавать сертификаты, профили и другие идентификаторы для этой группы. На основе идентификатора команды также создается префикс для идентификатора приложения, который будет включен в профиль подготовки. Это позволяет компании Apple подтверждать вашу личность.

Чтобы автоматически подписать приложение для развертывания на устройстве iOS, выполните указанные ниже действия:

  1. Откройте проект iOS в Visual Studio для Mac.

  2. Откройте файл Info.plist.

  3. Перейдите на вкладку Приложение.

  4. В разделе Подписывание выберите Автоматическая подготовка:

    Team selector dropdown

  5. Выберите свою команду в раскрывающемся списке Team (Команда).

  6. Через несколько секунд будут созданы сертификат для подписи и профиль подготовки:

    successfully created certificate and profile

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

Запуск автоматической подготовки

Если автоматическая подготовка включена, Visual Studio будет повторно запускать процесс при необходимости в следующих случаях:

  • Устройство iOS подключено к компьютеру Mac
    • При этом автоматически проверяется регистрация устройства на портале разработчика Apple. Если устройство не зарегистрировано, оно добавляется, и создается содержащий его профиль подготовки.
  • Идентификатор пакета приложения изменяется
    • При этом обновляется идентификатор приложения. Создается профиль подготовки, содержащий этот идентификатор приложения.
  • В файле Entitlements.plist включается поддерживаемая возможность.
    • Эта возможность будет добавлена в идентификатор приложения, и будет создан профиль подготовки с обновленным идентификатором приложения.
    • В настоящее время поддерживаются не все возможности. Дополнительные сведения о поддерживаемых возможностях см. в руководстве Работа с возможностями.

Шаблон идентификаторов приложений

В Visual Studio для Mac и Visual Studio 2019 (версия 16.5 или более поздняя) автоматическая подготовка по умолчанию пытается создать и использовать шаблон идентификатора приложения и профили подготовки вместо явного идентификатора приложения на основании идентификатора пакета, указанного в файле Info.plist. Шаблон идентификаторов приложений сокращает число профилей и идентификаторов на портале разработчика Apple.

В некоторых случаях для назначений приложения требуется явный идентификатор приложения. Следующие назначения не поддерживают шаблон идентификаторов приложений:

  • Группы приложений
  • Связанные домены
  • Apple Pay
  • Игровой центр
  • HealthKit
  • HomeKit
  • Хот-спот
  • Покупки из приложений
  • Несколько путей
  • NFC
  • Личная VPN
  • Push-уведомления
  • Конфигурация беспроводных периферийных устройств

Если приложение использует одно из этих назначений, Visual Studio попытается создать явный (вместо шаблонного) идентификатор приложения.

Устранение неполадок

  • Утверждение новой учетной записи разработчика Apple может занять несколько часов. Вы не сможете включить автоматическую подготовку, пока учетная запись не будет утверждена.
  • Если процесс автоматической подготовки завершается сбоем с сообщением об ошибке Authentication Service Is Unavailable, войдите в App Store Connect или appleid.apple.com, чтобы убедиться, что вы приняли последние соглашения об обслуживании.
  • Если вы получаете сообщение об ошибке Authentication Error: Xcode 7.3 or later is required to continue developing with your Apple ID., убедитесь, что выбранная команда имеет активную платную принадлежность к программе для разработчиков Apple. Чтобы использовать платную учетную запись разработчика Apple, ознакомьтесь со статьей Бесплатная подготовка для приложений Xamarin.iOS.