Visual Studio에서 원격 컴퓨터의 UWP 앱 디버그

Visual Studio를 사용하여 다른 컴퓨터 또는 디바이스에서 UWP(유니버설 Windows 플랫폼) 앱을 실행, 디버그, 프로파일링 및 테스트할 수 있습니다. Visual Studio 컴퓨터에서 터치, 지리적 위치 또는 물리적 방향 등의 UWP 관련 기능을 지원하지 않는 경우 원격 컴퓨터에서 UWP 앱을 실행하는 것이 특히 유용합니다.

필수 조건

Visual Studio에서 원격 디바이스에 있는 UWP 앱을 디버깅하려면 다음을 수행합니다.

• 원격 디버깅을 위해 Visual Studio 프로젝트를 구성해야 합니다.
• 원격 컴퓨터와 Visual Studio 컴퓨터는 네트워크를 통해 연결되거나 USB 또는 이더넷 케이블을 통해 직접 연결되어야 합니다. 인터넷을 통한 디버깅은 지원되지 않습니다.
• Visual Studio 컴퓨터와 원격 컴퓨터 모두에서 개발자 모드를 설정해야 합니다.
• 원격 컴퓨터에서 Visual Studio용 원격 도구를 실행해야 합니다.
  • 일부 Windows 10 이상 버전은 원격 도구를 자동으로 시작하고 실행합니다. 그렇지 않으면 Visual Studio용 원격 도구를 설치하고 실행합니다.
  • Windows Mobile 10 디바이스는 원격 도구를 요구하거나 지원하지 않습니다.

원격 디버깅을 위해 Visual Studio 프로젝트 구성하기

프로젝트 속성을 사용하여 연결할 원격 디바이스를 지정합니다. 설정은 프로그래밍 언어에 따라 달라집니다.

주의

기본적으로 속성 페이지는 유니버설(암호화 되지 않은 프로토콜)을 Windows 10 이상 원격 연결에 대한 인증 형식으로 설정합니다. 원격 디버거에 연결하기 위해 인증 안 함을 설정해야 할 수도 있습니다. 유니버설(암호화 되지 않은 프로토콜) 및 인증 안 함 프로토콜은 네트워크 보안이 없으므로 개발 및 원격 컴퓨터 간에 전달되는 데이터가 취약해집니다. 악의적이거나 공격적인 트래픽 위험에 노출되지 않는 신뢰할 수 있는 네트워크에 대해서만 이러한 인증 유형을 선택합니다.

인증 형식으로 Windows 인증을 선택하는 경우 디버그할 때 원격 컴퓨터에 로그인해야 합니다. 또한 원격 디버거는 Visual Studio 컴퓨터와 동일한 사용자 계정을 사용하여 Windows 인증 모드에서 실행되어야 합니다.

원격 디버깅을 위한 C# 또는 Visual Basic 프로젝트 구성하기

1. Visual Studio 솔루션 탐색기에서 C# 또는 Visual Basic 프로젝트를 선택하고 속성 아이콘을 선택하고, Alt+Enter 키를 누르거나 속성을 마우스 오른쪽 단추로 클릭하여 선택합니다.

2. 디버그 탭을 선택합니다.

3. 대상 디바이스에서 원격 컴퓨터에 대해 원격 컴퓨터를 선택하고 직접 연결된 Windows Mobile 10 디바이스에 대해 디바이스를 선택합니다.

4. 원격 컴퓨터의 경우 원격 컴퓨터 필드에 네트워크 이름 또는 IP 주소를 입력하거나 원격 연결 대화 상자에서 디바이스를 검색하려면 검색을 선택합니다.

   

원격 디버깅을 위한 C++ 프로젝트 구성하기

1. Visual Studio 솔루션 탐색기에서 C++ 프로젝트를 선택하고 속성 아이콘을 선택하고, Alt+Enter 키를 누르거나 속성을 마우스 오른쪽 단추로 클릭하여 선택합니다.

2. 디버깅 탭을 선택합니다.

3. 실행할 디버거에서 원격 컴퓨터에 대해 원격 컴퓨터를 선택하고 직접 연결된 Windows Mobile 10 디바이스에 대해 디바이스를 선택합니다.

