Xamarin.iOS에 대한 수동 프로비전Manual 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 manual provisioning to set up development certificates and profiles.

참고

이 페이지에서 지침은 Apple 개발자 프로그램에 대한 유료 액세스 권한을 가진 개발자와 관련이 있습니다.The instructions on this page are relevant for developers who have paid access to the Apple Developer Program. 무료 계정이 있는 경우 디바이스 테스트에 대한 자세한 내용은 무료 프로 비전 가이드를 살펴보세요.If you have a free account, please take a look at the Free provisioning guide for more information about on-device testing.

서명 ID 만들기Creating a signing identity

개발 디바이스를 설정하는 첫 번째 단계는 서명 ID를 만드는 것입니다.The first step in setting up a development device is to create a signing identity. 서명 ID는 다음 두 가지로 구성됩니다.A signing identity consists of two things:

  • 개발 인증서A Development Certificate
  • 프라이빗 키A private key

개발 인증서 및 연결된 는 iOS 개발자에게 중요합니다. Apple의 ID를 설정하여 애플리케이션에 디지털 서명을 넣는 것처럼 개발용 특정 디바이스 및 프로필에 연결합니다.Development certificates and associated keys are critical for an iOS developer: they establish your identity with Apple and associate you with a given device and profile for development, akin to putting your digital signature on your applications. Apple은 인증서를 확인하여 배포하도록 허용된 디바이스에 대한 액세스를 제어합니다.Apple checks for certificates to control access to the devices you are allowed to deploy.

개발 팀, 인증서 및 프로필의 Apple Members Center의 인증서, 식별자 및 프로필(로그인 필수) 섹션에 액세스하여 관리할 수 있습니다.Development teams, certificates, and profiles can be managed by accessing the Certificates, Identifiers & Profiles (login required) section of Apple's Member Center. 디바이스 또는 시뮬레이터용 코드를 빌드하려면 Apple에 서명 ID가 필요합니다.Apple requires you to have a signing identity to build your code for device or simulator.

중요

한 번에 iOS 개발 인증서 두 개만 가질 수 있다는 점에 유의해야 합니다.It is important to note that you can only have two iOS Development certificates at any one time. 더 만들어야 하는 경우에는 기존 인증서를 해지해야 합니다.If you need to create any more, you will need to revoke an existing one. 해지된 인증서를 사용하는 모든 컴퓨터는 앱에 서명할 수 없습니다.Any machine using a revoked certificate will not be able to sign their app.

서명 ID를 생성하려면 다음을 수행합니다.To Generate a signing identity, do the following:

  1. 개발자 포털의 Certificates, Identifiers, and Profiles(인증서, 식별자 및 프로필) 섹션에 로그인하여 iOS 앱 열에서 인증서 섹션을 선택합니다.Login to the Certificates, Identifiers, and Profiles section of the Developer Portal and select the Certificates section from the iOS Apps column. 그런 다음, + 를 눌러서 새 인증서를 만듭니다.Then, hit the + to create a new certificate:

  2. 인증서 유형에 iOS App Development(iOS 앱 개발) 옵션을 선택하고 계속을 클릭합니다.Select the iOS App Development option for the certificate type and click Continue. 이 화면은 계정 권한에 따라 다르게 보일 수 있습니다.This screen may look different depending on your account privileges:

  3. 인증서를 수동으로 생성하기 위해 업로드할 인증서 서명 요청을 요청합니다.Request a Certificate Signing Request, which will be uploaded to generate a certificate manually. 이렇게 하려면 Mac에서 Keychain Access(키 집합 액세스)를 시작합니다.To do this, launch Keychain Access on a Mac. 주 메뉴로 이동하여 아래 그림과 같이 Certificate Assistant(인증서 도우미) 및 Request a Certificate from a Certificate Authority... (인증 기관의 인증서 요청)를 선택합니다.Navigate to the main menu, and select Certificate Assistant and Request a Certificate from a Certificate Authority..., as illustrated below:

  4. 정보를 입력하고 디스크에 저장 옵션을 선택합니다.Fill in your information, and select the option to Save to disk:

  5. 쉽게 찾을 수 있는 위치에 CSR을 저장합니다.Save the CSR at a location where it can be easily found:

  6. 프로비전 포털로 돌아가서 포털에 인증서를 업로드하고 제출합니다.Return to the Provisioning Portal, upload the Certificate to the portal, and submit:

    관리자 권한이 없는 경우에는 관리자 또는 팀 에이전트가 인증서를 승인해야 합니다.If you do not have admin privileges, the Certificate must be approved by an admin or team agent.

  7. 인증서가 승인되면 프로비전 포털에서 다운로드합니다.Once the Certificate is approved, download it from the Provisioning Portal:

  8. 다운로드한 인증서를 두 번 클릭하여 키 집합 액세스를 시작하고 My Certificates(내 인증서) 패널을 열어서 새 인증서 및 연결된 프라이빗 키를 표시합니다.Double-click on the downloaded Certificate to launch Keychain Access and open the My Certificates panel, showing the new certificate(s), and associated private key:

