Visual Studio를 사용하여 배포 및 디버깅Using Visual Studio to deploy and debug

DirectX 또는 Unity를 사용하여 혼합 현실 앱을 개발할지에 관계없이 Visual Studio를 사용하여 디버그하고 배포할 수 있습니다.Whether you want to use DirectX or Unity to develop your mixed reality app, you will use Visual Studio for debugging and deploying. 이 섹션에서는 다음을 수행하는 방법을 알아봅니다.In this section, you will learn how to:

  • Visual Studio를 통해 애플리케이션을 HoloLens 또는 Windows Mixed Reality 몰입형 헤드셋에 배포합니다.Deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Visual Studio에 기본 제공된 HoloLens 에뮬레이터를 사용합니다.Use the HoloLens emulator built in to Visual Studio.
  • 혼합 현실 앱을 디버그합니다.Debug mixed reality apps.

필수 구성 요소Prerequisites

  1. 설치 지침은 도구 설치를 참조하세요.See Install the Tools for installation instructions.
  2. Visual Studio에서 새 유니버설 Windows 앱 프로젝트를 만듭니다.Create a new Universal Windows app project in Visual Studio. HoloLens(1세대)의 경우 Visual Studio 2017 이상을 사용합니다.For HoloLens (1st gen), use Visual Studio 2017 or newer. Holololens 2의 경우 Visual Studio 2019 16.2 이상을 사용합니다.For Hololens 2, use Visual Studio 2019 16.2 or newer. C# 및 C++가 지원됩니다.C# and C++ are supported. (또는 지침에 따라 Unity에서 앱을 만듭니다.)(Or follow the instructions to create an app in Unity.)

개발자 모드 사용Enabling Developer Mode

먼저 디바이스에서 개발자 모드 를 사용하도록 설정합니다. 그러면 Visual Studio에서 해당 디바이스에 연결할 수 있습니다.Start by enabling Developer Mode on your device, so Visual Studio can connect to it.

HoloLensHoloLens

  1. HoloLens를 켜고 디바이스에 배치합니다.Turn on your HoloLens and put on the device.
  2. 시작 제스처를 수행하여 주 메뉴를 시작합니다.Perform the start gesture to launch the main menu.
  3. 설정 타일을 선택하여 환경에서 앱을 시작합니다.Select the Settings tile to launch the app in your environment.
  4. 업데이트 메뉴 항목을 선택합니다.Select the Update menu item.
  5. 개발자용 메뉴 항목을 선택합니다.Select the For developers menu item.
  6. 개발자 모드 를 사용하도록 설정합니다.Enable Developer Mode . 그러면 Visual Studio에서 HoloLens로 앱을 배포할 수 있습니다.This will allow you to deploy apps from Visual Studio to your HoloLens.
  7. 옵션: 아래로 스크롤하여 디바이스 포털 도 사용하도록 설정합니다.Optional: Scroll down and also enable Device Portal . 이렇게 하면 웹 브라우저에서 HoloLens의 Windows 디바이스 포털에도 연결할 수 있습니다.This will also allow you to connect to the Windows Device Portal on your HoloLens from a web browser.

Windows PCWindows PC

PC에 연결된 Windows Mixed Reality 헤드셋을 사용하는 경우 PC에서 개발자 모드 를 사용하도록 설정해야 합니다.If you are working with a Windows Mixed Reality headset connected to your PC, you must enable Developer Mode on the PC.

  1. 설정 으로 이동합니다.Go to Settings
  2. 업데이트 및 보안 을 선택합니다.Select Update and Security
  3. 개발자용 을 선택합니다.Select For developers
  4. 개발자 모드 를 사용하도록 설정하고, 선택한 설정에 대한 고지 사항을 읽은 다음, [예]를 클릭하여 변경 내용을 적용합니다.Enable Developer Mode , read the disclaimer for the setting you chose, then click Yes to accept the change.