4. 원격 컴퓨터의 경우 컴퓨터 이름 필드에 네트워크 이름 또는 IP 주소를 입력하거나 원격 연결 대화 상자에서 디바이스를 검색하려면 드롭다운에서 찾기를 선택합니다.

   

원격 연결 대화 상자 사용

원격 연결 대화 상자에서 특정 원격 컴퓨터 이름 또는 IP 주소를 검색하거나, 둥근 화살표 새로 고침 아이콘을 선택하여 연결을 자동으로 검색할 수 있습니다. 이 대화 상자는 로컬 서브넷에서 현재 원격 디버거를 실행 중인 디바이스만 검색합니다. 원격 연결 대화 상자에서 모든 디바이스를 검색할 수 있는 것은 아닙니다.

팁

이름으로 원격 디바이스에 연결할 수 없는 경우 IP 주소를 사용합니다. IP 주소를 확인하려면 원격 디바이스에서 명령 창에 ipconfig를 입력합니다. IP 주소는 IPv4 주소로 표시됩니다.

Visual Studio용 원격 도구 다운로드 및 설치

Visual Studio에서 원격 컴퓨터의 애플리케이션을 디버깅하려면 원격 컴퓨터에서 Visual Studio용 원격 도구를 실행해야 합니다.

• Windows Mobile 10 디바이스는 원격 도구를 요구하거나 지원하지 않습니다.
• 크리에이터스 업데이트(버전 1703) 이상, Windows 10 Xbox, IoT 및 HoloLens 디바이스를 실행하는 Windows 11 PC 및 Windows 10 PC는 앱을 배포할 때 원격 도구를 자동으로 설치합니다.
• 이전 작성자 업데이트 Windows 10 PC에서는 디버깅을 시작하기 전에 원격 컴퓨터에서 원격 도구를 수동으로 다운로드하여 설치하고 실행해야 합니다.

원격 도구 다운로드 및 설치:

디버그하려는 원격 디바이스 또는 서버에서(Visual Studio 머신 아님) 다음 표에 나온 링크를 통해 올바른 버전의 원격 도구를 다운로드하여 설치하세요.

• 사용 중인 버전의 Visual Studio용 원격 도구의 최신 업데이트를 다운로드합니다. 이전 원격 도구 버전은 이후 Visual Studio 버전과 호환되지 않습니다. (예를 들어, Visual Studio 2019을 사용하는 경우 Visual Studio 2019용 원격 도구의 최신 업데이트를 다운로드합니다. 이 시나리오에서는 Visual Studio 2022용 원격 도구를 다운로드하지 마세요.)
• 설치할 머신과 동일한 아키텍처를 가진 원격 도구를 다운로드합니다. 예를 들어 x64 운영 체제를 실행하는 원격 컴퓨터에서 x86 애플리케이션을 디버깅하려면 x64 원격 도구를 설치합니다. ARM64 운영 체제에서 x86, ARM 또는 x64 애플리케이션을 디버그하려면 ARM64 원격 도구를 설치합니다.

버전	링크	참고
Visual Studio 2022	원격 도구	모든 Visual Studio 2022 버전과 호환됩니다. 디바이스 운영 체제(x86, x64 또는 ARM64)와 일치하는 버전을 다운로드합니다. 이전 버전의 Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2019	원격 도구	모든 Visual Studio 2019 버전과 호환됩니다. 디바이스 운영 체제(x86, x64 또는 ARM64)와 일치하는 버전을 다운로드합니다. 이전 버전의 Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2017	원격 도구	모든 Visual Studio 2017 버전과 호환됩니다. 디바이스 운영 체제(x86, x64 또는 ARM64)와 일치하는 버전을 다운로드합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 Unblock the file download(파일 다운로드 차단 해제)를 참조하세요.
Visual Studio 2015	원격 도구	Visual Studio 2015용 원격 도구는 My.VisualStudio.com에서 사용할 수 있습니다. 메시지가 표시되면 무료 Visual Studio Dev Essentials 프로그램에 가입하거나 Visual Studio 구독 ID로 로그인하세요. Windows Server에서 원격 도구 다운로드에 대한 도움말은 Unblock the file download(파일 다운로드 차단 해제)를 참조하세요.
Visual Studio 2013	원격 도구	Visual Studio 2013 설명서의 다운로드 페이지
Visual Studio 2012	원격 도구	Visual Studio 2012 설명서의 다운로드 페이지