인증서 키 쌍 이해Understanding certificate key pairs

개발자 프로필에는 인증서, 이와 연결된 키, 계정과 연결된 프로비전 프로필에 포함됩니다.The Developer Profile contains certificates, their associated keys, and any provisioning profiles associated with the account. 실제로 개발자 프로필에는 두 가지 버전이 있습니다. 한 가지는 개발자 포털에 있고 나머지는 로컬 Mac에 있습니다.There are actually two versions of a Developer Profile — one is on the Developer Portal, and the other lives on a local Mac. 이 두 가지의 차이점은 포함된 키의 유형입니다. 포털의 프로필에는 인증서와 연결된 모든 퍼블릭 키가 있지만 로컬 Mac의 복사본에는 모든 프라이빗 키가 포함됩니다.The difference between the two is the type of keys they contain: the Profile on the Portal houses all the public keys associated with your certificates, while the copy on your local Mac contains all the private keys. 인증서가 유효하려면 키 쌍이 일치해야 합니다.For the certificates to be valid, the key pairs must match. 로컬 Mac에 개발자 프로필의 백업을 유지해야 합니다. 프라이빗 키가 손실되면 모든 인증서와 프로비전 프로필을 다시 생성해야 하기 때문입니다.Keep a backup of the Developer Profile on the local Mac, because if the private keys are lost, all the certificates and provisioning profiles will need to be regenerated.

경고

인증서 및 연결된 키가 손실되면 엄청난 혼란을 겪을 수 있습니다. 기존 인증서를 해지해야 하고 연결된 모든 디바이스(임의 배포용으로 등록된 디바이스 포함)를 다시 프로비전해야 하기 때문입니다.Losing the certificate and associated keys can be incredibly disruptive, as it will require revoking existing certificates and re-provisioning any associated devices, including those registered for ad-hoc deployment. 개발 인증서 설정이 완료된 후에는 백업 복사본을 내보내서 안전한 곳에 보관하십시오.After successfully setting up Development Certificates, export a backup copy and store them in a safe place. 이 작업을 수행하는 방법에 대한 자세한 내용은 Apple 설명서 Maintaining Certificates(인증서 유지 관리) 가이드에서 Exporting and Importing Certificates and Profiles(인증서 및 프로필 내보내기 및 가져오기) 섹션을 참조하세요.For more information on how to do this, refer to the Exporting and Importing Certificates and Profiles section of the Maintaining Certificates guide in Apple's docs.

개발용 iOS 디바이스 프로비전Provisioning an iOS Device for development

Apple의 ID를 설정했고 개발 인증서가 준비되었으면 Apple 디바이스에 앱을 배포할 수 있도록 프로비전 프로필 및 필요한 엔터티를 설정해야 합니다.Now that you’ve established your identity with Apple and have a development certificate, you must set up a provisioning profile and the required entities so it is possible to deploy an app to an Apple device. Xcode에서 지원하는 iOS 버전을 디바이스에서 실행해야 합니다. 디바이스, Xcode 또는 둘 다를 업데이트해야 할 수도 있습니다.The device must be running a version of iOS that is supported by Xcode — it may be necessary to update the device, Xcode or both.

디바이스 추가Add a device

