딥 링크

Android

Xcode 프레임 디버거 Unity 통합

The Xcode frame debugger tool lets you capture a frame of your application to see the commands that the GPU performed during that frame, examine data in GPU memory, and identify bottlenecks in your shaders. This lets you analyze GPU performance in fine detail.

Unity는 다음과 같은 방식으로 Xcode 프레임 디버거와 통합됩니다.

macOS, iOS 및 tvOS에서 Xcode 프레임 디버거를 사용하여 타겟 디바이스에서 실행 중인 애플리케이션의 프레임을 분석할 수 있습니다.
macOS에서 Xcode 프레임 디버거를 사용하면 Unity 에디터에서 프레임을 분석할 수 있습니다.

Important:

Frame debugging only works if the application is running on a platform and graphics API that Xcode supports.
Xcode only supports macOS with Metal graphics.
If Unity uses another API, the Xcode integration is disabled until you select a supported graphics API.

Capture a frame from your application

Xcode 프레임 디버거를 사용하여 프레임을 캡처하려면 다음 중 하나를 수행하십시오.

Launch your application from Xcode and either use the Xcode UI or the FrameCapture API to request frame captures. You can analyze the frame captures in Xcode immediately, or save them to disk. This workflow is supported on all platforms that use Metal.
Launch your application directly from the command line without an Xcode project, and use the FrameCapture API to save frame captures to disk. Note: iOS doesn’t support this workflow.

Capture a frame from your application with Xcode

이 섹션에서는 Xcode UI 또는 FrameCapture API를 사용하여 애플리케이션을 실행하고 프레임 캡처를 수행하는 방법을 설명합니다. 이 워크플로는 Metal을 사용하는 모든 플랫폼에서 지원됩니다.

1. Xcode 프로젝트를 만듭니다.

Unity 에디터에서 Xcode 프로젝트를 생성하거나, 다른 Xcode 프로젝트를 사용하여 macOS 애플리케이션을 실행할 수 있습니다.

Unity 에디터에서 Xcode 프로젝트를 빌드하려면 다음 단계를 따르십시오.

빌드 설정 창(File > Build Settings)을 엽니다.
macOS만 해당: Create Xcode Project를 활성화합니다.
Build를 클릭합니다.

다른 Xcode 프로젝트를 사용하여 macOS 애플리케이션을 실행하려면 다음 단계를 따르십시오.

Xcode에서 비어 있는 새 macOS 프로젝트를 생성하거나, 기존 macOS 프로젝트를 엽니다.
Product > Scheme > Edit scheme에서 Info 탭을 엽니다.
Executable을 빌드한 Unity 애플리케이션으로 설정합니다.

2. 프레임 캡처를 수행할 수 있도록 Xcode 프로젝트 체계를 편집합니다.

또는 Xcode GUI를 사용합니다. 이렇게 하려면 Xcode 문서의 프레임 캡처 활성화 가이드에 따라 프로젝트 체계의 GPU Frame Capture 설정을 Metal로 설정하십시오.

XcScheme API를 사용하여 자동화된 빌드에 유용한 Xcode 프로젝트 체계를 설정할 수도 있습니다. 자세한 내용은 XcScheme API 문서를 참조하십시오.

3. Xcode에서 프로젝트를 실행하고 프레임 캡처를 수행합니다.

Xcode에서 Frame Capture 버튼(카메라 아이콘)을 눌러 데이터의 다음 프레임을 캡처하십시오.

또는 FrameCapture API를 사용하여 스크립트에서 프레임 캡처를 수행할 수도 있습니다. Xcode에서 프레임 캡처 데이터를 분석하는 방법은 Xcode 프레임 디버거 문서를 참조하십시오.

Capture a frame from your application with the command line

이 섹션에서는 커맨드 라인에서 애플리케이션을 실행하고, FrameCapture API를 사용하여 프레임 캡처를 수행하고, 결과를 디스크에 저장하는 방법을 설명합니다. 중요: 이 워크플로는 iOS에서 지원되지 않습니다. iOS에서 프레임 캡처를 수행하려면 항상 Xcode에서 애플리케이션을 실행해야 합니다.

FrameCapture.BeginCaptureToFile 및 EndCapture에 대한 호출을 코드에 추가합니다. 이렇게 하면 필요에 따라 프레임 캡처를 수행할 수 있습니다.
-enable-metal-capture 플래그를 사용하여 커맨드 라인에서 애플리케이션을 실행합니다. Xcode는 코드가 요청할 때 프레임 캡처를 수행하고 해당 결과를 디스크에 저장합니다.

Xcode에서 이러한 데이터를 분석하는 방법은 Apple의 Xcode 프레임 디버거 문서를 참조하십시오.

Capture a frame from the Unity Editor

macOS에서 Xcode 프레임 디버거를 사용하면 Unity 에디터에서 프레임을 분석할 수 있습니다. Xcode를 사용하여 Unity 에디터를 실행하면 Unity 에디터 UI에서 프레임 캡처를 요청할 수 있습니다.

Capture a frame from Unity Editor with Xcode

Follow these steps to launch the Unity Editor from Xcode and perform a frame capture using the Unity Editor UI, the Xcode UI, or the FrameCapture API. You can analyze the frame capture immediately, or save the results to disk. This workflow is supported on macOS.

Preqrequisite: If the Unity Editor is open, close it.

Xcode에서 비어 있는 새 macOS 프로젝트를 생성하거나, 기존 macOS 프로젝트를 엽니다.
Go to Product > Scheme > Edit scheme, and open the Info tab.
Set Executable to Unity Editor.
Follow the Enabling Frame Capture guide in the Xcode documentation to set your project scheme’s GPU Frame Capture setting to Metal.
Optional - If you have the Unity Hub installed: Go to the Arguments tab in the Xcode Scheme settings window and pass the path to your Unity project as an argument using -projectPath. This is to prevent the Unity Hub from opening when Xcode launches the Editor and instead directly debug the Editor with your project.
Xcode 프로젝트를 실행하여 Unity 에디터를 시작합니다.
Perform a frame capture using one of the following methods:
- Unity 에디터: 씬 뷰 또는 게임 뷰의 오른쪽에 있는 Xcode Capture 버튼을 사용하여 프레임 캡처를 수행합니다.
- Xcode: Frame Capture 버튼(카메라 아이콘)을 선택하여 데이터의 다음 프레임을 캡처합니다.
- Script: Use the FrameCapture API. For more information, see the FrameCapture API documentation. For information on analyzing frame capture data in Xcode, see Apple’s Xcode frame debugger documentation.

Capture a frame from the Unity Editor with the command line

이 워크플로는 커맨드 라인에서 Unity 에디터를 실행하고, FrameCapture API를 사용하여 프레임 캡처를 수행하고, 프레임 캡처를 디스크에 저장하는 방법을 설명합니다. 이 워크플로는 macOS에서 지원됩니다.

FrameCapture.BeginCaptureToFile 및 EndCapture에 대한 호출을 코드에 추가합니다. 이렇게 하면 필요에 따라 프레임 캡처를 수행할 수 있습니다.
-enable-metal-capture 플래그를 사용하여 커맨드 라인에서 Unity 에디터를 실행합니다. Xcode는 코드가 요청할 때 프레임 캡처를 수행하고 해당 결과를 디스크에 저장합니다.

Xcode에서 이러한 데이터를 분석하는 방법은 Xcode 프레임 디버거 문서를 참조하십시오.

추가 리소스: