iOS 퀵스타트 가이드

iOS, tvOS 또는 iPadOS용 언리얼 엔진 프로젝트를 구성합니다.

Choose your operating system:

Windows

macOS

Linux

이 퀵스타트 가이드는 Apple의 iOS, iPadOS 및 tvOS 플랫폼에 맞춰 언리얼 엔진 프로젝트를 빌드할 때 필요한 모든 단계를 설명합니다. 이 가이드를 완료하면 다음 작업을 수행할 수 있습니다.

  • Mac에서 Xcode 설정.

  • Xcode에서 디바이스 연결.

  • Apple Developer 계정에 디바이스 등록.

  • 프로젝트용 프로비저닝 프로파일 및 인증서 생성.

  • iOS용 프로젝트 구성.

  • iOS 디바이스에서 프로젝트 빌드 및 실행.

이 가이드에서는 C++ 프로젝트의 서명된 빌드 생성을 다룹니다. Windows의 블루프린트 전용 프로젝트의 경우 iOS 프로젝트 빌드를 위한 대체 워크플로우가 있습니다. 자세한 내용은 iOS 프로젝트 패키징하기을 참조하세요.

추가로 이 가이드는 iPhone과 iOS를 예시로 하지만 tvOS에도 동일한 구성 단계가 사용됩니다. tvOS 디바이스에 연결하려면 tvOS 디바이스에 연결 페이지를 참조하세요.

1. 요구 사항

Apple 플랫폼용 프로젝트를 빌드하려면 다음이 필요합니다.

  • MacOS를 실행하며 언리얼 엔진이 설치된 컴퓨터

  • 현재 버전의 언리얼 엔진과 호환되는 Xcode 설치

  • Apple Developer 계정.

  • 현재 버전의 언리얼 엔진과 호환되는 iOS 디바이스

다음 소프트웨어 버전은 현재 버전의 언리얼 엔진과 호환됩니다.

  • 현재 UE 버전: 5.0

    • 지원 타깃 SDK 버전: iOS 14 이상

    • 권장 MacOS 및 Xcode 버전

      • 최신 MacOS Monterey

      • 최신 Xcode 13

    • 지원 MacOS 버전

      • MacOS Big Sur 11.6.4

    • 최소 MacOS 및 Xcode 버전

      • MacOS Catalina 10.15.7

      • Xcode 12.4. iOS 15 디바이스의 로컬 테스트를 진행하려면 Xcode 13이 필요합니다.

다음 iOS 하드웨어 버전은 현재 버전의 언리얼 엔진과 호환됩니다.

  • iOS 14

    • iPhone 6S 이상

    • iPod Touch 7세대

  • iPadOS 14

    • iPad 5세대 이상

    • iPad Air 2 이상

    • iPad Mini 4 이상

    • iPad Pro(모든 모델)

  • tvOS 14

    • Apple TV HD

    • Apple TV 4K(1세대)

    • Apple TV 4K(2세대)

이전 버전의 언리얼 엔진과의 소프트웨어 호환성 정보는 iOS 개발 요구 사항 페이지를 참조하세요.

2. 소프트웨어 설치

  1. Mac에 Xcode가 아직 설치되지 않은 경우 App Store에서 다운로드하고 설치합니다. Apple ID를 사용하여 로그인해야 합니다.

    App Store에서 Xcode 다운로드

  2. 설치가 끝나면 Xcode를 열고 Xcode > Preferences 를 클릭한 다음 Locations 탭을 열고 Command Line Tools 경로가 Xcode의 현재 버전으로 설정되어 있는지 확인합니다. 경로가 설정되지 않은 경우 메탈 셰이더 컴파일러가 Xcode를 찾을 수 없으므로 언리얼 에디터를 열 수 없습니다.

    Command Line Tools 경로 설정

3. 프로젝트 생성

모바일 프로젝트를 구성하려면 언리얼 에디터를 열고 다음 사양을 사용하여 새 프로젝트를 생성합니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

  1. 언리얼 에디터 를 엽니다. 언리얼 프로젝트 브라우저(Unreal Project Browser) 가 표시되면 게임(Games) 을 클릭합니다.

  2. 프로젝트를 다음과 같이 구성합니다.

    • 프로젝트 템플릿: 내려보기(Top Down)

    • 타깃 플랫폼: Mobile

    • 퀄리티 프리셋: Scalable

    • 프로젝트 이름: MobileTestGame

블루프린트 또는 C++ 를 사용하는 프로젝트를 생성할 수 있습니다.

  1. 생성 을 클릭하여 프로젝트를 생성하고 언리얼 에디터에서 프로젝트를 엽니다.

위 사양 및 프로젝트 이름은 모바일 프로젝트 만들기 가이드에서 가져온 것입니다. 이러한 사양에 대한 자세한 정보는 해당 페이지를 참조하세요.

4. Xcode와 디바이스를 연결하고 Apple Developer 계정에 등록

