Xcode를 사용하여 iOS 프로젝트 디버깅

Xcode를 사용하여 디바이스에서 프로젝트를 실행하고 중단점과 LLDB 명령을 사용하여 디버그합니다.

Choose your operating system:

Windows

macOS

Linux

iOS에서 언리얼 엔진 게임을 디버그하려면 프로젝트를 쿠킹 및 패키징한 다음 Xcode 를 사용하여 디버깅 지원을 포함하도록 코드를 리빌드합니다. 이 페이지에서는 새 빌드를 디버그할 때마다 따라야 하는 단계를 안내합니다.

1. 필수 설정

iOS 또는 tvOS 디바이스용 빌드를 생성하려면 애플리케이션에 대한 인증서 사이닝과 프로비저닝 프로파일을 설정해야 합니다. 그러지 않으면 이후 단계에서 빌드 및 iOS 디바이스 디플로이에 실패합니다. 이 프로세스에 대한 자세한 정보는 iOS 프로비저닝을 참조하세요.

C++ 프로젝트를 빌드하는 경우, 애플리케이션에 대한 Xcode 프로젝트가 있어야 합니다. Control 키를 누른 채로 프로젝트의 .uproject 파일을 클릭하거나, 아직 프로젝트를 생성하지 않은 경우 Generate Xcode Project 를 클릭합니다.

2. iPhone용 콘텐츠 쿠킹

iPhone에서 디버그를 실행하기 전에 언리얼 에디터 를 사용하여 게임의 콘텐츠를 쿠킹 및 패키징해야 합니다. Xcode로 게임의 소스 코드를 컴파일할 수 있지만 콘텐츠 쿠킹은 할 수 없기 때문입니다. 따라서 게임의 콘텐츠에 중대한 변경사항이 있을 때마다 디버깅을 위해 Xcode로 옮기기 전에 전부 다시 패키징해야 합니다.

언리얼 에디터에서 파일(File) > 프로젝트 패키지(Package Project) > iOS 를 클릭하여 게임을 패키징할 수 있습니다. iOS 프로젝트 패키징에 필요한 전제조건에 관한 정보는 iOS 프로젝트 패키징을 참조하세요.

3. Xcode에서 프로젝트 컴파일 및 실행

게임을 패키징한 후 디버깅 지원이 활성화된 Xcode에서 리빌드해야 합니다. 이는 언리얼 엔진의 패키징 프로세스로 생성된 바이너리 및 실행 파일을 대체합니다.

  1. 애플리케이션의 Xcode 프로젝트를 엽니다. Xcode의 메인 메뉴에서 Product > Scheme > Edit Scheme 을 선택합니다.

    Product/Scheme의 Edit Scheme 버튼

  2. Run 카테고리를 클릭하고 Build ConfigurationDebugGame 으로 변경합니다.

    Product/Scheme/Edit Scheme 메뉴에서 Build Configuration을 DebugGame으로 설정

언리얼 엔진의 소스 코드 빌드를 사용하는 경우, 디버그 구성을 사용하여 엔진 코드를 디버그할 수 있습니다.

  1. 타깃 디바이스를 My Mac 에서 연결된 iPhone 으로 변경합니다.

    Xcode 창의 오른쪽 상단 코너에 있는 버튼을 사용하여 타깃 디바이스를 iPhone으로 변경

  2. Build and Run 버튼을 클릭하여 Xcode에서 프로젝트 빌드를 시작하고 디바이스에서 이를 실행합니다.

    왼쪽 상단에 있는 Play 버튼을 클릭하여 프로젝트를 빌드하고 실행합니다.

이 단계를 완료하면 디바이스에서 프로젝트가 빌드 및 실행됩니다. 여기에서 중단점, 로그, LLDB 명령을 사용하여 프로젝트를 디버그하고 런타임에서 정보를 검토할 수 있습니다.

4. 추가 정보

Xcode의 디버깅 기능 사용 방법에 관한 정보는 Apple의 관련 개발자 문서 Debugging With Xcode를 참조하세요.

LLDB에 관한 정보는 Apple의 문서 아카이브에서 Getting Started with LLDB 페이지를 참조하세요.

언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.