개발용 프로비전 프로필을 만드는 경우 어떤 디바이스가 애플리케이션을 실행할 수 있는지 명시해야 합니다.When creating a provisioning profile for development, we must state which devices can run the application. 이를 위해서는 연간 최대 100개의 디바이스를 개발자 포털에 추가할 수 있으며 이 곳에서 특정 프로비전 프로필에 추가할 디바이스를 선택할 수 있습니다.To enable this, up to 100 devices per calendar year can be added to our Developer Portal, and from here we can select the devices to be added to a particular provisioning profile. 개발자 포털에 디바이스를 추가하려면 Mac에서 다음 단계를 수행합니다.Follow the steps below on your Mac to add a device to the Developer Portal

  1. Xcode를 시작합니다.Start Xcode.

  2. 프로비전할 디바이스를 제공된 USB 케이블을 사용하여 Mac에 연결합니다.Connect the device to be provisioned to the Mac with its supplied USB cable.

  3. 메뉴에서 디바이스를 선택합니다.From the Windows menu select Devices:

  4. 디바이스 창 왼쪽의 디바이스 목록에서 원하는 iOS 디바이스를 선택합니다.Select the desired iOS device from the DEVICES list on the left side of the Devices Window.

  5. 식별자 문자열을 선택하여 클립보드로 복사합니다.Highlight the Identifier string and copy it to the clipboard:

  6. Safari에서 Apple Developer Center로 이동하여 로그인합니다.In Safari, navigate to the Apple Developer Center and log in.

  7. Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필) 링크를 클릭합니다.Click the Certificates, Identifiers & Profiles link:

  8. 디바이스 링크를 클릭합니다.Click on the Devices link:

  9. + 단추를 클릭합니다.Click the + button:

  10. 새 디바이스의 이름을 입력하고 위에서 복사한 디바이스 식별자UUID 필드에 붙여 넣습니다.Provide a name for the new device and paste the device Identifier that we copied above into the UUID field:

  11. 계속 단추를 클릭합니다.Click the Continue button.

  12. 마지막으로, 정보를 검토하고 등록 단추를 클릭합니다.Finally, review the information and click the Register button:

Xamarin.iOS 애플리케이션을 테스트하거나 디버그하는 데 사용할 iOS 디바이스에 위의 단계를 반복합니다.Repeat the above steps for any iOS device that will be used to test or debug a Xamarin.iOS application.

개발자 포털에 디바이스를 추가한 후에는 프로비전 프로필을 만들어서 이 프로필에 디바이스를 추가해야 합니다.After adding the device to the developer portal, it is necessary to create a provisioning profile and add the device to it.

개발 프로비전 프로필 만들기Creating a development provisioning profile

개발 인증서와 마찬가지로 프로비전 프로필은 Apple Members Center의 Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필) 섹션을 통해 수동으로 생성할 수 있습니다.As with the Development Certificate, Provisioning Profiles can be manually created through the Certificates, Identifiers & Profiles section of Apple's Members Center.

프로비전 프로필을 만들기 전에는 앱 ID를 만들어야 합니다.Before creating a provisioning profile, an App ID must be made. 앱 ID는 애플리케이션을 고유하게 식별하는 역방향 DNS 스타일 문자열입니다.An App ID is a reverse-DNS style string that uniquely identifies an application. 아래 단계는 대부분의 애플리케이션을 빌드하고 설치하는 데 사용할 수 있는 와일드 카드 앱 ID를 만드는 방법을 보여줍니다.The steps below will demonstrate how to create a Wildcard App ID, which can be used to build and install most applications. Explicit App ID(명시적 앱 ID)는 애플리케이션(일치하는 번들 ID 포함)을 하나만 설치할 수 있으며 일반적으로 Apple Pay 및 HealthKit와 같은 특정 iOS 기능에 사용됩니다.Explicit App IDs only allow the installation of one application (with the matching bundle ID), and are generally used for certain iOS features such as Apple Pay and HealthKit. 명시적 앱 ID를 만드는 방법에 대한 자세한 내용은 기능 사용 가이드를 참조하세요.For information on creating Explicit App IDs, refer to the Working with Capabilities guide.

앱 IDApp ID

  1. 개발자 포털에서 Apple Developer Center의 Certificate, Identifiers and Profiles(인증서, 식별자 및 프로필) 섹션으로 이동합니다.In the developer portal browse to the Certificate, Identifiers and Profiles section in the Apple Developer Center. 식별자 아래에서 앱 ID를 선택합니다.Select App IDs under Identifiers.

  2. + 단추를 클릭하고 이름을 지정합니다.Click the + button and provide a Name:

  3. App 접두사를 미리 설정해야 합니다.The App prefix should be preset. 앱 접미사에 대한 Wildcard App ID(와일드카드 앱 ID)를 선택합니다.Select Wildcard App ID for the app suffix. 번들 ID를 com.[DomainName].* 형식으로 입력합니다.Enter a Bundle ID in the format com.[DomainName].*:

  4. 계속 단추를 클릭하고 화면의 지침에 따라 새 앱 ID를 만듭니다.Click the Continue button and following the on screen instructions to create the new App ID.

프로비전 프로필Provisioning profile

