Xamarin.iOS에 대한 자동 프로비저닝Automatic Provisioning for Xamarin.iOS

Xamarin.iOS가 성공적으로 설치된 후 iOS 개발의 다음 단계는 iOS 디바이스를 프로비전하는 것입니다. 이 가이드에서는 자동 프로비저닝을 사용하여 개발 인증서와 프로필을 요청하는 방법을 설명합니다.Once Xamarin.iOS has been successfully installed, the next step in iOS development is to provision your iOS device. This guide explores using automatic provisioning to request development certificates and profiles.

요구 사항Requirements

자동 프로비저닝은 Mac용 Visual Studio, Visual Studio 2019 및 Visual Studio 2017(버전 15.7 이상)에서 사용할 수 있습니다.Automatic provisioning is available on Visual Studio for Mac, Visual Studio 2019, and Visual Studio 2017 (Version 15.7 and higher).

참고

이 기능을 사용하려면 유료 Apple 개발자 계정도 필요합니다.You must also have a paid Apple Developer account to use this feature. Apple 개발자 계정에 대한 자세한 내용은 디바이스 프로비저닝 가이드를 참조하세요.More information on Apple developer accounts is available in the Device Provisioning guide. 유료 Apple 개발자 계정이 없는 경우 Xamarin.iOS에 대한 체험 프로비저닝 가이드를 참조하세요.If you do not have a paid Apple developer account, see the Free Provisioning for Xamarin.iOS guide.

참고

시작하기에 앞서, Apple 개발자 포털 또는 App Store Connect에서 모든 라이선스 계약에 동의하시기 바랍니다.Before you begin, be sure to first accept any license agreements in either the Apple Developer portal or App Store Connect.

자동 프로비저닝 사용Enable automatic provisioning

자동 서명 프로세스를 시작하기 전에 Apple 계정 관리 가이드에 설명된 대로 Visual Studio에 Apple ID를 추가했는지 확인해야 합니다.Before starting the automatic signing process, you should ensure that you have an Apple ID added in Visual Studio, as described in the Apple Account Management guide.

Apple ID를 추가했다면 모든 관련 _팀_을 사용할 수 있습니다.Once you've added an Apple ID, you can use any associated Team. 따라서 팀에 대해 인증서, 프로필 및 다른 ID를 만들 수 있습니다.This allows certificates, profiles, and other IDs to be made against the team. 팀 ID는 프로비저닝 프로필에 포함될 앱 ID의 접두사를 만들 때도 사용됩니다.The team ID is also used to create a prefix for an App ID that will be included in the provisioning profile. 이 요소가 있으면 Apple이 신원을 확인할 수 있습니다.Having this allows Apple to verify that you are who you say you are.

IOS 디바이스에 배포할 앱에 자동으로 서명하려면 다음을 수행합니다.To automatically sign your app for deployment on an iOS device, do the following:

  1. Mac용 Visual Studio에서 iOS 프로젝트를 엽니다.Open an iOS project in Visual Studio for Mac.

  2. Info.plist 파일을 엽니다.Open the Info.plist file.

  3. 애플리케이션 탭을 선택합니다.Select the Application tab.

  4. 서명 섹션에서 자동 프로비저닝을 선택합니다.In the Signing section, select Automatic Provisioning:

    팀 선택기 드롭다운

  5. 드롭다운에서 팀을 선택합니다.Select your team from the Team dropdown.

  6. 몇 초 후 서명 인증서 및 프로비저닝 프로필이 생성됩니다.After a few seconds a Signing Certificate and Provisioning profile will be created:

    성공적으로 생성된 인증서와 프로필

    자동 서명이 실패하면 자동 서명 패드에 오류의 원인이 표시됩니다.If the automatic signing fails the Automatic signing pad will display the reason for the error.

자동 프로비저닝 실행Run automatic provisioning

