언리얼 엔진 프로젝트에 대한 iOS, tvOS 및 iPadOS 프로비저닝 프로파일 및 인증서 사이닝 | 언리얼 엔진 5.5 문서

iOS, iPadOS 및 tvOS 게임을 배포하려면 유효한 Apple Developer임을 보여주는 코드 인증서 사이닝 과 앱에 필요한 서비스와 권한을 보여주는 프로비저닝 프로파일 이 필요합니다. Xcode 에서 자동으로 코드 빌드를 위해 이 프로세스를 자동으로 관리하지만 언리얼 엔진 빌드 시스템에서 프로젝트를 쿠킹 및 패키징할 수 있도록 언리얼 엔진 프로젝트 세팅에 이를 수동으로 제공해야 합니다. 이 가이드는 유효한 인증서 및 프로비저닝 프로파일을 구성하는 데 필요한 모든 단계를 설명합니다.

이 가이드에서는 MacOS와 Xcode를 사용하는 언리얼 엔진 C++ 프로젝트 빌드의 전체 구성을 다룹니다. App Store에 출시할 프로젝트를 빌드하려면 Xcode가 있는 MacOS 머신이 필요하지만 언리얼 엔진에서는 Windows에서의 작업을 위한 방법을 포함하여 개발 및 테스트 목적으로 iOS 앱을 빌드하기 위한 여러 가지 방법을 제공합니다. 자세한 정보는 부록 B: 추가 빌드 옵션을 참조하세요.

1. 개요 및 요구사항

iOS, tvOS 또는 iPadOS 디바이스용 언리얼 엔진 프로젝트를 빌드 및 배포하려면 다음 요구사항이 필요합니다.

MacOS를 실행하는 컴퓨터.
현재 버전의 언리얼 엔진과 호환되는 Xcode 설치.
Apple Developer 계정.
언리얼 엔진 프로젝트.

현재 버전의 언리얼 엔진에 사용하는 데 필요한 MacOS 및 Xcode 버전에 관한 자세한 정보는 iOS, iPadOS 및 tvOS 개발 요구사항 페이지를 참조하세요. iOS 빠른 시작 가이드에서 언리얼 엔진에 사용할 Xcode 설정 방법에 관한 지침을 알아보세요.

코드 인증서 사이닝 및 프로비저닝 프로파일을 생성하려면 Apple Developer 계정이 필요합니다. 계정이 아직 없는 경우 developer.apple.com에서 Apple ID와 Developer 계정을 생성합니다.

에픽의 소프트웨어는 무료이지만 Apple Developer 계정은 연 $99의 비용이 소요됩니다. 계정을 등록할 때 이 점을 유의하세요.

마지막으로 Apple Developer 계정에서 다음 작업을 수행해야 합니다.

Xcode와 Developer 계정 연결
앱에 대한 식별자(App ID) 생성
앱 배포를 위한 프로비저닝 프로파일 생성
앱의 크리에이터임을 보여주는 인증서 사이닝 생성
계정에 iOS 디바이스 등록

각각을 완료하면 프로비저닝 프로파일과 인증서 사이닝을 다운로드하고 프로젝트 세팅 에 추가해야 합니다. 이후에는 프로젝트를 패키징하고 디바이스로 푸시할 수 있습니다. 이 단계에 대한 자세한 설명은 아래 섹션에서 확인할 수 있습니다.

2. Xcode와 Apple Developer 계정 연결

인증서와 프로비저닝 프로파일이 올바르게 인식되도록 Xcode를 Apple Developer 계정의 Apple ID와 연결합니다.

Xcode를 열고, Xcode > Preferences 를 클릭합니다.
Accounts 탭을 클릭합니다.
Add (+) 를 클릭하고 계정을 추가합니다. Apple Developer 계정 정보를 입력합니다.

3. 식별자(App ID) 생성

모든 iOS 앱에는 번들 ID를 포함한 식별자가 필요합니다. 이후 단계에서 프로비저닝 프로파일이 이 정보를 참조합니다. 다음 단계를 따라 식별자를 생성합니다.

Apple Developer 계정에 로그인합니다.
Certificates, Identifiers, and Profiles 를 클릭합니다.
Identifiers 를 클릭하고 Register an App ID 를 클릭합니다.
App IDs 를 선택하고 Continue 를 클릭합니다.
App 을 선택하고 Continue 를 클릭합니다.
Register an App ID 메뉴에서 Description 및 Bundle ID 를 입력합니다. Bundle ID는 com.(OrganizationDomainName).(AppName) 포맷을 갖는 리버스 도메인 문자열이어야 합니다. 이 예시에서 앱의 이름은 com.YourCompany.MobileTestGame 입니다.

