Visual Studio를 사용하여 배포 및 디버깅

혼합 현실 앱을 개발할 때 DirectX와 Unity 중 무엇을 사용하든 관계없이 Visual Studio는 디버깅 및 배포에 적합한 도구입니다. 이 섹션에서는 다음 작업을 수행하는 방법을 알아봅니다.

  • Visual Studio를 통해 애플리케이션을 HoloLens 또는 Windows Mixed Reality 몰입형 헤드셋에 배포합니다.
  • Visual Studio에 기본 제공되는 HoloLens 에뮬레이터를 사용합니다.
  • 혼합 현실 앱을 디버그합니다.

필수 구성 요소

  1. 설치 지침은 도구 설치를 참조하세요.
  2. Unity 또는 Visual Studio에서 새 혼합 현실 프로젝트를 만듭니다.
  3. 지침에 따라 Unity 프로젝트를 빌드합니다.

개발자 모드 사용

먼저 디바이스에서 개발자 모드를 사용하도록 설정합니다. 그러면 Visual Studio에서 해당 디바이스에 연결할 수 있습니다.

HoloLens의 개발자 모드

  1. HoloLens를 켜고 디바이스에 배치합니다.
  2. 시작 제스처를 사용하여 주 메뉴를 시작합니다.
  3. 설정 타일을 선택하여 환경에서 앱을 시작합니다.
  4. 업데이트 메뉴 항목을 선택합니다.
  5. 개발자용 메뉴 항목을 선택합니다.
  6. 개발자 기능 사용을 사용하도록 설정하여 Visual Studio에서 HoloLens로 앱을 배포합니다. 디바이스에서 Windows Holographic 버전 21H1 이상을 실행하는 경우 디바이스 검색도 사용하도록 설정합니다.
  7. 옵션: 아래로 스크롤하고 장치 포털도 사용하도록 설정하면 웹 브라우저에서 HoloLens의 Windows 장치 포털에 연결할 수 있습니다.

Windows PC의 개발자 모드

PC에 연결된 Windows Mixed Reality 헤드셋을 사용하는 경우 PC에서 개발자 모드를 사용하도록 설정해야 합니다.

  1. 설정으로 이동합니다.
  2. 업데이트 및 보안을 선택합니다.
  3. 개발자용을 선택합니다.
  4. 개발자 모드를 사용하도록 설정하여 선택한 설정에 대한 고지 사항을 읽은 다음, 를 선택하여 변경 내용을 적용합니다.

Wi-Fi 또는 USB를 통해 HoloLens 앱 배포

컴파일 옵션

  1. Visual Studio에서 프로젝트 열기

  2. 컴파일 옵션 드롭다운을 클릭하고 다음 중 하나를 수행합니다.

    • Unity 프로젝트의 경우 릴리스 또는 마스터를 선택합니다.
    • 다른 모든 프로젝트의 경우 릴리스를 선택합니다.

    Visual Studio의 컴파일 옵션을 보여주는 스크린샷

    컴파일 옵션에 대한 정의는 다음과 같습니다.

구성 설명
디버그 모든 최적화를 해제하고 프로파일러를 사용하도록 설정합니다. 스크립트를 디버그하는 데 사용됩니다.
마스터 모든 최적화를 설정하고 프로파일러를 비활성화합니다. Store에 앱을 제출하는 데 사용됩니다.
Release 모든 최적화를 설정하고 프로파일러를 사용하도록 설정합니다. 앱 성능을 평가하는 데 사용됩니다.

빌드 구성

  1. 디바이스에 따라 빌드 구성을 선택합니다.

    ARM 또는 ARM64 구성 옵션 선택

    Visual Studio의 ARM64 빌드 구성

    빌드 구성에 대한 자세한 내용은 Unity 설명서의 "빌드 구성 형식" 표를 참조하세요.

    참고

    HoloLens 2 디바이스에 배포하려면 ARM64 또는 ARM 아키텍처를 선택합니다.

    디바이스가 대상 옵션으로 보이지 않으면, Visual Studio 솔루션의 시작 프로젝트를 IL2CPP 프로젝트에서 UWP 프로젝트로 변경해야 할 수 있습니다. 이렇게 하려면 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭한 다음, 시작 프로젝트로 설정을 선택합니다.

  2. 배포 대상 드롭다운을 클릭하고 다음 중 하나를 수행합니다.

    • Wi-Fi를 통해 빌드 및 배포하는 경우 원격 머신을 선택합니다.

    Visual Studio에서 배포 대상으로

    • USB를 통해 빌드 및 배포하는 경우 디바이스를 선택합니다.

    Visual Studio에서 배포 대상으로