테스트를 위해 iOS 디바이스를 사용하려면 이를 컴퓨터에 연결하고, Xcode에서 이를 인식하는지 확인하고, 이를 앱에 대한 테스팅 디바이스로 Apple Developer 계정에 등록해야 합니다. 디바이스 등록은 이후 프로비저닝 프로파일 생성에 사용됩니다. 다음 단계를 따라 디바이스를 설정합니다.

  1. USB 케이블을 사용하여 iOS 디바이스를 컴퓨터에 연결합니다.

  2. Xcode를 열고, Window > Devices and Simulators 를 클릭합니다.

  3. 디바이스를 잠금 해제하여 Xcode의 액세스를 허용합니다. iOS 디바이스에서 Trust This Device 프롬프트가 표시되면 Yes 를 클릭하고 패스코드를 입력합니다. Xcode에서 디바이스에 대한 디버그 심볼을 가져옵니다.

  4. developer.apple.com에서 Apple Developer 계정에 로그인합니다. Apple ID와 Developer 계정이 없는 경우 생성합니다.

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

  5. 로그인하면 Certificates, Identifiers & Profiles 를 클릭합니다.

  6. Devices 를 클릭하고 Register a Device 를 클릭합니다.

  7. 디바이스에 관한 다음 정보를 입력합니다.

    • Platform 을 iOS, tvOS, watchOS로 설정합니다.

    • Device Name 을 고유하고 인식 가능한 이름으로 설정합니다.

    • Window > Devices and Simulators 에서 Xcode 의 디바이스 관련 정보를 살펴봅니다. Identifier 를 복사한 다음 Register a Device 페이지로 돌아가서 UUID 필드에 붙여넣습니다.

    완료되면 Continue 를 클릭합니다.

  8. 디바이스에 관한 정보가 올바른지 다시 확인합니다. 잘못된 UUID를 입력한 경우 잘못된 유형의 디바이스가 나열될 수 있습니다. Register 를 클릭하여 Apple Developer 계정에 디바이스 등록을 완료합니다. 등록이 완료되면 Done 을 클릭합니다.

5. 프로비저닝 및 사이닝

다음은 iOS 프로젝트 패키징에 필요한 앱의 코드 인증서 사이닝과 프로비저닝 프로파일을 획득하는 방법에 관한 간단한 요약입니다. 전체 단계는

[iOS 프로비저닝 가이드](sharing-and-releasing-projects/iOS-and-tvOS/getting-started/provisioning)
를 참조하세요.

  1. Xcode > Preferences > Accounts 에서 Xcode와 Apple Developer ID를 연결합니다.

  2. 앱에 대한 식별자(App ID)를 생성합니다. com.(OrganizationName).(ProjectName) 포맷의 번들 식별자 이름을 입력합니다. 이 예시에서 번들 식별자는 com.YourCompany.MobileTestProject입니다.

  3. 프로젝트의 Xcode 프로젝트 파일을 열고, App ID에 지정한 것과 동일한 번들 식별자가 있는지 확인합니다. 언리얼 에디터의 프로젝트 세팅(Project Settings) > 플랫폼(Platforms) > iOS 에서 똑같은 작업을 수행합니다.

  4. Signing & Capabilities 에서 Automatically Manage Signing 을 활성화하고 Team 을 Apple Developer 계정에 연결된 이름으로 설정합니다. Xcode에서 자동으로 코드 인증서 사이닝을 생성합니다. 또는 Apple Developer 페이지의 Certificates, Identifiers, and Profiles 섹션에서 수동으로 생성할 수 있습니다.

  5. Apple Developer 페이지를 열고, Certificates, Identifiers, and Profiles 를 엽니다. ID, 등록된 디바이스 및 인증서 사이닝을 사용하여 새 프로비저닝 프로파일 을 생성합니다. Provisioning 폴더와 같이 편리한 위치에 다운로드합니다.

  6. Apple Certificate Authority 페이지로 이동하고 최신 WWDR Intermediate 인증서를 다운로드합니다. Keychain Access 앱을 열고 인증서를 System keychain 에 드래그합니다. 테스트를 위해 프로젝트를 패키징할 필요는 없지만 출시할 때에는 필요합니다.

  7. 언리얼 에디터에서 프로젝트를 열고 프로젝트 세팅(Project Settings) > 플랫폼(Platforms) > iOS 를 엽니다. 에디터에서 프로비저닝 프로파일과 인증서 사이닝을 인식할 때까지 기다린 다음 각각을 선택합니다.

6. 프로젝트 패키징하기

위 섹션을 완료한 후 플랫폼(Platforms) 드롭다운을 클릭하고, iOS > 프로젝트 패키지(Package Project) 를 클릭합니다. 모든 구성 요소가 올바르게 구성된 경우 프로젝트가 성공적으로 패키징됩니다. 또한 빠른 실행(Quick Launch) 옵션을 사용하여 선택한 디바이스에서 직접 실행할 수 있습니다.

최종 결과

이 가이드의 단계를 완료한 후에는 iOS 프로젝트가 구성되어 테스트 디바이스에서 실행할 준비가 완료됩니다.