다음을 통해 공유


Visual Studio에서 C++ 프로젝트 원격 디버깅

다른 컴퓨터에서 Visual Studio 애플리케이션을 디버그하려면 앱을 배포할 컴퓨터에 원격 도구를 설치 및 실행하고, Visual Studio에서 원격 컴퓨터에 연결하도록 프로젝트를 구성한 다음, 앱을 배포하고 실행합니다.

원격 디버거 구성 요소Remote_debugger_componentsRemote debugger componentsRemote_debugger_components

UWP(유니버설 Windows 앱) 원격 디버깅에 대한 자세한 내용은 설치된 앱 패키지 디버그을 참조하세요.

요구 사항

원격 디버거는 Windows Server 2008 서비스 팩 2부터 Windows 7 이상 및 Windows Server 버전에서 지원됩니다. 요구 사항의 전체 목록은 요구 사항참조하세요.

메모

프록시를 통해 연결된 두 컴퓨터 간의 디버깅은 지원되지 않습니다. 전화 접속 인터넷과 같이 대기 시간이 길거나 대역폭이 낮은 연결을 통해 또는 국가/지역에서 인터넷을 통해 디버깅하는 것은 권장되지 않으며 실패하거나 허용할 수 없을 정도로 느려질 수 있습니다.

원격 도구 다운로드 및 설치

Visual Studio 컴퓨터가 아닌 디버그하려는 원격 디바이스 또는 서버에서 다음 표의 링크에서 올바른 버전의 원격 도구를 다운로드하여 설치합니다.

  • Visual Studio 버전에 대한 최신 원격 도구를 다운로드합니다. 최신 원격 도구 버전은 이전 Visual Studio 버전과 호환되지만 이전 원격 도구 버전은 이후 Visual Studio 버전과 호환되지 않습니다. 예를 들어 Visual Studio 2019를 사용하는 경우 Visual Studio 2019용 원격 도구의 최신 업데이트를 다운로드합니다. 이 시나리오에서는 Visual Studio 2022용 원격 도구를 다운로드하지 마세요.)
  • 설치하는 컴퓨터와 동일한 아키텍처의 원격 도구를 다운로드합니다. 예를 들어 64비트 운영 체제를 실행하는 원격 컴퓨터에서 32비트 앱을 디버그하려면 64비트 원격 도구를 설치합니다.
  • ARM64 디바이스에서 ARM64EC 애플리케이션을 원격 디버깅하는 경우 ARM64 원격 도구를 설치한 다음 해당 도구와 함께 설치되는 x64 원격 디버거를 시작합니다. 이 위치에서 찾을 수 있습니다: 프로그램 파일(x86)\Microsoft Visual Studio<버전>\Common7\IDE\Remote Debugger\x64.
버전 링크 노트
Visual Studio 2022 원격 도구 모든 Visual Studio 2022 버전과 호환 가능합니다. 디바이스 운영 체제(x86, x64(AMD64) 또는 ARM64)와 일치하는 버전을 다운로드합니다. 이전 버전의 Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2019 원격 도구 Visual Studio 2019용 원격 도구는 My.VisualStudio.com 사용할 수 있습니다. 메시지가 표시되면 무료 Visual Studio Dev Essentials 프로그램에 가입하거나 Visual Studio 구독 ID로 로그인합니다. 디바이스 운영 체제(x86, x64(AMD64) 또는 ARM64)와 일치하는 버전을 다운로드합니다. 이전 버전의 Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2017 원격 도구 Visual Studio 2017용 원격 도구는 My.VisualStudio.com 사용할 수 있습니다. 메시지가 표시되면 무료 Visual Studio Dev Essentials 프로그램에 가입하거나 Visual Studio 구독 ID로 로그인합니다. 디바이스 운영 체제(x86, x64(AMD64) 또는 ARM64)와 일치하는 버전을 다운로드합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2015 원격 도구 Visual Studio 2015용 원격 도구는 My.VisualStudio.com 사용할 수 있습니다. 메시지가 표시되면 무료 Visual Studio Dev Essentials 프로그램에 가입하거나 Visual Studio 구독 ID로 로그인합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2013 원격 도구 Visual Studio 2013 설명서의 다운로드 페이지
Visual Studio 2012 원격 도구 Visual Studio 2012 설명서의 다운로드 페이지
버전 링크 노트
Visual Studio 2019 원격 도구 모든 Visual Studio 2019 버전과 호환 가능합니다. 디바이스 운영 체제(x86, x64(AMD64) 또는 ARM64)와 일치하는 버전을 다운로드합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요. 최신 버전의 원격 도구에 대한 정보는 Visual Studio 2022 문서을 참조하십시오.
Visual Studio 2017 원격 도구 모든 Visual Studio 2017 버전과 호환 가능합니다. 디바이스 운영 체제(x86, x64(AMD64) 또는 ARM64)와 일치하는 버전을 다운로드합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
Visual Studio 2015 원격 도구 Visual Studio 2015용 원격 도구는 My.VisualStudio.com 사용할 수 있습니다. 메시지가 표시되면 무료 Visual Studio Dev Essentials 프로그램에 가입하거나 Visual Studio 구독 ID로 로그인합니다. Windows Server에서 원격 도구 다운로드에 대한 도움말은 파일 다운로드 차단 해제를 참조하세요.
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을 사용합니다.