원격 연결

원격 연결을 설정하려면 다음을 수행합니다.

  1. 메뉴 모음에서 프로젝트 > 속성 > 구성 속성 > 디버깅을 선택합니다.

    참고

    C# 프로젝트의 경우 대화 상자가 자동으로 표시되어야 합니다.

  2. 실행할 디버거 드롭다운을 클릭한 다음, 원격 머신을 선택합니다.

  3. 머신 이름 필드에 디바이스의 IP 주소를 입력합니다.

    Visual Studio의 원격 연결 대화 상자

    • 설정 > 네트워크 & 인터넷 > 고급 옵션 아래에서 HoloLens의 IP 주소를 찾을 수 있습니다.

    • "자동 감지" 기능에 의존하기 보다는 수동으로 IP 주소를 입력하는 것이 좋습니다.

  4. 인증 모드유니버설(암호화되지 않은 프로토콜)로 설정합니다.

  5. 필요에 따라 앱을 빌드, 배포 및 디버그합니다.

    • 빌드, 배포 및 디버깅을 시작하려면 디버그 > 디버깅 시작을 선택합니다.

    • 디버깅 없이 빌드 및 배포하려면 빌드 > 솔루션 배포를 선택합니다.

  6. PC에서 앱을 HoloLens에 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다. 아래의 디바이스 페어링 지침을 따릅니다.

참고

HoloLens 2에 설치된 UWP 애플리케이션 디버깅을 시작할 때 아래에 나열된 오류가 발생하는 경우 패키지 이름을 바꾸거나 UWP 애플리케이션을 제거해 보세요.

"디버깅을 시작할 수 없습니다."
"작업이 지원되지 않습니다. 알 수 없는 오류: 0x80070057"

HoloLens(1세대) 에뮬레이터에 앱 배포

  1. HoloLens 에뮬레이터를 설치 했는지 확인합니다.
  2. 앱에 대해 x86 빌드 구성을 선택합니다. Visual Studio에서 x86 빌드 구성 선택
  3. 배포 대상 드롭다운 메뉴에서 HoloLens 에뮬레이터를 선택합니다.
    Visual Studio의 에뮬레이터 대상
  4. 디버그 > 디버깅 시작을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.
    Visual Studio의 디버깅하지 않고 시작

HoloLens 2 에뮬레이터에 앱 배포

  1. HoloLens 에뮬레이터를 설치 했는지 확인합니다.
  2. 앱에 대해 x86 또는 x64 빌드 구성을 선택합니다.
    Visual Studio의 x86 빌드 구성
  3. 배포 대상 드롭다운 메뉴에서 HoloLens 2 에뮬레이터를 선택합니다.
    Visual Studio 애플리케이션의 에뮬레이터 대상
  4. 디버그 > 디버깅 시작을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.
    Visual Studio의 디버깅하지 않고 시작

로컬 PC에 VR 앱 배포

PC 또는 Mixed Reality 시뮬레이터에 연결되는 Windows Mixed Reality 몰입형 헤드셋을 사용하려면 다음을 수행합니다.

  1. 앱에 대해 x86 또는 x64 빌드 구성을 선택합니다.
  2. 배포 대상 드롭다운 메뉴에서 로컬 머신을 선택합니다.
  3. 필요에 따라 앱 빌드, 배포 및 디버그
    • 디버그 > 디버깅 시작을 차례로 선택하여 앱을 배포하고, 디버깅을 시작합니다.
    • 빌드 > 배포를 선택하여 디버깅하지 않고 빌드 및 배포합니다.

디바이스 페어링

