Xcode의 iOS 시뮬레이터(iOS Simulator) 를 사용하면 실제 테스트 디바이스가 없어도 Apple의 iOS 디바이스 백-카탈로그에서 애플리케이션을 테스트할 수 있습니다. 이 페이지에서는 언리얼 엔진 프로젝트에서 iOS 시뮬레이터를 구성하고 사용하는 방법을 안내합니다.
전제조건
iOS 시뮬레이터를 사용하려면 다음이 필요합니다.
-
MacOS Ventura 이상을 실행하는 Apple Silicon Mac(M1 Mac 이상)이 있어야 합니다.
- 현재 사용 중인 UE 버전과 호환되는 Xcode를 설치해야 합니다. 자세한 내용은 iOS 개발 요구 사항을 참조하세요.
-
초기 구성을 위한 실제 iOS 테스트 디바이스가 있어야 합니다.
-
C++ 소스 코드가 포함된 UE 프로젝트
-
iOS 타깃 플랫폼
-
또한, 사용하려는 iOS 시뮬레이터도 설치해야 합니다. iOS 시뮬레이터 설치에 대한 지침은 Apple 문서를 참조하세요.
현재 UE 5.3부터 tvOS 시뮬레이터가 지원되지 않습니다. 또한, 1인칭 및 3인칭 프로젝트만 테스트를 거쳐 iOS 시뮬레이터가 작동하는 것이 확인되었습니다. 다른 프로젝트는 아직 iOS 시뮬레이터를 지원하도록 업데이트되지 않은 추가 플러그인 라이브러리를 사용할 수도 있습니다.
UE 프로젝트에서 iOS 시뮬레이터 지원 활성화하기
프로젝트에서 iOS 시뮬레이터 지원을 활성화하는 절차는 다음과 같습니다.
-
언리얼 에디터를 연 다음 프로젝트 세팅(Project Setting)을 엽니다.
-
프로젝트 세팅(Project Setting) > 플랫폼(Platforms) > iOS > 빌드(Build) 에서 iOS 시뮬레이터 지원 활성화(Enable iOS Simulator Support) 에 체크합니다.
-
iOS > 렌더링(Rendering) 섹션에서 Apple A8 지원(Support Apple A8) 에 체크합니다.
-
GenerateProjectFiles.command를 재실행하여 Xcode 프로젝트를 재생성합니다. 그러면 iOS 시뮬레이터를 지원하도록 Xcode.xconfig파일이 업데이트됩니다. -
언리얼 에디터를 재시작합니다.
-
플랫폼 드롭다운을 클릭하여 iOS 디바이스에 대해 빠른 실행(Quick Launch) 을 한 번 이상 수행합니다. 그러면 쿠킹된 iOS 콘텐츠가 포함된 빌드가 생성됩니다.
-
Xcode에서 iOS 프로젝트를 엽니다. 스킴 편집(Edit Scheme) 을 클릭한 다음, 실행(Run) 을 선택하고 진단(diagnostics) 섹션으로 이동합니다. Metal API 유효성 검사(Metal API Validation) 를 비활성화합니다.
Metal API 유효성 검사를 비활성화하지 않으면, Xcode에서 iOS 시뮬레이터를 실행하려 할 때 프로젝트에서 오류가 발생합니다.
이제 iOS용 Xcode 프로젝트에 iOS 시뮬레이터를 사용하기 위해 필요한 모든 것이 갖추어졌습니다.
iOS 시뮬레이터를 사용하도록 기존 프로젝트 업그레이드하기
이미 컴파일되고 쿠킹된 프로젝트에 iOS 시뮬레이터 지원을 추가하면, iOS 시뮬레이터 지원이 활성화된 상태로 컴파일하려 할 때 셰이더 라이브러리 문제로 인해 오류가 발생할 수 있습니다. 이러한 오류를 해결하려면 iOS 시뮬레이터 지원 활성화 세팅을 활성화한 다음 프로젝트의 모든 쿠킹된 콘텐츠를 삭제하고 프로젝트를 iOS 디바이스로 다시 실행합니다.
iOS 시뮬레이터에는 실제 디바이스와는 다른 셰이더 라이브러리가 필요하므로 UE 프로젝트는 표준 라이브러리와 Metal-Sim이라는 시뮬레이터용 라이브러리, 이렇게 두 개의 Metal 라이브러리를 생성합니다.
Xcode에서 iOS 시뮬레이터 실행하기
-
Xcode에서 프로젝트의
UE5 (IOS).xcworkspace파일을 엽니다. -
타깃 디바이스(Target Device) 드롭다운을 클릭한 다음, iOS 시뮬레이터(iOS Simulator) 를 클릭합니다. 드롭다운 메뉴가 열리면서 시뮬레이션할 수 있는 iOS 디바이스가 표시됩니다.
-
현재 사용 중인 언리얼 엔진 버전과 호환되는 iOS 디바이스를 선택합니다. 지원되는 디바이스 목록은 iOS 개발 요구 사항을 참조하세요.
-
재생(Play) 버튼 을 클릭하여 프로젝트를 컴파일하고 실행합니다.
프로젝트가 컴파일되면, 타깃 디바이스를 모방하는 창에서 iOS 시뮬레이터가 실행됩니다. 애플리케이션이 이미 빌드되어 있고 코드를 변경하지 않았다면, 실제 iPhone에 설치하는 것에 비해 매우 빠르게 컴파일됩니다.
여러 인스턴스 실행하기
애플리케이션에 대해 최대 6개의 iOS 시뮬레이터를 동시에 실행할 수 있습니다. 시뮬레이터를 여러 개 실행하면 서로 다른 iOS 버전 간의 렌더링 문제를 비교할 수 있습니다. 현재 사용 중인 시뮬레이터를 확인하려면 툴바에서 창(Window) 버튼을 클릭합니다.
동시에 세 개 이상의 iOS 시뮬레이터 인스턴스를 실행하면 시스템이 매우 느려질 수 있습니다.