일부 시나리오에서는 파일 공유에서 원격 디버거를 실행하는 것이 가장 효율적일 수 있습니다. 자세한 내용은 파일 공유 원격 디버거 실행참조하세요.

원격 디버거 설정

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

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

    관리자 권한으로 실행 중이거나 다른 사용자 계정(예: IIS)에서 실행되는 프로세스에 연결하려는 경우 원격 디버거 앱을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행 선택합니다. 자세한 내용은 원격 디버거를 관리자로 실행하는 방법을 참조하세요.

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

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

    Screenshot of remote debugger configuration.원격 디버거 구성의 스크린샷 원격 디버거 구성Remote Debugger configuration

    Screenshot of remote debugger configuration.원격 디버거 구성의 스크린샷 원격 디버거 구성Remote Debugger configuration

    Windows Server 2008 R2에서만 발생하는 Windows Web Services API가 설치되지 않은 경우 설치 단추를 선택합니다.

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

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

    다음으로, 원격 디버깅 구성을 선택하여 원격 디버거를 시작합니다.

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

    원격 디버거 창 스크린샷

    원격 디버거 창 스크린샷

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

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

<Remote debugger installation directory>\msvsmon.exe

메모

추가 사용자에 대한 권한을 추가하거나, 인증 모드를 변경하거나, 원격 디버거에 대한 포트 번호를 변경해야 하는 경우 원격 디버거구성을 참조하세요.

C++ 프로젝트 원격 디버그

다음 절차에서 프로젝트의 경로는 C:\remotetemp이고 원격 컴퓨터의 이름은 MySurface .

  1. C++ 콘솔 애플리케이션을 CppConsoleApp로 만들기

  2. 애플리케이션에서 쉽게 연결할 수 있는 중단점(예: CppConsoleApp.cpp)을 main 함수에 설정합니다.

  3. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성선택합니다. 디버깅 탭을 엽니다.

  4. 디버거를 설정하여 원격 Windows 디버거 시작합니다.

    Visual Studio 솔루션 탐색기 속성의 디버깅 탭 스크린샷 시작할 디버거 속성은 원격 Windows 디버거로 설정됩니다.

  5. 속성을 다음과 같이 변경합니다.

    설정 가치
    원격 명령 C:\remotetemp\CppConsoleApp.exe
    작업 디렉터리 C:\r이모티콘
    원격 서버 이름 MySurface:포트 번호
    연결 Windows 인증을 사용하는 원격 접속
    디버거 유형 원어민 전용
    배포 디렉터리 C:\r이모티콘
    배포할 추가 파일 $(ProjectDir)\data

    추가 폴더를 배포하고 폴더의 모든 파일을 동일한 폴더에 배포하려면 폴더 이름을 지정합니다.

    속성에 대한 자세한 내용은 C++ 디버그 구성 대한Project 설정을 참조하세요.

  6. 솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 configuration Manager 선택합니다.

  7. 디버그 구성의 경우 배포 확인란을 선택합니다.

    Visual Studio 솔루션 탐색기의 Configuration Manager 스크린샷 디버그 구성이 선택되고 배포가 선택됩니다.

  8. 디버깅을 시작합니다(디버그 > 디버깅 시작또는 F5 ).

  9. 실행 파일은 원격 컴퓨터에 자동으로 배포됩니다.

  10. 메시지가 표시되면 네트워크 자격 증명을 입력하여 원격 컴퓨터에 연결합니다.

    필요한 자격 증명은 네트워크의 보안 구성과 관련이 있습니다. 예를 들어 도메인 컴퓨터에서 보안 인증서를 선택하거나 도메인 이름과 암호를 입력할 수 있습니다. 도메인이 아닌 컴퓨터에서 올바른 암호와 함께 컴퓨터 이름 및 유효한 사용자 계정 이름(예: MySurface\name@something.com)을 입력할 수 있습니다.

  11. Visual Studio 컴퓨터에서 중단점에서 실행이 중지된 것을 볼 수 있습니다.

    또는 파일을 별도의 단계로 배포할 수 있습니다. 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭한배포를 선택합니다.

    애플리케이션에 필요한 비코드 파일이 있는 경우 원격 Windows 디버거가 선택된 디버거 속성 페이지의 디버거 배포할 추가 파일의 세미콜론으로 구분된 목록에서 지정할 수.

    또는 프로젝트에 파일을 포함하고 각 파일의 속성 페이지에서 Content 속성을 로 설정할 수 있습니다. 이러한 파일은 원격 Windows 디버거가 선택된 디버거 속성 페이지에 지정된 배포 디렉터리 복사됩니다. 항목 유형파일 복사로 변경하고, 파일을 Deployment Directory의 하위 폴더로 복사해야 하는 경우에 필요한 추가 속성을 지정할 수도 있습니다.

원격 기호를 사용하여 디버깅 설정

Visual Studio 컴퓨터에서 생성한 기호를 사용하여 코드를 디버그할 수 있어야 합니다. 로컬 기호를 사용하는 경우 원격 디버거의 성능이 훨씬 향상됩니다.

원격 기호를 사용해야 하는 경우 도구 > 옵션 > 디버깅 > 기호기호 검색 경로에 Windows 파일 공유를 추가하여 Visual Studio에서 원격 기호를 지정해야 합니다.