원격 도구를 설치하는 대신 msvsmon.exe를 원격 컴퓨터에 복사하여 원격 디버거를 실행할 수 있습니다. 그러나 원격 디버거 구성 마법사(rdbgwiz.exe)는 원격 도구를 설치하는 경우에만 사용할 수 있습니다. 원격 디버거를 서비스로 실행하려면 구성을 위해 마법사를 사용해야 할 수도 있습니다. 자세한 내용은 (선택 사항) 원격 디버거를 서비스로 구성을 참조하세요.

참고

• ARM 디바이스에서 Windows 10 또는 이후 버전의 앱을 디버그하려면 최신 버전의 원격 도구에서 사용할 수 있는 ARM64를 사용합니다.
• Windows RT 디바이스에서 Windows 10 앱을 디버그하려면 Visual Studio 2015 원격 도구 다운로드에서만 사용할 수 있는 ARM을 사용합니다.
• ARM64 운영 체제에서 x64 앱을 디버그하려면 ARM64 원격 도구와 함께 설치된 x64 msvsmon.exe를 실행합니다.

원격 도구 구성

1. 원격 컴퓨터의 시작 메뉴에서 원격 디버거를 찾아 시작합니다.

   원격 컴퓨터에 대한 관리 권한이 없는 경우 원격 디버거 앱을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 선택합니다. 이와 같은 권한이 있는 경우 정상적으로 시작합니다.

   관리자 권한으로 실행 중인 프로세스에 연결하려는 경우 또는 IIS와 같은 다른 사용자 계정으로 실행 중인 경우에는 원격 디버거 앱을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 선택합니다. 자세한 내용은 Run the remote debugger as an administrator(관리자 권한으로 원격 디버거 실행)를 참조하세요.

2. 처음으로(또는 구성하기 전에) 원격 디버거를 시작할 때는 원격 디버깅 구성 마법사가 나타납니다.

   대부분의 시나리오에서 마법사의 Windows 방화벽 구성 페이지가 표시될 때까지 다음을 선택합니다.

   

3. 원격 도구를 사용하려는 네트워크 유형을 하나 이상 선택하세요. 컴퓨터가 도메인을 통해 연결된 경우 첫 번째 항목을 선택해야 합니다. 컴퓨터가 작업 그룹 또는 홈 그룹을 통해 연결된 경우 두 번째 또는 세 번째 항목을 적절하게 선택합니다.

   그런 다음 마침을 선택하여 원격 디버거를 시작합니다.

4. 구성이 완료되면 원격 디버거 창이 나타납니다.

   

   이제 원격 디버거가 연결을 기다리는 중입니다. 표시된 서버 이름과 포트 번호를 사용하여 Visual Studio에서 원격 연결 구성을 설정합니다.

원격 디버거를 중지하려면 파일>끝내기를 선택합니다. 시작 메뉴 또는 명령줄에서 다시 시작할 수 있습니다.

<Remote debugger installation directory>\msvsmon.exe

UWP 앱을 원격으로 디버그하기

원격 디버깅은 로컬 디버깅과 동일하게 작동합니다.

1. Windows 10 이전 작성자 업데이트 버전에서는 원격 디버깅 모니터(msvsmon.exe)가 원격 디바이스에서 실행되고 있어야 합니다.

2. Visual Studio 컴퓨터에서 도구 모음의 녹색 화살표 옆에 올바른 디버깅 대상(원격 컴퓨터 또는 디바이스)이 표시되는지 확인합니다.

3. 디버그>디버깅 시작을 선택하고 F5 키를 누르거나, 도구 모음에서 녹색 화살표를 선택하여 디버깅을 시작합니다.

   그러면 프로젝트가 다시 컴파일된 후 원격 디바이스에서 배포되고 시작됩니다. 디버거는 중단점에서 실행을 일시 중단하며 사용자는 한 단계씩 코드를 실행하거나, 프로시저 단위로 실행하거나 코드를 종료하여 한 번에 한 줄씩 실행할 수 있습니다.

4. 필요한 경우 디버그>디버깅 중지를 선택하거나 하거나 Shift+F5 키를 눌러 디버깅을 중지하고 원격 애플리케이션을 닫습니다.

관련 콘텐츠

• 고급 원격 배포 옵션
• Visual Studio로 UWP 앱 테스트
• Visual Studio에서 UWP 앱 디버그