Wi-Fi를 통해 앱 배포 - HoloLens(1세대)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. 앱에 대해 x86 빌드 구성을 선택합니다.Select an x86 build configuration for your app
    Visual Studio의 x86 빌드 구성x86 build configuration in Visual Studio
  2. 배포 대상 드롭다운 메뉴에서 원격 머신 을 선택합니다.Select Remote Machine in the deployment target drop-down menu
    Visual Studio의 원격 머신 배포 대상Remote machine deployment target in Visual Studio
  3. C++ 및 JavaScript 프로젝트의 경우 프로젝트 > 속성 > 구성 속성 > 디버깅 으로 차례로 이동합니다.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging . C# 프로젝트의 경우 연결을 구성하는 대화 상자가 자동으로 표시됩니다.For C# projects, a dialog will automatically appear to configure your connection. a.a. 주소 또는 머신 이름 필드에서 디바이스의 IP 주소를 입력합니다.Enter the IP address of your device in the Address or Machine Name field. 설정 > 네트워크 및 인터넷 > 고급 옵션 아래에서 HoloLens의 IP 주소를 찾거나, Cortana에 "내 IP 주소가 무엇입니까?"라고 질문할 수 있습니다.Find the IP address on your HoloLens under Settings > Network & Internet > Advanced Options , or you can ask Cortana "What is my IP address?" b.b. 인증 모드를 유니버설(암호화되지 않은 프로토콜) 로 설정Set Authentication Mode to Universal (Unencrypted protocol)
    Visual Studio의 원격 연결 대화 상자Remote connection dialog in Visual Studio
  4. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio
  5. PC에서 앱을 HoloLens에 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다.The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. 아래의 디바이스 페어링 지침을 따릅니다.Follow the Pairing your device instructions below.

Wi-Fi를 통해 앱 배포 - HoloLens 2Deploying an app over Wi-Fi - HoloLens 2

  1. 앱에 대해 ARM 또는 ARM64 빌드 구성을 선택합니다.Select an ARM or ARM64 build configuration for your app
    Visual Studio의 ARM64 빌드 구성ARM64 build configuration in Visual Studio
  2. 배포 대상 드롭다운 메뉴에서 원격 머신 을 선택합니다.Select Remote Machine in the deployment target drop-down menu
    Visual Studio의 원격 머신 배포 대상Remote machine deployment target in Visual Studio
  3. C++ 및 JavaScript 프로젝트의 경우 프로젝트 > 속성 > 구성 속성 > 디버깅 으로 차례로 이동합니다.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging . C# 프로젝트의 경우 연결을 구성하는 대화 상자가 자동으로 표시됩니다.For C# projects, a dialog will automatically appear to configure your connection. a.a. 주소 또는 머신 이름 필드에서 디바이스의 IP 주소를 입력합니다.Enter the IP address of your device in the Address or Machine Name field. 설정 > 네트워크 및 인터넷 > 고급 옵션 아래에서 HoloLens의 IP 주소를 찾거나, Cortana에 "내 IP 주소가 무엇입니까?"라고 질문할 수 있습니다.Find the IP address on your HoloLens under Settings > Network & Internet > Advanced Options , or you can ask Cortana "What is my IP address?" b.b. 인증 모드를 유니버설(암호화되지 않은 프로토콜) 로 설정Set the Authentication Mode to Universal (Unencrypted protocol)
    Visual Studio의 원격 연결 대화 상자Remote connection dialog in Visual Studio
  4. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio
  5. PC에서 앱을 HoloLens에 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다.The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. 아래의 디바이스 페어링 지침을 따릅니다.Follow the Pairing your device instructions below.

HoloLens IP 주소가 변경되면 프로젝트 > 속성 > 구성 속성 > 디버깅 으로 차례로 이동하여 대상 머신의 IP 주소를 변경할 수 있습니다.If your HoloLens IP address changes, you can change the IP address of the target machine by going to Project > Properties > Configuration Properties > Debugging

USB를 통해 앱 배포 - HoloLens(1세대)Deploying an app over USB - HoloLens (1st gen)

  1. 앱에 대해 x86 빌드 구성을 선택합니다.Select an x86 build configuration for your app
    Visual Studio의 x86 빌드 구성x86 build configuration in Visual Studio
  2. 배포 대상 드롭다운 메뉴에서 디바이스 를 선택합니다.Select Device in the deployment target drop-down menu
    Visual Studio에서 디바이스 배포Device deployment in Visual Studio
  3. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio
  4. PC에서 앱을 HoloLens에 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다.The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. 아래의 디바이스 페어링 지침을 따릅니다.Follow the Pairing your device instructions below.

USB를 통해 앱 배포 - HoloLens 2Deploying an app over USB - HoloLens 2

  1. 앱에 대해 ARM 또는 ARM64 빌드 구성을 선택합니다.Select an ARM or ARM64 build configuration for your app
    Visual Studio의 ARM64 빌드 구성ARM64 build configuration in Visual Studio
  2. 배포 대상 드롭다운 메뉴에서 디바이스 를 선택합니다.Select Device in the deployment target drop-down menu
    Visual Studio에서 디바이스 배포Device deployment in Visual Studio
  3. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio
  4. PC에서 앱을 HoloLens에 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다.The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. 아래의 디바이스 페어링 지침을 따릅니다.Follow the Pairing your device instructions below.

