Share via

iOS 앱에 대한 수동 프로비저닝

  • 아티클

수동 프로비전은 생성되는 프로비저닝 데이터를 완전히 제어할 수 있는 디바이스에 .NET 다중 플랫폼 앱 UI(.NET MAUI) iOS 앱을 배포하는 방법입니다. 이 방법을 사용하면 Apple 개발자 계정에서 서명 ID, 앱 ID 및 프로비저닝 프로필을 수동으로 만들고 관리한 다음, 이 데이터를 Visual Studio에 다운로드해야 합니다. 수동 프로비저닝 프로세스를 시작하기 전에 Apple 개발자 계정을 Visual Studio에 추가했는지 확인해야 합니다. 자세한 내용은 Apple 계정 관리를 참조하세요.

개발 팀, 인증서 및 프로필은 모두 Apple 개발자 계정의 인증서, 식별자 및 프로필 섹션에 액세스하여 관리할 수 있습니다.

서명 인증서 만들기

수동 프로비저닝을 사용하면 개발 디바이스를 설정하는 첫 번째 단계는 개발 인증서와 프라이빗 키로 구성된 서명 인증서를 만드는 것입니다.

개발 인증서 및 관련 키는 Apple과 ID를 설정하고 개발을 위한 특정 디바이스 및 프로필과 연결합니다. 이는 앱에 디지털 서명을 추가하는 것과 유사합니다. Apple은 이러한 인증서를 사용하여 특정 디바이스에만 앱을 배포할 수 있도록 합니다.

Important

한 번에 두 개의 iOS 개발 인증서만 사용할 수 있습니다. 더 만들어야 하는 경우에는 기존 인증서를 해지해야 합니다. 해지된 인증서를 사용하는 모든 컴퓨터는 앱에 서명할 수 없습니다.

Apple 개발자 계정을 Visual Studio에 추가한 후에는 서명 인증서를 생성해야 합니다.

  1. Visual Studio에서 도구 > 옵션 > Xamarin > Apple 계정으로 이동합니다.
  2. Apple 개발자 계정 대화 상자에서 팀을 선택한 다음 세부 정보 보기를 선택합니다.
  3. 세부 정보 대화 상자에서 인증서>iOS 개발 만들기를 선택합니다. 올바른 권한이 있는 경우 새 서명 ID가 만들어지고 Apple과 동기화됩니다.

Important

IDE가 쌍을 이루는 경우 서명 ID를 구성하는 프라이빗 키 및 인증서도 Mac 빌드 호스트의 키 집합 액세스로 내보내집니다. 자세한 내용은 iOS 개발을 위해 Mac에 페어링을 참조하세요.

인증서 키 쌍 이해

개발자 프로필에는 인증서, 연결된 키 및 Apple 개발자 계정과 연결된 프로비저닝 프로필이 포함됩니다. 개발자 프로필에는 두 가지 버전이 있습니다. 하나는 Apple 개발자 계정에 있고 다른 버전은 로컬 컴퓨터에 있습니다. 두 키의 차이점은 포함된 키 유형입니다. Apple 개발자 계정의 프로필에는 인증서와 연결된 모든 공개 키가 포함되고 로컬 컴퓨터의 복사본에는 모든 프라이빗 키가 포함됩니다. 인증서가 유효하려면 키 쌍이 일치해야 합니다.

Warning

기존 인증서를 해지하고 연결된 디바이스를 다시 프로비저닝해야 하므로 인증서 및 연결된 키를 분실하는 것은 매우 중단될 수 있습니다. 개발 인증서를 성공적으로 설정한 후 백업 복사본을 내보내 안전한 장소에 저장합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 help.apple.com 개발자 계정 내보내기를 참조하세요.

개발용 iOS 디바이스 프로비저닝

서명 인증서를 만든 후에는 디바이스에 앱을 배포할 수 있도록 개발 프로비저닝 프로필을 설정해야 합니다. 디바이스는 Xcode에서 지원하는 iOS 버전을 실행해야 합니다.

디바이스 추가

프로비저닝 프로필을 만들 때 프로필에는 앱을 실행할 수 있는 디바이스가 포함되어야 합니다. 프로비전 프로필에 추가할 디바이스를 선택하기 전에 먼저 Apple 개발자 계정에 디바이스를 추가해야 합니다. 다음 단계를 사용하여 디바이스를 추가할 수 있습니다.

  1. USB 케이블을 사용하여 로컬 Mac에 프로비전할 디바이스를 커넥트.

  2. Xcode를 열고 창 > 디바이스 및 시뮬레이터로 이동합니다.

  3. Xcode에서 디바이스 탭을 선택하고 연결된 디바이스 목록에서 디바이스를 선택합니다.

  4. Xcode에서 식별자 값을 클립보드에 복사합니다.

    Xcode devices and simulator window with the iOS identifier string location highlighted.

  5. 웹 브라우저에서 Apple 개발자 계정의 디바이스 섹션으로 이동하여 단추를 클릭합니다 + .

  6. 새 디바이스 등록 페이지에서 올바른 플랫폼을 설정하고 새 디바이스의 이름을 제공합니다. 그런 다음 클립보드의 식별자를 UDID(디바이스 ID) 필드에 붙여넣고 계속을 클릭합니다.

    Register a device by naming it and entering its unique device identifier.

  7. 새 디바이스 등록 페이지에서 정보를 검토한 다음 등록을 클릭합니다.