앱을 Visual Studio에서 HoloLens로 처음 배포하는 경우 PIN을 입력하라는 메시지가 표시됩니다. HoloLens에서 설정 앱을 실행하여 PIN을 생성하고, 업데이트 > 개발자용으로 차례로 이동하여 페어링을 탭합니다. HoloLens에 표시되는 PIN을 Visual Studio에 입력합니다. 페어링이 완료되면 HoloLens에서 완료를 탭하여 대화 상자를 해제합니다. 이 PC는 이제 HoloLens와 페어링되어 앱을 자동으로 배포할 수 있습니다. 앱을 HoloLens에 배포하는 데 사용되는 모든 PC에 대해 이러한 단계를 반복하세요.

페어링된 모든 컴퓨터에서 HoloLens를 언페어링하려면 다음을 수행합니다.

  • 설정 앱을 시작하고, 업데이트 > 개발자용으로 이동하고, 지우기를 탭합니다.

HoloLens(1세대)용 그래픽 디버거

Visual Studio 그래픽 진단 도구는 홀로그램 앱을 작성하고 최적화하는 경우에 유용합니다. 자세한 내용은 MSDN의 Visual Studio 그래픽 진단을 참조하세요.

그래픽 디버거를 시작하려면

  1. 위의 지침에 따라 디바이스 또는 에뮬레이터를 대상으로 지정합니다.
  2. 디버그 > 그래픽 > 진단 시작으로 차례로 이동합니다.
  3. HoloLens를 사용하여 진단을 처음 시작하는 경우 "액세스 거부" 오류가 발생할 수 있습니다. 업데이트된 권한이 적용되도록 HoloLens를 다시 부팅하여 다시 시도하세요.

프로파일링

Visual Studio 프로파일링 도구를 사용하면 앱의 성능 및 리소스 사용을 분석할 수 있습니다. 여기에는 CPU, 메모리, 그래픽 및 네트워크 사용을 최적화하는 도구가 포함됩니다. 자세한 내용은 MSDN의 디버깅하지 않고 진단 도구 실행을 참조하세요.

HoloLens를 사용하여 프로파일링 도구를 시작하려면

  1. 위의 지침에 따라 디바이스 또는 에뮬레이터를 대상으로 지정합니다.
  2. 디버그 > 디버깅하지 않고 진단 도구 시작...으로 차례로 이동합니다.
  3. 사용하려는 도구를 선택합니다.
  4. 시작을 선택합니다.
  5. HoloLens를 사용하여 디버그 없이 진단을 처음 시작하는 경우 "액세스 거부" 오류가 발생할 수 있습니다. 업데이트된 권한이 적용되도록 HoloLens를 다시 부팅하여 다시 시도하세요.

설치되었거나 실행 중인 앱 디버깅

Visual Studio를 사용하여 Visual Studio 프로젝트에서 배포하지 않고 설치된 유니버설 Windows 앱을 디버그할 수 있습니다. 이는 설치된 앱 패키지를 디버그하거나 이미 실행 중인 앱을 디버그하려는 경우에 유용합니다.

  1. 디버그 -> 기타 디버그 대상 -> 설치된 앱 패키지 디버그로 차례로 이동합니다.
  2. HoloLens의 경우 원격 머신 대상을 선택하고, 몰입형 헤드셋의 경우 로컬 머신 대상을 선택합니다.
  3. 디바이스의 IP 주소를 입력합니다.
  4. 유니버설 인증 모드를 선택합니다.
  5. 창에 실행 중인 앱과 비활성 앱이 모두 표시됩니다. 디버그하려는 앱을 선택합니다.
  6. 디버그할 코드 형식(관리, 네이티브, 혼합)을 선택합니다.
  7. 연결 또는 시작을 선택합니다.

다음 개발 검사점

앞에서 설명한 Unity 개발 검사점 경험을 수행하는 경우 배포 단계를 진행하고 있는 것입니다. 여기에서 다음 항목으로 진행할 수 있습니다.

또는 고급 서비스 추가로 바로 이동합니다.

언제든지 Unity 개발 검사점으로 돌아갈 수 있습니다.

참고 항목