로컬 PC에 앱 배포 - 몰입형 헤드셋Deploying an app to your Local PC - immersive headset

PC 또는 Mixed Reality 시뮬레이터에 연결되는 Windows Mixed Reality 몰입형 헤드셋을 사용하는 경우 다음 지침을 따릅니다.Follow these instructions when using a Windows Mixed Reality immersive headset that connects to your PC or the Mixed Reality simulator. 이러한 경우 로컬 PC에 앱을 배포하고 실행하기만 하면 됩니다.In these cases, simply deploy and run your app on the local PC.

  1. 앱에 대해 x86 또는 x64 빌드 구성을 선택합니다.Select an x86 or x64 build configuration for your app
  2. 배포 대상 드롭다운 메뉴에서 로컬 머신 을 선택합니다.Select Local Machine in the deployment target drop-down menu
  3. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging

디바이스 페어링Pairing your device

앱을 Visual Studio에서 HoloLens로 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다.The first time you deploy an app from Visual Studio to your HoloLens, you will be prompted for a PIN. HoloLens에서 Settings 앱을 실행하여 PIN을 생성하고, 업데이트 > 개발자용 으로 차례로 이동하여 페어링 을 탭합니다.On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers and tap on Pair . HoloLens에 PIN이 표시됩니다. Visual Studio에서 이 PIN을 입력합니다.A PIN will be displayed on your HoloLens; type this PIN in Visual Studio. 페어링이 완료되면 HoloLens에서 완료 를 탭하여 대화 상자를 해제합니다.After pairing is complete, tap Done on your HoloLens to dismiss the dialog. 이 PC는 이제 HoloLens와 페어링되어 앱을 자동으로 배포할 수 있습니다.This PC is now paired with the HoloLens and you will be able to deploy apps automatically. 앱을 HoloLens에 배포하는 데 사용되는 모든 후속 PC에 대해 이러한 단계를 반복하세요.Repeat these steps for every subsequent PC that is used to deploy apps to your HoloLens.

페어링된 모든 컴퓨터에서 HoloLens와의 페어링을 해제하려면 Settings 앱을 시작하고, 업데이트 > 개발자용 으로 차례로 이동하여 지우기 를 탭합니다.To un-pair your HoloLens from all computers it was paired with, launch the Settings app, go to Update > For Developers and tap on Clear .

HoloLens(1세대) 에뮬레이터에 앱 배포Deploying an app to the HoloLens (1st gen) Emulator

  1. HoloLens 에뮬레이터를 설치 했는지 확인합니다.Make sure you have installed the HoloLens Emulator .
  2. 앱에 대해 x86 빌드 구성을 선택합니다.Select an x86 build configuration for your app.
    Visual Studio의 x86 빌드 구성x86 build configuration in Visual Studio
  3. 배포 대상 드롭다운 메뉴에서 HoloLens 에뮬레이터 를 선택합니다.Select HoloLens Emulator in the deployment target drop-down menu
    Visual Studio의 에뮬레이터 대상Emulator target in Visual Studio
  4. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio

HoloLens 2 에뮬레이터에 앱 배포Deploying an app to the HoloLens 2 Emulator

  1. HoloLens 에뮬레이터를 설치 했는지 확인합니다.Make sure you have installed the HoloLens Emulator .
  2. 앱에 대해 x86 또는 x64 빌드 구성을 선택합니다.Select an x86 or x64 build configuration for your app.
    Visual Studio의 x86 빌드 구성x86 build configuration in Visual Studio
  3. 배포 대상 드롭다운 메뉴에서 HoloLens 2 에뮬레이터 를 선택합니다.Select HoloLens 2 Emulator in the deployment target drop-down menu
    Visual Studio의 에뮬레이터 대상Emulator target in Visual Studio
  4. 디버그 > 디버깅 시작 을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.Select Debug > Start debugging to deploy your app and start debugging
    Visual Studio에서 디버깅 없이 시작Start Without Debugging in Visual Studio

HoloLens(1세대)용 그래픽 디버거Graphics Debugger for HoloLens (1st gen)

Visual Studio 그래픽 진단 도구는 홀로그램 앱을 작성하고 최적화하는 경우에 매우 유용합니다.The Visual Studio Graphics Diagnostics tools are very helpful when writing and optimizing a Holographic app. 자세한 내용은 MSDN의 Visual Studio 그래픽 진단을 참조하세요.See Visual Studio Graphics Diagnostics on MSDN for full details.