자동 프로비저닝이 사용하도록 설정되면 다음과 같은 상황이 발생할 경우 필요에 따라 Visual Studio가 이 프로세스를 다시 실행합니다.When automatic provisioning is enabled, Visual Studio will re-run the process if necessary when any of the following things happen:

  • iOS 디바이스가 mac에 플러그 인됩니다.An iOS device is plugged into your Mac
    • 디바이스가 Apple Developer Portal에 등록되었는지 자동으로 검사합니다.This automatically checks to see if the device is registered on the Apple Developer Portal. 등록되지 않은 경우 디바이스를 추가하고 이를 포함하는 새 프로비저닝 프로필을 생성합니다.If it isn't, it will add it and generate a new provisioning profile that contains it.
  • 앱의 번들 ID가 변경된 경우The Bundle ID of your app is changed
    • 앱 ID를 업데이트합니다.This updates the app ID. 이 앱 ID를 포함하는 새 프로비저닝 프로필이 생성됩니다.A new provisioning profile containing this app ID is created.
  • 지원되는 기능은 Entitlements.plist 파일에 활성화됩니다.A supported capability is enabled in the Entitlements.plist file.
    • 이 기능은 앱 ID에 추가되고, 업데이트된 앱 ID가 포함된 새 프로비저닝 프로필이 생성됩니다.This capability will be added to the app ID and a new provisioning profile with the updated app ID is generated.
    • 일부 기능은 현재 지원되지 않습니다.Not all capabilities are currently supported. 지원되는 기능에 대한 자세한 내용은 기능 사용 가이드를 참조하세요.For more information on the ones that are supported, check out the Working with Capabilities guide.

와일드카드 앱 IDWildcard App IDs

Mac용 Visual Studio 및 Visual Studio 2019(버전 16.5 이상)에서, 자동 프로비저닝은 기본적으로 명시적 앱 ID 대신 Info.plist에 지정된 번들 식별자를 기반으로 와일드카드 앱 ID 및 프로비저닝 프로필을 만들고 사용하려고 시도합니다.In Visual Studio for Mac and Visual Studio 2019 (version 16.5 or greater), automatic provisioning will by default attempt to create and use a wildcard App ID and provisioning profile instead of an explicit App ID based on the Bundle Identifier specified in Info.plist. 와일드카드 앱 ID는 프로필 및 Apple Developer Portal에서 유지 관리하는 ID 수를 줄입니다.Wildcard App IDs reduce the number of profiles and IDs to maintain in the Apple Developer Portal.

경우에 따라 앱의 자격에는 명시적인 앱 ID가 필요합니다.In some cases, an app's entitlements require an explicit App ID. 다음 자격은 와일드카드 앱 ID를 지원하지 않습니다.The following entitlements do not support wildcard App IDs:

  • 앱 그룹App Groups
  • 연결된 도메인Associated Domains
  • Apple PayApple Pay
  • Game CenterGame Center
  • HealthKitHealthKit
  • HomeKitHomeKit
  • 핫스폿Hotspot
  • 앱에서 바로 구매In-App purchase
  • 다중 경로Multipath
  • NFCNFC
  • Personal VPN(개인 VPN)Personal VPN
  • 푸시 알림Push Notifications
  • 무선 액세서리 구성Wireless Accessory Configuration

앱에서 해당 자격 중 하나를 사용하는 경우 Visual Studio는 와일드카드 앱 ID 대신 명시적인 앱 ID를 만들려고 시도합니다.If your app uses one of these entitlements, Visual Studio will attempt to create an explicit (instead of a wildcard) App ID.

문제 해결Troubleshoot

  • 새 Apple 개발자 계정이 승인되기까지 몇 시간 정도 걸릴 수 있습니다.It may take several hours for a new Apple developer account to be approved. 계정이 승인되기 전까지는 자동 프로비저닝을 사용할 수 없습니다.You will not be able to enable automatic provisioning until the account has been approved.
  • 자동 프로비저닝 프로세스가 Authentication Service Is Unavailable 오류 메시지와 함께 실패할 경우, App Store Connect 또는 appleid.apple.com에 로그인하여 최신 서비스 계약에 동의했는지 확인하세요.If the automatic provisioning process fails with the error message Authentication Service Is Unavailable, sign in to either App Store Connect or appleid.apple.com to check that you have accepted the latest service agreements.
  • Authentication Error: Xcode 7.3 or later is required to continue developing with your Apple ID. 오류 메시지가 표시된다면 선택한 팀에 Apple Developer Program에 대한 유효한 유료 멤버 자격이 있는지 확인하세요.If you get the error message Authentication Error: Xcode 7.3 or later is required to continue developing with your Apple ID., make sure that the team selected has an active paid membership to the Apple Developer Program. 유료 Apple 개발자 계정을 사용하려면 Xamarin.iOS 앱에 대한 체험 프로비저닝 가이드를 참조하세요.To use a paid Apple developer account, please see the Free provisioning for Xamarin.iOS apps guide.