앱 ID를 만든 후에는 프로비전 프로필을 생성할 수 있습니다.Once the App ID has been created, the Provisioning Profile can be produced. 프로비전 프로필에는 어떤 앱(와일드카드 앱 ID인 경우 여러 앱)이 프로필과 연결되어 있는지, 누가 프로필을 사용할 수 있는지(추가된 개발자 인증서에 따라), 어떤 디바이스에 앱을 설치할 수 있는지에 대한 정보가 포함됩니다.This Provisioning Profile contains information on what app (or apps, if it's a wildcard app ID) this profile relates to, who can use the profile (depending on what developer certificates are added), and what devices can install the app.

개발용 프로비전 프로필을 수동으로 만들려면 다음을 수행합니다.To manually create a provisioning profile for development, do this:

  1. Safari를 사용하여 Apple Developers Member Center로 이동하고 Certificates, Identifiers & Profiles(인증서, 식별자 및 프로필) 섹션에서 프로비전 프로필을 선택합니다.Use Safari to browse to the Apple Developers Member Center, and under the section Certificates, Identifiers & Profiles select Provisioning Profiles.

  2. 오른쪽 위 모서리에 있는 + 단추를 눌러서 새 프로필을 만듭니다.Click the + button, in the top right corner to create a new profile.

  3. 개발 섹션에서 iOS App Development(iOS 앱 개발) 옆에 있는 라디오 단추를 선택하고 계속을 누릅니다.From the Development section, select the radio button next to iOS App Development, and press Continue:

  4. 드롭다운 메뉴에서 사용할 앱 ID를 선택합니다.From the dropdown menu, select the App ID that to use:

  5. 프로비전 프로필에 포함할 인증서를 선택하고 계속을 누릅니다.Select the Certificate(s) to include in the provisioning profile, and press Continue:

  6. 앱을 설치할 모든 디바이스를 선택합니다.Select all the devices that the app will be installed on.

  7. 프로비전 프로필에 식별 가능한 이름을 제공하고 계속을 눌러서 프로필을 만듭니다.Provide the Provisioning Profile with an identifiable a name, and press Continue to create the profile:

  8. 다운로드를 눌러서 Mac에 프로비전 프로필을 다운로드합니다.Press Download to download the provisioning profile onto a Mac:

  9. 파일을 두 번 클릭하여 Xcode에 프로비전 프로필을 설치합니다.Double-click on the file to install the provisioning profile in Xcode. 여는 것을 제외하고 Xcode에는 프로필이 설치되었다는 시각적인 단서가 표시되지 않을 수 있습니다.Note that Xcode might not show any visual clues that it has installed the profile except for opening. 이것은 Xcode > 기본 설정 > 계정으로 이동하여 확인할 수 있습니다.This can be verified by browsing to Xcode > Preferences > Accounts. Apple ID를 선택하고 자세히 보기... 를 클릭합니다. 아래 그림과 같이 새 프로비전 프로필이 나열됩니다.Select your Apple ID and click View Details.... Your new provisioning profile should be listed, as illustrated below:

프로비전 프로필 만들기가 완료되면 Mac용 Visual Studio 및 Visual Studio에서 모든 개발 인증서를 사용할 수 있도록 Xcode를 새로 고쳐야 할 수도 있습니다.After the provisioning profile has been successfully created it may be necessary to refresh Xcode so that all the development certificates are available to Visual Studio for Mac and Visual Studio.

Xcode에서 프로필 및 인증서 다운로드Downloading profiles and certificates in Xcode

Apple Developer 포털에서 만든 인증서 및 프로비전 프로필은 Xcode에 자동으로 나타나지 않을 수 있습니다.Certificates and provisioning profiles that have been created in the Apple Developer Portal, may not automatically appear in Xcode. 따라서 Mac용 Visual Studio 및 Visual Studio에서 액세스할 수 있도록 다운로드할 필요가 있습니다.Therefore, it may be necessary to download them so they that they can be accessed by Visual Studio for Mac and Visual Studio. Apple Developer 포털에서 만든 인증서를 업데이트하고 다운로드하려면 다음을 수행합니다.To update and download any certificates created in the Apple Developer portal, do the following:

  1. Mac용 Visual Studio 또는 Visual Studio를 종료합니다.Quit Visual Studio for Mac or Visual Studio.

  2. Xcode를 시작합니다.Start Xcode.

  3. Xcode 메뉴 > 기본 설정... 을 선택합니다.Choose Xcode Menu > Preferences...

  4. 계정 탭을 클릭합니다.Click the Accounts tab.

  5. 팀을 선택하고 수동 프로필 다운로드 단추를 클릭합니다. Select a team and click the Download Manual Profiles button:

  6. Xcode를 종료합니다.Quit Xcode.

  7. Mac용 Visual Studio 또는 Visual Studio를 시작합니다.Start Visual Studio for Mac or Visual Studio.

Mac용 Visual Studio 또는 Visual Studio에 새 인증서 또는 프로비전 프로필이 보이고 사용할 준비가 됩니다.The new certificates or provisioning profiles will be available in Visual Studio for Mac or Visual Studio and ready to use.

중요

Xcode에서 업데이트된 새로운 인증서나 수정된 인증서를 보려면 Mac용 Visual Studio를 중지하고 다시 시작해야 할 수도 있습니다.It may be necessary to stop and restart Visual Studio for Mac before it will see any new or modified certificates or profiles updated by Xcode.

애플리케이션 서비스 프로비전Provisioning for application services

Apple은 Xamarin.iOS 애플리케이션에 활성화할 수 있는 다양한 애플리케이션 서비스(다른 이름: 기능)를 제공합니다.Apple provides a selection of special Application Services, also called capabilities, that can be activated for a Xamarin.iOS application. 이러한 애플리케이션 서비스는 앱 ID를 만들 때 iOS 프로비전 포털에서 구성하고 Xamarin.iOS 애플리케이션 프로젝트에 속하는 Entitlements.plist 파일에서도 구성해야 합니다.These Application Services must be configured on both the iOS Provisioning Portal when the App ID is created and in the Entitlements.plist file that is part of the Xamarin.iOS application's project. 앱에 애플리케이션 서비스를 추가하는 방법에 대한 자세한 내용은 기능 소개 가이드 및 자격 사용 가이드를 참조하세요.For information on adding Application Services to your app, refer to the Introduction to Capabilities guide and the Working with Entitlements guide.

  • 필요한 앱 서비스를 포함하는 앱 ID를 만듭니다.Create an App ID with the required app services.
  • 앱 ID를 포함하는 새로운 프로비전 프로필을 만듭니다.Create a new provisioning profile that contains this App ID.
  • Xamarin.iOS 프로젝트에서 자격 설정Set Entitlements in the Xamarin.iOS Project

디바이스에 배포Deploying to a device

이 시점에서 프로비전은 완료되고, 디바이스에 앱을 배포할 준비가 되어 있어야 합니다.At this point provisioning should be complete, and the app is ready to be deployed to the device. 이렇게 하려면 아래 단계를 수행합니다.To do this, follow the steps below:

중요

시작하기 전에 Info.plist에서 수동 프로비저닝을 선택해야 합니다.Before you begin, make sure to select Manual Provisioning in the Info.plist.

  1. 디바이스를 Mac에 연결합니다.Plug the device in to a Mac.

  2. 프로젝트의 Info.plist에서 번들 식별자가 앱 ID와 일치하도록 합니다(앱 ID가 와일드카드인 경우 제외).In the project's Info.plist, make sure the Bundle Identifier matches the App ID (unless the App ID is a wildcard):

  3. 프로젝트를 마우스 오른쪽 단추로 클릭하여 프로젝트 옵션 대화 상자를 표시하고 빌드 > iOS 번들 서명으로 이동합니다.Right-click on the project to view the Project Options dialog and browse to Build > iOS Bundle Signing. 서명 ID프로비전 프로필 옆에 있는 드롭다운 목록에서 Mac용 Visual Studio에 올바른 프로필이 표시되는지 확인하고 특정 ID와 프로필을 선택합니다.From the drop-down list next to both the Signing Identity and Provisioning Profile, verify that Visual Studio for Mac can see the correct profiles, and select a specific identity & profile:

    자동으로 설정되어 있는 경우 2단계에서 설정한 번들 ID를 기반으로 Mac용 Visual Studio에서 ID와 프로필이 선택됩니다.If this is set to Automatic, Visual Studio for Mac will select the identity and profile based on the Bundle ID that was set in step #2.

  4. 빌드 구성이 시뮬레이터가 아닌 iPhone / iPad로 설정되어 있는지 확인합니다.Make sure to set the build configuration to iPhone / iPad, rather the simulator.

  5. Mac용 Visual Studio에서 실행을 클릭하여 디바이스에서 실행되는 앱을 봅니다.Click Run in Visual Studio for Mac and view the app running on the device.

요약Summary

이 가이드에서는 Xamarin.iOS용 개발 환경을 설정하는 데 필요한 단계를 설명했습니다.This guide covered the steps required to setup the development environment for Xamarin.iOS. 개발자, 개발자 팀, 앱을 실행할 수 있는 디바이스 및 개별 앱 ID에 대한 정보로 애플리케이션을 코드 서명하는 방법을 알아보았습니다.It explored how an application is code signed with information about the developer, their team, the devices that an app can run on, and individual app id.