그래픽 디버거를 시작하려면To Start the Graphics Debugger

  1. 위의 지침에 따라 디바이스 또는 에뮬레이터를 대상으로 지정합니다.Follow the instructions above to target a device or emulator
  2. 디버그 > 그래픽 > 진단 시작 으로 차례로 이동합니다.Go to Debug > Graphics > Start Diagnostics
  3. HoloLens를 사용하여 이 작업을 처음 수행하는 경우 "액세스 거부" 오류가 발생할 수 있습니다.The first time you do this with a HoloLens, you may get an "access denied" error. 업데이트된 권한이 적용되도록 HoloLens를 다시 부팅하여 다시 시도하세요.Reboot your HoloLens to allow updated permissions to take effect and try again.

프로파일링Profiling

Visual Studio 프로파일링 도구를 사용하면 앱의 성능 및 리소스 사용을 분석할 수 있습니다.The Visual Studio profiling tools allow you to analyze your app's performance and resource use. 여기에는 CPU, 메모리, 그래픽 및 네트워크 사용을 최적화하는 도구가 포함됩니다.This includes tools to optimize CPU, memory, graphics, and network use. 자세한 내용은 MSDN의 디버깅하지 않고 진단 도구 실행을 참조하세요.See Run diagnostic tools without debugging on MSDN for full details.

HoloLens를 사용하여 프로파일링 도구를 시작하려면To Start the Profiling Tools with HoloLens

  1. 위의 지침에 따라 디바이스 또는 에뮬레이터를 대상으로 지정합니다.Follow the instructions above to target a device or emulator
  2. 디버그 > 디버깅하지 않고 진단 도구 시작... 으로 차례로 이동합니다.Go to Debug > Start Diagnostic Tools Without Debugging...
  3. 사용하려는 도구를 선택합니다.Select the tools you want to use
  4. 시작 을 클릭합니다.Click Start
  5. HoloLens를 사용하여 이 작업을 처음 수행하는 경우 "액세스 거부" 오류가 발생할 수 있습니다.The first time you do this with a HoloLens, you may get an "access denied" error. 업데이트된 권한이 적용되도록 HoloLens를 다시 부팅하여 다시 시도하세요.Reboot your HoloLens to allow updated permissions to take effect and try again.

설치되었거나 실행 중인 앱 디버깅Debugging an installed or running app

Visual Studio를 사용하여 Visual Studio 프로젝트에서 배포하지 않고 설치된 유니버설 Windows 앱을 디버그할 수 있습니다.You can use Visual Studio to debug a Universal Windows app that's installed without deploying from a Visual Studio project. 설치된 앱 패키지를 디버그하거나 이미 실행 중인 앱을 디버그하려는 경우에 유용합니다.This is useful if you want to debug an installed app package, or if you want to debug an app that's already running.

  1. 디버그 -> 기타 디버그 대상 -> 설치된 앱 패키지 디버그 로 차례로 이동합니다.Go to Debug -> Other Debug Targets -> Debug Installed App Package
  2. HoloLens의 경우 원격 머신 대상을 선택하고, 몰입형 헤드셋의 경우 로컬 머신 대상을 선택합니다.Select the Remote Machine target for HoloLens or Local Machine for immersive headsets.
  3. 디바이스의 IP 주소 를 입력합니다.Enter your device’s IP address
  4. 유니버설 인증 모드를 선택합니다.Choose the Universal Authentication Mode
  5. 창에 실행 중인 앱과 비활성 앱이 모두 표시됩니다.The window shows both running and inactive apps. 디버그하려는 앱을 선택합니다.Pick the one what you’d like to debug.
  6. 디버그할 코드 형식(관리, 네이티브, 혼합)을 선택합니다.Choose the type of code to debug (Managed, Native, Mixed)
  7. 연결 또는 시작 을 클릭합니다.Click Attach or Start

다음 개발 검사점Next Development Checkpoint

앞에서 설명한 Unity 개발 검사점 경험을 수행하는 경우 배포 단계를 진행하고 있는 것입니다.If you're following the Unity development checkpoint journey we've laid out, you're in the midst of the deployment stage. 여기에서 다음 항목을 진행할 수 있습니다.From here, you can proceed to the next topic:

또는 고급 서비스 추가로 바로 이동합니다.Or jump directly to adding advanced services:

언제든지 Unity 개발 검사점으로 돌아갈 수 있습니다.You can always go back to the Unity development checkpoints at any time.

참고 항목See also