이 퀵스타트 가이드에서는 Apple의 iOS, iPadOS, tvOS 플랫폼용 언리얼 엔진 프로젝트를 빌드하는 데 필요한 모든 단계를 설명합니다. 이 가이드를 완료하면 다음 작업을 수행할 수 있습니다.
Mac에서 Xcode를 구성합니다.
Xcode에서 디바이스에 연결합니다.
Apple 개발자 계정으로 디바이스를 등록합니다.
프로젝트에 대한 프로비저닝 프로파일 및 인증서를 생성합니다.
iOS용 프로젝트를 환경설정합니다.
iOS 디바이스에서 프로젝트를 빌드하고 실행합니다.
이 가이드에서는 C++ 프로젝트에 대해 사이닝된 빌드 생성을 다룹니다. Windows의 블루프린트 전용 프로젝트의 경우 iOS 프로젝트 빌드를 위한 대체 워크플로우가 있습니다. 자세한 내용은 iOS 프로젝트 패키징하기를 참조하세요.
추가로 이 가이드는 iPhone과 iOS를 예시로 하지만 tvOS에도 동일한 구성 단계가 사용됩니다. tvOS 디바이스에 연결하려면 tvOS 디바이스에 연결하기 페이지를 참조하세요.
1. 요구 사항
Apple 플랫폼용 프로젝트를 빌드하려면 다음이 필요합니다.
언리얼 엔진이 설치된 MacOS를 실행하는 컴퓨터
현재 사용 중인 언리얼 엔진 버전과 호환되는 Xcode 설치
Apple 개발자 계정
현재 사용 중인 언리얼 엔진 버전과 호환되는 iOS 디바이스
다음 소프트웨어 버전은 현재 버전의 언리얼 엔진과 호환됩니다.
현재 UE 버전: 5.6
지원되는 타깃 SDK 버전: iOS 15 이상
권장 macOS 및 Xcode 버전
macOS Sonoma 14.7
Xcode 16.1
최소 macOS 및 Xcode 버전
macOS Sonoma 14.5
Xcode 16
다음 iOS 하드웨어 버전은 현재 버전의 언리얼 엔진과 호환됩니다.
iOS 15
iPhone 6S 이상
iPod Touch 7세대
iPadOS 15
iPad 5세대 이상
iPad Air 2 이상
iPad Mini 4 이상
iPad Pro(모든 모델)
tvOS 15
Apple TV HD
Apple TV 4K(1세대)
Apple TV 4K(2세대)
Apple A8/A8X 기반 디바이스(iPad Air 2, iPad Mini 4 및 Apple TV HD)에서 지원을 활성화하려면 프로젝트 세팅이 필요합니다. A8/A8X 디바이스에서는 일부 렌더링 기능이 제한될 수 있습니다.
이전 버전의 언리얼 엔진에 대한 소프트웨어 호환성 정보는 iOS 및 tvOS 개발 요구 사항 페이지를 참조하세요.
2. Xcode 구성하기
Mac에 Xcode가 아직 설치되지 않은 경우 App Store에서 다운로드하고 설치합니다. Apple ID로 로그인해야 합니다.
Xcode를 엽니다. 툴바에서 Xcode > 세팅(Settings)을 엽니다.
위치(Locations) 탭을 연 다음 명령줄 툴(Command Line Tools) 경로가 현재 버전의 Xcode로 설정되어 있는지 확인합니다. 경로가 설정되지 않은 경우 메탈 셰이더 컴파일러가 Xcode를 찾을 수 없으므로 언리얼 에디터를 열 수 없습니다.
3. 프로젝트 생성하기
모바일 프로젝트를 구성하려면 언리얼 에디터를 열고 다음 사양을 사용하여 새 프로젝트를 생성합니다.
Open Unreal Editor. When the Unreal Project Browser appears, click Games.
Configure your project as follows:
Project Template: Top Down
Target Platform: Mobile
Quality Preset: Scalable
Project Name: MobileTestGame
You can create a project that uses either Blueprint or C++.
Click Create to create the project and open it in Unreal Editor.
위의 사양과 프로젝트 이름은 모바일 프로젝트 생성하기 가이드에서 가져온 것입니다. 이러한 사양에 대한 자세한 정보는 해당 페이지를 참조하세요.
4. Xcode로 디바이스를 연결하고 Apple 개발자 계정으로 등록하기
테스트를 위해 iOS 디바이스를 사용하려면 이를 컴퓨터에 연결하고, Xcode에서 이를 인식하는지 확인하고, 이를 앱에 대한 테스팅 디바이스로 Apple Developer 계정에 등록해야 합니다. 디바이스 등록은 이후 프로비저닝 프로파일 생성에 사용됩니다. 다음 단계를 따라 디바이스를 설정합니다.
USB 케이블을 사용하여 iOS 디바이스를 컴퓨터에 연결합니다.
Xcode를 연 다음 창(Window) > 디바이스 및 시뮬레이터(Devices and Simulators)를 클릭합니다.
디바이스를 잠금 해제하여 Xcode의 액세스를 허용합니다. iOS 디바이스에 이 디바이스 신뢰(Trust This Device)라는 메시지가 표시되면 신뢰하기(Trust)를 탭한 다음 패스코드를 입력합니다. Xcode에서 디바이스에 대한 디버그 심볼을 가져옵니다.
developer.apple.com에서 Apple 개발자 계정으로 로그인합니다. Apple ID와 Developer 계정이 없는 경우 생성합니다.
에픽의 소프트웨어는 무료이지만 Apple Developer 계정은 연 $99의 비용이 소요됩니다. 계정을 등록할 때 이 점을 유의하세요.
로그인한 후 인증서, 식별자 및 프로파일(Certificates, Identifiers & Profiles)을 클릭합니다.
디바이스(Device)를 클릭한 다음 디바이스 등록(Register a Device)을 클릭합니다.
디바이스에 관한 다음 정보를 입력합니다.
플랫폼(Platform)을 iOS, tvOS, watchOS로 설정합니다.
디바이스 이름(Device Name)을 고유하고 알아볼 수 있는 이름으로 설정합니다.
Xcode의 Window(창) > 디바이스 및 시뮬레이터(Devices and Simulators)에서 디바이스에 대한 정보를 확인합니다. 식별자(Identifier)를 복사한 다음 디바이스 등록(Register a Device) 페이지로 돌아가 UUID 필드에 붙여넣습니다.
완료하면 계속(Continue)을 클릭합니다.
디바이스에 관한 정보가 올바른지 다시 확인합니다. 잘못된 UUID를 입력한 경우 잘못된 유형의 디바이스가 나열될 수 있습니다. 등록(Register)을 클릭하여 Apple 개발자 계정을 통한 디바이스 등록을 마칩니다. 등록이 완료되면 완료(Done)를 클릭합니다.
5. 프로비저닝 및 사이닝
다음은 iOS 프로젝트 패키징에 필요한 앱의 코드 인증서 사이닝과 프로비저닝 프로파일을 획득하는 방법에 관한 간단한 요약입니다. 자세한 단계는 iOS 프로비저닝 가이드를 참조하세요.
Xcode > 개인설정(Preferences) > 계정(Accounts)에서 Apple 개발자 ID를 Xcode와 연결합니다.
앱의 식별자(앱 ID)를 생성합니다. com.(OrganizationName).(ProjectName) 포맷의 번들 식별자 이름을 입력합니다. 이 예시에서 번들 식별자는 com.YourCompany.MobileTestProject입니다.
프로젝트의 Xcode 프로젝트 파일을 연 다음 앱 ID에 지정한 것과 동일한 번들 식별자가 있는지 확인합니다. 언리얼 에디터의 프로젝트 세팅(Project Settings) > 플랫폼(Platforms) > iOS에서도 동일한 작업을 수행합니다.
서명 및 기능(Signing & Capabilities)에서 서명 자동 관리(Automatically Manage Signing)를 활성화한 다음 팀(Team)을 Apple 개발자 계정과 연결된 이름으로 설정합니다. Xcode에서 자동으로 코드 인증서 사이닝을 생성합니다. 또는 Apple 개발자(Apple Developer) 페이지의 인증서, 식별자 및 프로파일(Certificates, Identifiers, and Profiles) 섹션에서 수동으로 생성할 수도 있습니다.
Apple 개발자 페이지를 연 다음 인증서, 식별자 및 프로파일(Certificates, Identifiers, and Profiles)을 엽니다. 식별자, 등록된 디바이스 및 서명 인증서를 사용하여 새 프로비저닝 프로파일(Provisioning Profile)을 생성합니다. Provisioning 폴더와 같은 편리한 위치에 이 프로파일을 다운로드합니다.
Apple 인증 기관 페이지(Certificate Authority Page)로 이동하여 최신 WWDR 중간 인증서(WWDR Intermediate Certificate)를 다운로드합니다. 키체인 액세스(Keychain Access) 앱을 열고 인증서를 시스템 키체인(System keychain)으로 드래그합니다. 테스트를 위해 프로젝트를 패키징할 필요는 없지만 출시할 때에는 필요합니다.
언리얼 에디터에서 프로젝트를 연 다음 프로젝트 세팅(Project Settings) > 플랫폼(Platform) > iOS를 엽니다. 에디터에서 프로비저닝 프로파일과 인증서 사이닝을 인식할 때까지 기다린 다음 각각을 선택합니다.
6. 프로젝트 패키징
위 섹션을 완료한 후 플랫폼(Platforms) 드롭다운을 클릭하고, iOS > 프로젝트 패키지(Package Project)를 클릭합니다. 모든 구성 요소가 올바르게 구성된 경우 프로젝트가 성공적으로 패키징됩니다. 빠른 실행(Quick Launch) 옵션을 사용하여 선택한 디바이스에서 바로 실행할 수도 있습니다.
최종 결과
이 가이드의 단계를 완료한 후에는 iOS 프로젝트가 구성되어 테스트 디바이스에서 실행할 준비가 완료됩니다.