App ID에 입력한 애플리케이션 이름을 기록해 두세요. 이 정보가 언리얼 엔진 프로젝트의 이름과 일치해야 합니다. 특히 확장자를 제외하고 .uproject 파일의 이름이 필요합니다. 또한 Bundle ID가 Xcode 프로젝트와 언리얼 에디터의 프로젝트 세팅 에서 모두 일치해야 합니다.
앱에 필요한 권한과 서비스를 선택하고 Continue 를 클릭합니다.
모든 세팅이 올바른지 확인하고 Register 를 클릭합니다.

4A. Xcode에서 코드 인증서 사이닝 생성

Xcode와 Apple Developer 계정을 연결한 경우 다음 단계를 따라 개발 인증서를 자동으로 생성할 수 있습니다.

Xcode 에서 프로젝트의 솔루션을 열고, 내비게이션 패널에서 프로젝트를 선택합니다. 프로젝트의 세팅이 표시됩니다.
General 세팅에서 프로젝트의 번들 식별자를 입력합니다. com.(OrganizationName).(ProjectName) 포맷의 리버스 도메인 스타일 스트링입니다. 이 예시에서는 com.YourCompany.MobileTestGame 입니다.
Signing and Capabilities 를 클릭합니다. Team 을 Apple Developer 프로파일에서 제공하는 이름으로 설정합니다.
Automatically Manage Signing 을 활성화합니다. Xcode에서 Apple Developer 사이트에 연결하고 개발용 코드 인증서 사이닝을 생성합니다.

이 인증서는 사용자가 설정한 Mac에서만 사용할 수 있으며, 출시가 아닌 개발용으로만 사용 가능합니다.

4B. 수동으로 인증서 사이닝 생성

Xcode에서 생성한 개발 인증서를 통해 테스트를 위해 프로젝트를 배포할 수도 있지만 App Store에 배포하기 위해 구성된 인증서 사이닝을 생성해야 할 수 있습니다. 또한 다른 디바이스에서 팀이 사용할 수 있는 인증서를 생성해야 할 수 있습니다.

다음 단계를 따라 Apple Developer 계정을 사용하여 인증서를 수동으로 생성하세요.

Keychain Access 앱을 엽니다. Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority 를 클릭합니다.
Certificate Information 다이얼로그에 Apple Developer 이메일 주소와 이름을 입력합니다. Continue 를 클릭하고 사이닝 요청을 바탕화면과 같이 편리한 위치에 저장합니다.
Apple Developer 페이지 를 엽니다. Certificates, Identifiers, and Profiles 메뉴에서 Certificates 를 클릭한 다음 Create a Certificate 를 클릭합니다.
iOS App Development 를 선택하고 Continue 를 클릭합니다. 앱 출시를 위한 인증서를 생성하는 경우 iOS Distribution (App Store and Ad Hoc) 을 대신 사용해야 합니다.
Choose File 을 선택하고 생성한 Certificate Signing Request 파일 을 선택합니다. Continue 를 클릭하여 인증서를 생성합니다.
인증서를 다운로드하고 연 다음 System Keychain에 추가합니다.

6. 프로비저닝 프로파일 생성

앱의 프로비저닝 프로파일은 Apple Developer로서의 신원, 테스트 디바이스에 관한 정보 및 앱의 권한 정보를 함께 연결합니다. 프로비저닝 프로파일을 생성하려면 다음 단계를 따릅니다.

Apple Developer 페이지의 Certificates, Identifiers & Profiles 메뉴에서 Profiles 를 클릭하고 Generate a Profile 을 클릭합니다.
iOS App Development 를 선택하고 Continue 를 클릭합니다.

이 페이지에서는 예시로 iOS 앱을 사용하지만 타깃 디바이스에 맞는 프로비저닝 프로파일 유형을 선택할 수 있습니다. 예를 들어 tvOS 앱을 생성하는 경우 tvOS App Development 를 선택합니다.
App ID 드롭다운을 클릭하고 이전 섹션에서 생성한 App ID를 선택한 다음 Continue 를 클릭합니다.
이전 섹션에서 생성한 개발 용 인증서 사이닝 을 선택하고 Continue 를 클릭합니다.

인증서 사이닝과 프로비저닝 프로파일을 팀 사이에서 공유해야 하는 경우 수동으로 인증서를 생성합니다.
등록된 디바이스를 테스트 디바이스로 선택하고 Continue 를 클릭합니다.
프로비저닝 프로파일 이름 을 입력합니다. 이 예시에서 프로파일의 이름은 MobileTestGame_Development 입니다. Generate 를 클릭합니다.
프로비저닝 프로파일을 다운로드하고 편한 위치에 둡니다. 클릭한 다음 도크에 있는 Xcode 앱 아이콘으로 드래그하여 설치합니다.

7. 프로비저닝 프로파일 및 인증서 사이닝을 언리얼 에디터에 추가