.NET MAUI iOS 앱을 배포하려는 iOS 디바이스에 대해 이전 단계를 반복합니다.

앱 ID 만들기

Apple 개발자 계정에 디바이스를 추가한 후 앱 ID를 만들어야 합니다. 앱 ID는 앱을 고유하게 식별하는 역방향 DNS 문자열과 유사하며 앱의 번들 식별자와 동일해야 합니다.

Important

.NET MAUI 앱의 번들 식별자는 프로젝트 파일에 애플리케이션 ID 속성으로 저장됩니다.

  • Visual Studio의 솔루션 탐색기 .NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 그런 다음 MAUI 공유 > 일반 탭으로 이동합니다. 애플리케이션 ID 필드에는 번들 식별자가 나열됩니다.
  • Mac용 Visual Studio 솔루션 창에서 .NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 그런 다음 프로젝트 속성 창에서 앱 정보 빌드 > 탭을 선택합니다. 애플리케이션 ID 필드에는 번들 식별자가 나열됩니다.

애플리케이션 ID 필드의 값이 업데이트되면 Info.plist의 번들 식별자값이 자동으로 업데이트됩니다.

앱 ID에는 두 가지 유형이 있습니다.

  • 와일드카드. 와일드 카드 앱 ID를 사용하면 단일 앱 ID를 사용하여 여러 앱을 일치시킬 수 있으며 일반적으로 형식com.domainname.*을 사용합니다. 와일드 카드 앱 ID는 디바이스에 대부분의 앱을 설치하는 데 사용할 수 있으며 앱별 기능을 사용하도록 설정하지 않는 앱에 사용해야 합니다.
  • 명시적. 명시적 앱 ID는 단일 앱에 고유하며 일반적으로 형식 com.domainname.myid을 사용합니다. 명시적 앱 ID를 사용하면 일치하는 번들 식별자가 있는 하나의 앱을 디바이스에 설치할 수 있습니다. 명시적 앱 ID는 일반적으로 Apple Pay 또는 Game Center와 같은 앱별 기능을 사용하도록 설정하는 앱에 사용됩니다.

앱에서 앱별 기능을 사용하지 않는 한 야생 카드 앱 ID를 만드는 것이 좋습니다. 기능에 대한 자세한 내용은 기능을 참조 하세요.

다음 단계를 사용하여 야생 카드 앱 ID를 만들 수 있습니다.

  1. 웹 브라우저에서 Apple 개발자 계정의 식별자 섹션으로 이동하여 단추를 클릭합니다 + .

  2. 새 식별자 등록 페이지에서 앱 ID를 선택하고 계속 단추를 클릭합니다.

  3. 새 식별자 등록 페이지에서 앱 유형을 선택하고 계속 단추를 클릭합니다.

  4. 앱 ID 등록 페이지에서 설명을 제공하고 번들 ID를 Wild카드로 설정합니다. 그런 다음 형식으로 앱 ID를 com.domainname.* 입력하고 계속 단추를 클릭합니다.

    Screenshot of new App ID registration page with required fields populated.

  5. 앱 ID 확인 페이지에서 정보를 검토한 다음 등록 단추를 클릭합니다.

개발 프로비저닝 프로필 만들기

앱 ID가 만들어지면 개발 프로비저닝 프로필을 만들어야 합니다. 프로비저닝 프로필에는 프로필과 관련된 앱(또는 앱이 야생인 경우카드 앱 ID), 프로필을 사용할 수 있는 사용자(추가된 개발자 인증서에 따라 다름), 앱을 설치할 수 있는 디바이스에 대한 정보가 포함됩니다.

다음 단계를 사용하여 개발 프로비저닝 프로필을 만들 수 있습니다.

  1. 웹 브라우저에서 Apple 개발자 계정의 프로필 섹션으로 이동하여 단추를 클릭합니다 + .

  2. 새 프로비저닝 프로필 등록 페이지의 개발 섹션에서 iOS 앱 개발을 선택하고 계속 단추를 클릭합니다.

    Screenshot of creating a provisioning profile for iOS app development.

  3. 프로비전 프로필 생성 페이지에서 사용할 앱 ID를 선택한 다음 계속 단추를 클릭합니다.

    Screenshot of adding an App ID to a provisioning profile.

  4. 프로비전 프로필 생성 페이지에서 프로비저닝 프로필에 포함할 인증서를 선택한 다음 계속 단추를 클릭합니다.

    Screenshot of adding a certificate to a provisioning profile.

  5. 프로비전 프로필 생성 페이지에서 앱이 설치될 디바이스를 선택한 다음 계속 단추를 클릭합니다.

    Screenshot of adding a device to a provisioning profile.

  6. 프로비전 프로필 생성 페이지에서 프로비저닝 프로필 이름을 입력한 다음 생성 단추를 클릭합니다.

    Screenshot of naming a provisioning profile.

  7. 프로비전 프로필 생성 페이지에서 필요에 따라 다운로드 단추를 클릭하여 프로비저닝 프로필을 다운로드할 수 있습니다.

Visual Studio에서 프로비저닝 프로필 다운로드

Apple 개발자 계정에서 개발 프로비저닝 프로필을 만든 후 Visual Studio에서 앱에 서명할 수 있도록 다운로드할 수 있습니다.

  1. Visual Studio에서 도구 > 옵션 > Xamarin > Apple 계정으로 이동합니다.
  2. Apple 개발자 계정 대화 상자에서 팀을 선택하고 세부 정보 보기... 단추를 클릭합니다.
  3. 세부 정보 대화 상자에서 새 프로필이 프로비전 프로필 목록에 표시되는지 확인합니다. 목록을 새로 고치려면 Visual Studio를 다시 시작해야 할 수 있습니다.
  4. 세부 정보 대화 상자에서 모든 프로필 다운로드 단추를 클릭합니다.

프로비저닝 프로필은 Windows에서 다운로드되고 IDE가 쌍을 이루는 경우 Mac 빌드 호스트로 내보냅니다. 자세한 내용은 iOS 개발을 위해 Mac에 페어링을 참조하세요.

수동 프로비저닝 사용

개발 프로비저닝 프로필을 수동으로 만들고 Visual Studio에 설치한 후에는 수동 프로비저닝을 사용하도록 .NET MAUI 앱 프로젝트를 구성해야 합니다.

  1. 솔루션 탐색기 .NET MAUI 앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 그런 다음 MAUI 공유 > 일반 탭으로 이동하여 애플리케이션 ID 필드의 값이 이전에 만든 앱 ID의 형식에 해당하는지 확인합니다.

  2. 프로젝트 속성에서 iOS 번들 서명 탭으로 이동하여 스키마 드롭다운에서 수동 프로비저닝이 선택되어 있는지 확인합니다.

    Screenshot of bundle signing tab for iOS in Visual Studio.

  3. 번들 서명 속성에서 서명 ID 및 프로비저닝 프로필을 선택하거나 둘 다 자동으로 설정합니다. 서명 ID와 프로비전 프로필이 모두 자동으로 설정되면 Visual Studio는 Info.plist의 번들 식별자(프로젝트 파일의 애플리케이션 ID 속성 값과 동일)에 따라 서명 ID 및 프로비저닝 프로필을 선택합니다.

디바이스에 배포

.NET MAUI 앱 프로젝트에서 프로비저닝을 구성한 후 디바이스에 앱을 배포할 수 있습니다.

  1. Visual Studio에서 IDE가 Mac 빌드 호스트와 쌍을 이루는지 확인합니다. 자세한 내용은 iOS 개발을 위해 Mac에 페어링을 참조하세요.

  2. iOS 디바이스가 USB 또는 WiFi를 통해 Mac 빌드 호스트에 연결되어 있는지 확인합니다. 무선 배포에 대한 자세한 내용은 .NET MAUI iOS 앱용 무선 배포를 참조 하세요.

  3. Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 iOS 원격 디바이스를 선택한 다음 Mac 빌드 호스트에 연결된 디바이스를 선택합니다.

    Select your remote device in Visual Studio.

  4. Visual Studio 도구 모음에서 녹색 시작 단추를 눌러 원격 디바이스에서 앱을 시작합니다.

    Visual Studio iOS device debug target choice.

참고 항목

디바이스에 .NET MAUI iOS 앱을 배포하는 다른 방법은 핫 다시 시작을 사용하는 것입니다. 핫 다시 시작을 사용하면 Mac 빌드 호스트 없이 Visual Studio에서 .NET MAUI 앱을 64비트 로컬 iOS 디바이스에 배포할 수 있습니다. 자세한 내용은 핫 다시 시작을 사용하여 iOS 앱 배포를 참조 하세요.

애플리케이션 서비스 프로비전

Apple은 .NET MAUI iOS 앱에 대해 활성화할 수 있는 기능이라고 하는 다양한 애플리케이션 서비스를 제공합니다. 이러한 기능은 프로비전 프로필, 앱 ID를 만들 때 및 .NET MAUI 앱 프로젝트에 추가해야 하는 Entitlements.plist 파일 모두에서 구성되어야 합니다. 기능에 대한 자세한 내용은 권한 및 기능을 참조하세요.