자동으로 코드 사이닝을 관리하도록 설정한 경우 Xcode에서 코드를 빌드하는 데 프로비저닝 프로파일이 필요하지 않습니다. 하지만 언리얼 엔진의 빌드 시스템과 iPhone Packager의 경우 프로비저닝 프로파일 및 인증서 사이닝을 참조해야 프로젝트의 iOS용 실행파일을 쿠킹 및 패키징할 수 있습니다. 언리얼 엔진의 프로젝트 세팅에서 프로비저닝 프로파일 및 인증서 사이닝을 제공하려면 다음 단계를 따릅니다.

언리얼 에디터를 열고 프로젝트 세팅(Project Settings) > 플랫폼(Platforms) > iOS 를 엽니다. 번들 식별자(Bundle Identifier) 가 Xcode 및 Apple Developer 계정에서와 동일한 이름으로 설정되어야 합니다.
에디터가 프로비저닝 프로파일 및 인증서 사이닝을 찾을 때까지 기다립니다. 프로비저닝 프로파일과 인증서 관련 항목이 모두 녹색이 되면 유효한 프로파일로 인식이 되어 자동으로 사용됩니다. 체크 박스를 선택하여 수동으로 설정할 수도 있습니다.

블루프린트 전용 프로젝트와 원격 빌드에 대해 Windows 머신에서 이 섹션의 단계를 수행할 수 있습니다.

프로젝트 세팅에서 선택한 인증서 사이닝은 프로비저닝 프로파일 생성 시 사용한 것과 일치해야 합니다. 그렇지 않은 경우 프로젝트 패키징에 실패합니다.

8. 프로젝트 패키징

플랫폼(Platforms) > iOS > 프로젝트 패키지(Package Project) 를 클릭하여 iOS용으로 패키징합니다. 모든 설정이 올바르고 프로비저닝 프로파일 및 인증서 사이닝이 모두 유효한 경우 UE에서 iOS 빌드가 생성됩니다.
플랫폼(Platforms) 드롭다운을 다시 클릭합니다. iOS 디바이스가 빠른 실행(Quick Launch) 옵션에 표시되는 경우 이를 선택하여 디바이스에 빌드를 직접 배포합니다.

최종 결과

이 가이드의 단계를 따른 후에는 iOS 프로젝트 빌드 및 배포에 필요한 모든 구성 요소를 갖추게 됩니다. 테스트 및 출시를 위해 프로비저닝 프로파일을 생성해야 하는 경우 이 가이드를 다시 참조하고 그에 따라 식별자, 인증서 및 프로비저닝 프로파일을 구성합니다.

부록 A: Apple WWDR(Worldwide Developer Relations) 인증서 획득

Apple에서는 앱 빌드에 Apple Worldwide Developer Relations 인증서를 요구합니다. 이는 Xcode에서 자동으로 제공하지만 상황에 따라 수동으로 Mac에 설치해야 할 수도 있습니다.

Apple Certificate Authority 페이지로 이동하고 최신 WWDR Intermediate 인증서를 다운로드합니다.
Keychain Access 앱을 열고 인증서를 System keychain 에 드래그합니다.

부록 B: 추가 빌드 옵션

이 가이드의 단계는 앱 배포에 필요한 사이닝 및 프로비저닝 프로세스의 전체 단계입니다. 개발 및 테스트 도중 사용 가능한 여러 가지 기타 옵션이 있습니다.

블루프린트 전용 iOS 프로젝트는 빌드를 패키징하거나 테스트를 위해 디바이스로 푸시하는 데 사이닝 및 프로비저닝 프로세스를 거칠 필요가 없으며, 직접 패키징할 수 있습니다. 이 방법은 Windows에서도 사용 가능합니다. 자세한 정보는 Windows에서 iOS용으로 빌드를 참조하세요.
언리얼 엔진을 사용하는 대부분의 팀이 개발에 Windows 머신을 사용하므로 이를 통해 원격 빌드 프로세스를 사용할 수 있습니다. MacOS 디바이스와의 보안 연결이 생성되고 빌드가 자동화됩니다. 자세한 정보는 Windows에서 iOS용으로 빌드 가이드를 참조하세요.

부록 C: 팀과 인증서 사이닝 공유

UE 5.3 이상 버전에서는 개발 빌드의 인증서 사이닝 처리에 자동 코드 사이닝 방식이 선호됩니다. Xcode에서 각 팀원이 연결할 수 있는 공유 Apple 개발자 계정이 팀에 있어야 하고, 이를 통해 모두가 사이닝 및 프로비저닝 리소스에 공동으로 액세스할 수 있습니다.

수동으로 생성한 사이닝 인증서 또는 프로비저닝 프로파일을 공유해야 하는 경우 UE 프로젝트 디렉터리에 Provisioning이라는 폴더를 생성하고, 이 폴더에 사이닝 인증서 또는 프로비저닝 프로파일을 둡니다. 이는 빌드 프로세스에 필요하지 않지만 이를 팀의 소스 컨트롤에 추가하여 필요에 따라 공유할 수 있습니다.