Удаленная отладка visual studio 2019
Visual Studio можно использовать для запуска, отладки, профилирования и тестирования приложения универсальной платформы Windows (UWP) на другом компьютере или устройстве. Выполнение приложения UWP на удаленном компьютере особенно полезно, если компьютер с Visual Studio не поддерживает специальные функции UWP, такие как сенсорное управление, географическое расположение или ориентация устройства.
Предварительные требования
Для отладки приложения UWP на удаленном устройстве из Visual Studio:
- Проект Visual Studio должен быть настроен для удаленной отладки.
- Удаленный компьютер и компьютер Visual Studio должны быть подключены по сети или соединены напрямую с помощью кабеля USB или Ethernet. Отладка через Интернет не поддерживается.
- Как на компьютере с Visual Studio, так и на удаленном компьютере нужно включить режим разработчика.
- На удаленных компьютерах должны быть запущены инструменты удаленной отладки для Visual Studio.
- Некоторые версии Windows 10 запускают инструменты удаленной отладки автоматически. Если это не произошло, установите и запустите инструменты удаленной отладки для Visual Studio.
- Устройства Windows Mobile 10 не используют и не поддерживают инструменты удаленной отладки.
Настройка проекта Visual Studio для удаленной отладки
Удаленное устройство для подключения указывается в свойствах проекта. Конкретные параметры зависят от языка программирования.
По умолчанию на странице свойств задается значение Универсальный (незашифрованный протокол) для параметра Тип проверки подлинности для удаленных подключений Windows 10. Возможно, что для подключения к удаленному отладчику для этого параметра нужно будет выбрать значение Без проверки подлинности. Протоколы Универсальный (незашифрованный протокол) и Без проверки подлинности не предусматривают сетевую защиту, поэтому данные, передаваемые между компьютером разработки и удаленным компьютером, уязвимы. Выбирайте эти типы проверки подлинности только для доверенных сетей, которые точно не подвержены риску вредоносного или злонамеренного трафика.
Если вы выберете проверку подлинности Windows как Тип проверки подлинности, вам нужно будет при отладке войти на удаленный компьютер. Удаленный отладчик должен также выполняться в режиме Проверка подлинности Windows и с той же учетной записью пользователя, что и на компьютере Visual Studio.
Выберите вкладку Отладка.
В разделе Целевое устройство выберите Удаленный компьютер для удаленного компьютера или Устройство для устройства Windows Mobile 10, подключенного напрямую.
Для удаленного компьютера введите сетевое имя или IP-адрес в поле Удаленный компьютер или выберите Поиск, чтобы выполнить поиск устройства в диалоговом окне Удаленные подключения.
Настройка проекта C++ для удаленной отладки
Щелкните правой кнопкой мыши проект C++ в обозревателе решений Visual Studio, щелкните значок Свойства и нажмите сочетание клавиш Alt+Enter или щелкните проект правой кнопкой мыши и выберите Свойства.
Откройте вкладку Отладка.
В разделе Отладчик для запуска выберите Удаленный компьютер для удаленного компьютера или Устройство для устройства Windows Mobile 10, подключенного напрямую.
Для удаленного компьютера введите или выберите сетевое имя или IP-адрес в поле Имя компьютера или откройте раскрывающийся список и выберите Найти, чтобы выполнить поиск устройства в диалоговом окне Удаленные подключения.
Работа с диалоговым окном "Удаленные подключения"
В диалоговом окне Удаленные подключения можно выполнить поиск по имени или IP-адресу удаленного компьютера или воспользоваться функцией автоматического обнаружения подключений, щелкнув значок обновления с закругленной стрелкой. В этом диалоговом окне выполняется поиск только тех устройств в локальной подсети, на которых в этот момент запущен удаленный отладчик. Не все устройства можно обнаружить в диалоговом окне Удаленные подключения.
Если не удается подключиться к удаленному устройству по имени, попробуйте использовать его IP-адрес. Чтобы определить IP-адрес, на удаленном устройстве введите в окне командной строки ipconfig. IP-адрес выглядит как IPv4-адрес .
Загрузка и установка инструментов удаленной отладки для Visual Studio
Для отладки приложений на удаленном компьютере с помощью Visual Studio на удаленном компьютере должны быть запущены инструменты удаленной отладки для Visual Studio.
- Устройства Windows Mobile 10 не используют и не поддерживают инструменты удаленной отладки.
- Компьютеры под управлением Windows 10 с обновлением Creator Update (версия 1703) и более поздних версий, устройства с Windows 10 Xbox, IoT и HoloLens устанавливают инструменты удаленной отладки автоматически при развертывании приложения.
- На компьютерах с Windows 10 без обновления Creator Update необходимо вручную загрузить, установить и запустить инструменты удаленной отладки до начала отладки.
Скачивание и установка инструментов удаленной отладки
На удаленном устройстве или сервере, на котором требуется выполнить отладку (не на компьютере Visual Studio), скачайте и установите правильную версию инструментов удаленной отладки по ссылкам, приведенным в следующей таблице.
- Скачайте последние версии инструментов удаленной отладки для вашей версии Visual Studio. Последняя версия инструментов удаленной отладки совместима с более ранними версиями Visual Studio, но более ранние версии инструментов удаленной отладки несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2017, скачайте последнее обновление инструментов удаленной отладки для Visual Studio 2017. В этом случае не следует скачивать средства удаленной отладки для Visual Studio 2019.)
- Скачивайте средства удаленной отладки с архитектурой, соответствующей архитектуре компьютера, на котором они будут устанавливаться. Например, если вы хотите отлаживать 32-разрядное приложение на удаленном компьютере под управлением 64-разрядной операционной системы, установите 64-разрядные инструменты удаленной отладки.
Чтобы запустить удаленный отладчик, можно не устанавливать инструменты удаленной отладки, а просто скопировать файл msvsmon.exe на удаленный компьютер. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только после установки инструментов удаленной отладки. Этот мастер может потребоваться для настройки, если вы захотите запускать удаленный отладчик как службу. Дополнительные сведения см. в разделе (Дополнительно) Настройка удаленного отладчика как службы.
- Для отладки приложений для Windows 10 и более поздних версий на устройствах ARM используйте ARM64 (доступно с последней версией инструментов удаленной отладки).
- Для отладки приложений Windows 10 на устройствах Windows RT используйте ARM, доступный только при загрузке инструментов удаленной отладки Visual Studio 2015.
Настройка инструментов удаленной отладки
На удаленном компьютере найдите Удаленный отладчик в меню Пуск и запустите его.
Если у вас нет прав администратора на удаленном компьютере, щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите Запуск от имени администратора. В противном случае просто запустите его, как обычно.
Если вы планируете присоединиться к процессу, который работает от имени администратора или под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите пункт Запуск от имени администратора. Дополнительные сведения см. в разделе Запуск удаленного отладчика в качестве администратора.
При первом запуске удаленного отладчика (или перед его настройкой) появится диалоговое окно Конфигурация удаленной отладки.
Если API-интерфейс веб-служб Windows не установлен (это возможно только в Windows Server 2008 R2), нажмите кнопку Установить.
Выберите хотя бы один тип сетей, для которых вы намерены использовать инструменты удаленной отладки. Если компьютеры соединены через домен, необходимо выбрать первый пункт. Если компьютеры соединены через рабочую или домашнюю группу, выберите второй или третий пункт соответственно.
Щелкните Настроить удаленную отладку, чтобы настроить брандмауэр и запустить удаленный отладчик.
По завершении настройки появится окно Удаленный отладчик.
Теперь удаленный отладчик ожидает подключения. Введите предложенные имя сервера и номер порта, чтобы настроить конфигурацию удаленного подключения в Visual Studio.
Чтобы прекратить работу удаленного отладчика, щелкните Файл > Выход. Его можно снова запустить из меню Пуск или из командной строки:
Удаленная отладка приложений UWP
Удаленная отладка работает так же, как и локальная.
На удаленных устройствах под управлением Windows 10 без обновления Creator Update должен быть запущен монитор удаленной отладки (msvsmon.exe).
На компьютере с Visual Studio рядом с зеленой стрелкой на панели инструментов должен отображаться правильный целевой объект отладки (удаленный компьютер или устройство).
Запустите отладку, выбрав меню Отладка > Начать отладку, нажав клавишу F5 или щелкнув зеленую стрелку на панели инструментов.
Проект перекомпилируется, а затем развернется и запустится на удаленном устройстве. Отладчик приостанавливает выполнение в точках останова, что позволяет выполнить шаги с заходом, шаги с обходом и шаги с выходом в коде.
Если нужно завершить отладку и закрыть удаленное приложение, выберите меню Отладка > Остановить отладку или нажмите клавиши Shift+F5.
You can debug a Visual Studio application that has been deployed on a different computer. To do so, you use the Visual Studio remote debugger.
For in-depth instructions on remote debugging, see these topics.
If you just want to download and install the remote debugger and don't need any additional instructions for your scenario, follow the steps in this article.
Download and Install the remote tools
On the remote device or server that you want to debug on, rather than the Visual Studio machine, download and install the correct version of the remote tools from the links in the following table.
- Download the most recent remote tools for your version of Visual Studio. The latest remote tools version is compatible with earlier Visual Studio versions, but earlier remote tools versions aren't compatible with later Visual Studio versions. (For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. In this scenario, do not download the remote tools for Visual Studio 2019.)
- Download the remote tools with the same architecture as the machine you're installing them on. For example, if you want to debug a 32-bit app on a remote computer running a 64-bit operating system, install the 64-bit remote tools.
You can run the remote debugger by copying msvsmon.exe to the remote computer, rather than installing the remote tools. However, the Remote Debugger Configuration Wizard (rdbgwiz.exe) is available only when you install the remote tools. You may need to use the wizard for configuration if you want to run the remote debugger as a service. For more information, see (Optional) Configure the remote debugger as a service.
- To debug Windows 10 or later apps on ARM devices, use ARM64, which is available with the latest version of the remote tools.
- To debug Windows 10 apps on Windows RT devices, use ARM, which is available only in the Visual Studio 2015 remote tools download.
Requirements
Supported Operating Systems
The remote computer must be running one of the following operating systems:
Windows 10 (not phone)
Windows 8 or 8.1 (not phone)
Windows 7 Service Pack 1
Windows Server 2016
Windows Server 2012 or Windows Server 2012 R2
Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1
Windows Phone requires a USB connection to debug (it does not require the remote tools).
Supported Hardware Configurations
1.6 GHz or faster processor
1 GB of RAM (1.5 GB if running on a virtual machine)
1 GB of available hard disk space
5400-RPM hard drive
DirectX 9-capable video card running at 1024 x 768 or higher display resolution
Network configuration
The remote computer and the Visual Studio computer must be connected over a network, workgroup, or homegroup, or else connected directly through an Ethernet cable. Debugging between two computers connected through a proxy isn't supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries isn't recommended and may fail or be unacceptably slow.
(Optional) To run the remote debugger from a file share
You can find the remote debugger (msvsmon.exe) on a computer with Visual Studio Community, Professional, or Enterprise already installed. For some scenarios, the easiest way to set up remote debugging is to run the remote debugger (msvsmon.exe) from a file share. For usage limitations, see the remote debugger's Help page (Help > Usage in the remote debugger).
Find msvsmon.exe in the directory matching your version of Visual Studio:
Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Share the Remote Debugger folder on the Visual Studio computer.
On the remote computer, run msvsmon.exe from the shared folder. Follow the setup instructions.
For command line installation and command line reference, see the Help page for msvsmon.exe by typing msvsmon.exe /? in the command line on the computer with Visual Studio installed (or go to Help > Usage in the remote debugger).
Set up the remote debugger
On the remote computer, find and start the Remote Debugger from the Start menu.
If you don't have administrative permissions on the remote computer, right-click the Remote Debugger app and select Run as administrator. Otherwise, just start it normally.
If you are planning to attach to a process which is running as an administrator, or is running under a different user account (such as IIS), right-click the Remote Debugger app and select Run as administrator. For more information, see Run the remote debugger as an administrator.
The first time you start the remote debugger (or before you have configured it), the Remote Debugging Configuration dialog box appears.
If the Windows Web Services API is not installed, which happens only on Windows Server 2008 R2, select the Install button.
Select at least one network type you want to use the remote tools on. If the computers are connected through a domain, you must choose the first item. If the computers are connected through a workgroup or homegroup, choose the second or third item as appropriate.
Select Configure remote debugging to configure the firewall and start the remote debugger.
When configuration is complete, the Remote Debugger window appears.
The remote debugger is now waiting for a connection. Use the server name and port number shown to set the remote connection configuration in Visual Studio.
To stop the remote debugger, select File > Exit. You can restart it from the Start menu, or from the command line:
Configure the remote debugger
You can change some aspects of the configuration of the remote debugger after you have started it for the first time.
If you need to add permissions for other users to connect to the remote debugger, choose Tools > Permissions. You must have administrator privileges to grant or deny permissions.
You can run the remote debugger under a user account that differs from the user account you are using on the Visual Studio computer, but you must add the different user account to the remote debugger's permissions.
Alternatively, you can start the remote debugger from the command line with the /allow parameter: msvsmon /allow .
If you need to change the Authentication mode or the port number, or specify a timeout value for the remote tools: choose Tools > Options.
For a listing of the port numbers used by default, see Remote Debugger Port Assignments.
You can choose to run the remote tools in No Authentication mode, but this mode is strongly discouraged. There is no network security when you run in this mode. Choose the No Authentication mode only if you are sure that the network is not at risk from malicious or hostile traffic.
(Optional) Configure the remote debugger as a service
If you want to configure the remote debugger as a service, follow these steps.
Find the Remote Debugger Configuration Wizard (rdbgwiz.exe). (This is a separate application from the Remote Debugger.) It is available only when you install the remote tools. It is not installed with Visual Studio.
Start running the configuration wizard. When the first page comes up, click Next.
Check the Run the Visual Studio Remote Debugger as a service checkbox.
Add the name of the user account and password.
You may need to add the Log on as a service user right to this account (Find Local Security Policy (secpol.msc) in the Start page or window (or type secpol at a command prompt). When the window appears, double-click User Rights Assignment, then find Log on as a service in the right pane. Double-click it. Add the user account to the Properties window and click OK). Click Next.
Select the type of network that you want the remote tools to communicate with. At least one network type must be selected. If the computers are connected through a domain, you should choose the first item. If the computers are connected through a workgroup or homegroup, you should choose the second or third items. Click Next.
If the service can be started, you will see You have successfully completed the Visual Studio Remote Debugger Configuration Wizard. If the service cannot be started, you will see Failed to complete the Visual Studio Remote Debugger Configuration Wizard. The page also gives some tips to follow to get the service to start.
Click Finish.
At this point the remote debugger is running as a service. You can verify this by going to Control Panel > Services and looking for Visual Studio Remote Debugger.
You can stop and start the remote debugger service from Control Panel > Services.
Set up debugging with remote symbols
You should be able to debug your code with the symbols you generate on the Visual Studio computer. The performance of the remote debugger is much better when you use local symbols. If you must use remote symbols, you need to tell the remote debugging monitor to look for symbols on the remote machine.
Starting in Visual Studio 2013 Update 2, you can use the following msvsmon command-line switch to use remote symbols for managed code: Msvsmon /FallbackLoadRemoteManagedPdbs
Вы можете отладить приложение Visual Studio, развернутое на другом компьютере. Для этого используется удаленный отладчик Visual Studio.
Подробные инструкции по удаленной отладке см. в следующих разделах.
Если нужно просто скачать и установить удаленный отладчик, и вам не нужны дополнительные инструкции для своего сценария, выполните действия, описанные в этой статье.
Скачивание и установка инструментов удаленной отладки
На удаленном устройстве или сервере, на котором требуется выполнить отладку (не на компьютере Visual Studio), скачайте и установите правильную версию инструментов удаленной отладки по ссылкам, приведенным в следующей таблице.
- Скачайте последние версии инструментов удаленной отладки для вашей версии Visual Studio. Последняя версия инструментов удаленной отладки совместима с более ранними версиями Visual Studio, но более ранние версии инструментов удаленной отладки несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2017, скачайте последнее обновление инструментов удаленной отладки для Visual Studio 2017. В этом случае не следует скачивать средства удаленной отладки для Visual Studio 2019.)
- Скачивайте средства удаленной отладки с архитектурой, соответствующей архитектуре компьютера, на котором они будут устанавливаться. Например, если вы хотите отлаживать 32-разрядное приложение на удаленном компьютере под управлением 64-разрядной операционной системы, установите 64-разрядные инструменты удаленной отладки.
Чтобы запустить удаленный отладчик, можно не устанавливать инструменты удаленной отладки, а просто скопировать файл msvsmon.exe на удаленный компьютер. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только после установки инструментов удаленной отладки. Этот мастер может потребоваться для настройки, если вы захотите запускать удаленный отладчик как службу. Дополнительные сведения см. в разделе (Дополнительно) Настройка удаленного отладчика как службы.
- Для отладки приложений для Windows 10 и более поздних версий на устройствах ARM используйте ARM64 (доступно с последней версией инструментов удаленной отладки).
- Для отладки приложений Windows 10 на устройствах Windows RT используйте ARM, доступный только при загрузке инструментов удаленной отладки Visual Studio 2015.
Требования
Supported Operating Systems
Удаленный компьютер должен работать под управлением одной из следующих операционных систем:
Windows 10 (не телефон)
Windows 8 или 8.1 (не телефон)
Windows 7 с пакетом обновления 1 (SP1)
Windows Server 2016
Windows Server 2012 или Windows Server 2012 R2
Windows Server 2008 с пакетом обновления 2 (SP2), Windows Server 2008 R2 с пакетом обновления 1 (SP1)
Для отладки Windows Phone требуется USB-подключение (инструменты удаленной отладки не требуются).
Поддерживаемые конфигурации оборудования
Процессор с тактовой частотой 1,6 ГГц или большей
1 ГБ ОЗУ (1,5 ГБ при выполнении в виртуальной машине)
1 ГБ доступного пространства на жестком диске
Жесткий диск 5400 об/мин
Видеоадаптер с поддержкой DirectX 9 и разрешением экрана 1024x768 или выше
Конфигурация сети
Удаленный компьютер и компьютер Visual Studio должны быть подключены по сети, объединены в рабочую или домашнюю группу либо соединены напрямую с помощью кабеля Ethernet. Отладка между двумя компьютерами, подключенными через прокси-сервер, не поддерживается. Отладка через подключение с высокой задержкой или низкой пропускной способностью, например при подключении к Интернету по коммутируемой линии или при размещении компьютеров в разных странах, может приводить к сбоям или работать недопустимо медленно и поэтому не рекомендуется.
(Дополнительно) Запуск удаленного отладчика из общей папки
Удаленный отладчик (msvsmon.exe) можно найти на компьютере с уже установленным Visual Studio Community, Professional или Enterprise. В некоторых сценариях самый простой способ настроить удаленную отладку — запустить удаленный отладчик (msvsmon.exe) из общей папки. Об ограничениях использования см. на странице справки удаленного отладчика (Справка > Использование в удаленном отладчике).
Найдите файл msvsmon.exe в каталоге, соответствующем вашей версии Visual Studio:
Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe
Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe
Предоставьте общий доступ к папке удаленного отладчика на компьютере с Visual Studio.
На удаленном компьютере запустите файл msvsmon.exe из общей папки. Следуйте инструкциям по установке.
Сведения об установке из командной строки и справочник по командной строке см. на странице справки для msvsmon.exe. Для этого введите msvsmon.exe /? в командной строке на компьютере с установленным Visual Studio (или перейдите в раздел Справка > Использование в удаленном отладчике).
Установка удаленного отладчика
На удаленном компьютере найдите Удаленный отладчик в меню Пуск и запустите его.
Если у вас нет прав администратора на удаленном компьютере, щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите Запуск от имени администратора. В противном случае просто запустите его, как обычно.
Если вы планируете присоединиться к процессу, который работает от имени администратора или под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите пункт Запуск от имени администратора. Дополнительные сведения см. в разделе Запуск удаленного отладчика в качестве администратора.
При первом запуске удаленного отладчика (или перед его настройкой) появится диалоговое окно Конфигурация удаленной отладки.
Если API-интерфейс веб-служб Windows не установлен (это возможно только в Windows Server 2008 R2), нажмите кнопку Установить.
Выберите хотя бы один тип сетей, для которых вы намерены использовать инструменты удаленной отладки. Если компьютеры соединены через домен, необходимо выбрать первый пункт. Если компьютеры соединены через рабочую или домашнюю группу, выберите второй или третий пункт соответственно.
Щелкните Настроить удаленную отладку, чтобы настроить брандмауэр и запустить удаленный отладчик.
По завершении настройки появится окно Удаленный отладчик.
Теперь удаленный отладчик ожидает подключения. Введите предложенные имя сервера и номер порта, чтобы настроить конфигурацию удаленного подключения в Visual Studio.
Чтобы прекратить работу удаленного отладчика, щелкните Файл > Выход. Его можно снова запустить из меню Пуск или из командной строки:
Настройка удаленного отладчика
После первого запуска удаленного отладчика можно изменить некоторые аспекты его конфигурации.
Если нужно добавить разрешения на подключение к удаленному отладчику для других пользователей, выберите Инструменты > Разрешения. Для предоставления разрешений или отказа в предоставлении необходимо обладать правами администратора.
Вы можете запускать удаленный отладчик в учетной записи пользователя, отличной от используемой на компьютере Visual Studio, но эту учетную запись нужно добавить в список разрешений удаленного отладчика.
Кроме того, удаленный отладчик можно запускать из командной строки с помощью параметра /allow : msvsmon /allow .
Чтобы изменить режим аутентификации или номер порта либо задать значение времени ожидания для инструментов удаленной отладки, выберите Инструменты > Параметры.
Список номеров портов, используемых по умолчанию, см. в разделе Назначения портов удаленного отладчика.
Вы можете запускать инструменты удаленной отладки в режиме "без аутентификации", однако настоятельно рекомендуется не использовать этот режим. При работе в этом режиме сетевая безопасность не обеспечивается. Режим без аутентификации можно выбрать, только если вы уверены в отсутствии вредоносного или опасного трафика.
(Дополнительно) Настройка удаленного отладчика как службы
Чтобы настроить удаленный отладчик как службу, выполните следующие действия.
Найдите мастер настройки удаленного отладчика (rdbgwiz.exe). (Это отдельное приложение, не входящее в состав удаленного отладчика.) Он доступен только в том случае, если вы установили инструменты удаленной отладки. Вместе с Visual Studio он не устанавливается.
Запустите мастер настройки. Когда появится первая страница, нажмите кнопку Далее.
Установите флажок Запускать Удаленный отладчик Visual Studio как службу.
Добавьте имя учетной записи пользователя и пароль.
Теперь удаленный отладчик должен работать как служба. Чтобы проверить, так ли это, выберите Панель управления > Службы и найдите Удаленный отладчик Visual Studio.
Останавливать и запускать службу удаленного отладчика можно с помощью компонента Панель управления > Службы.
Настройка отладки с использованием удаленных символов
Вы можете отлаживать код с использованием символов, созданных на компьютере Visual Studio. Производительность удаленного отладчика гораздо выше при использовании локальных символов. Если необходимо использовать удаленные символы, укажите, что монитор удаленной отладки должен искать символы на удаленном компьютере.
Начиная с версии Visual Studio 2013 с обновлением 2 можно использовать следующий параметр командной строки msvsmon для использования удаленных символов для управляемого кода: Msvsmon /FallbackLoadRemoteManagedPdbs
To debug a Visual Studio application that has been deployed on a different computer, install and run the remote tools on the computer where you deployed your app, configure your project to connect to the remote computer from Visual Studio, and then run your app.
For information about remote debugging Universal Windows Apps (UWP), see Debug an Installed App Package.
Requirements
The remote debugger is supported on Windows 7 and newer (not phone) and versions of Windows Server starting with Windows Server 2008 Service Pack 2. For a complete list of requirements, see Requirements.
Debugging between two computers connected through a proxy is not supported. Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries is not recommended and may fail or be unacceptably slow.
Download and Install the remote tools
On the remote device or server that you want to debug on, rather than the Visual Studio machine, download and install the correct version of the remote tools from the links in the following table.
- Download the most recent remote tools for your version of Visual Studio. The latest remote tools version is compatible with earlier Visual Studio versions, but earlier remote tools versions aren't compatible with later Visual Studio versions. (For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. In this scenario, do not download the remote tools for Visual Studio 2019.)
- Download the remote tools with the same architecture as the machine you're installing them on. For example, if you want to debug a 32-bit app on a remote computer running a 64-bit operating system, install the 64-bit remote tools.
You can run the remote debugger by copying msvsmon.exe to the remote computer, rather than installing the remote tools. However, the Remote Debugger Configuration Wizard (rdbgwiz.exe) is available only when you install the remote tools. You may need to use the wizard for configuration if you want to run the remote debugger as a service. For more information, see (Optional) Configure the remote debugger as a service.
- To debug Windows 10 or later apps on ARM devices, use ARM64, which is available with the latest version of the remote tools.
- To debug Windows 10 apps on Windows RT devices, use ARM, which is available only in the Visual Studio 2015 remote tools download.
In some scenarios, it can be most efficient to run the remote debugger from a file share. For more information, see Run the remote debugger from a file share.
Set up the remote debugger
On the remote computer, find and start the Remote Debugger from the Start menu.
If you don't have administrative permissions on the remote computer, right-click the Remote Debugger app and select Run as administrator. Otherwise, just start it normally.
If you are planning to attach to a process which is running as an administrator, or is running under a different user account (such as IIS), right-click the Remote Debugger app and select Run as administrator. For more information, see Run the remote debugger as an administrator.
The first time you start the remote debugger (or before you have configured it), the Remote Debugging Configuration dialog box appears.
If the Windows Web Services API is not installed, which happens only on Windows Server 2008 R2, select the Install button.
Select at least one network type you want to use the remote tools on. If the computers are connected through a domain, you must choose the first item. If the computers are connected through a workgroup or homegroup, choose the second or third item as appropriate.
Select Configure remote debugging to configure the firewall and start the remote debugger.
When configuration is complete, the Remote Debugger window appears.
The remote debugger is now waiting for a connection. Use the server name and port number shown to set the remote connection configuration in Visual Studio.
To stop the remote debugger, select File > Exit. You can restart it from the Start menu, or from the command line:
If you need to add permissions for additional users, change the authentication mode, or port number for the remote debugger, see Configure the remote debugger.
Remote debug the project
Create a WPF project named MyWpf.
Set a breakpoint somewhere in the code that is easily reached.
For example, you might set a breakpoint in a button handler. To do this, open MainWindow.xaml, and add a Button control from the Toolbox, then double-click the button to open it's handler.
In Solution Explorer, right-click the project and choose Properties.
On the Properties page, choose the Debug tab.
Otherwise, you change remote debug settings directly in the Debug tab.
Make sure the Working directory text box is empty.
Choose Use remote machine, and type yourmachinename:port in the text box. (The port number is shown in the remote debugger window. The port number increments 2 in each version of Visual Studio).
In this example, use:
MJO-DL:4026 on Visual Studio 2022
MJO-DL:4024 on Visual Studio 2019
MJO-DL:4022 on Visual Studio 2017
Make sure that Enable native code debugging is not selected.
Build the project.
Create a folder on the remote computer that is the same path as the Debug folder on your Visual Studio computer: \MyWPF\MyWPF\bin\Debug.
Copy the executable that you just built from your Visual Studio computer to the newly-created folder on the remote computer.
Do not make changes to the code or rebuild (or you must repeat this step). The executable you copied to the remote machine must exactly match your local source and symbols.
You can copy the project manually, use XCopy, Robocopy, PowerShell, or other options.
Make sure the remote debugger is running on the target machine (If it's not, search for Remote Debugger in the Start menu). The remote debugger window looks like this.
In Visual Studio, start debugging (Debug > Start Debugging, or F5).
If prompted, enter network credentials to connect to the remote machine.
You should see that the WPF application's main window is open on the remote computer.
If necessary, take action to hit the breakpoint. You should see that the breakpoint is active. If it isn't, the symbols for the application haven't loaded. Retry, and if that doesn't work, get information about loading symbols and how troubleshoot them at Understanding symbol files and Visual Studio's symbol settings.
On the Visual Studio machine, you should see that execution has stopped at the breakpoint.
If you have any non-code files that need to be used by the application, you need to include them in the Visual Studio project. Create a project folder for the additional files (in the Solution Explorer, click Add > New Folder). Then add the files to the folder (in the Solution Explorer, click Add > Existing Item, then select the files). On the Properties page for each file, set Copy to Output Directory to Copy always.
Set Up Debugging with Remote Symbols
You should be able to debug your code with the symbols you generate on the Visual Studio computer. The performance of the remote debugger is much better when you use local symbols. If you must use remote symbols, you need to tell the remote debugging monitor to look for symbols on the remote machine.
Starting in Visual Studio 2013 Update 2, you can use the following msvsmon command-line switch to use remote symbols for managed code: Msvsmon /FallbackLoadRemoteManagedPdbs
Чтобы выполнить отладку приложения Visual Studio на другом компьютере, установите и запустите средства удаленной отладки на том компьютере, где будет развернуто приложение, затем настройте в проекте подключение к удаленному компьютеру из Visual Studio и наконец разверните и запустите приложение.
Сведения об удаленной отладке приложений UWP (универсальной платформы Windows) вы найдете в статье Отладка установленного пакета приложения.
Требования
Удаленный отладчик поддерживается в среде Windows 7 и более поздних версий, а также в Windows Server, начиная с версии Windows Server 2008 с пакетом обновления 2 (SP2). Полный список требований см. в разделе Требования.
Отладка между двумя компьютерами, подключенными через прокси-сервер, не поддерживается. Отладка через подключение с высокой задержкой или низкой пропускной способностью, например при подключении к Интернету по коммутируемой линии или при размещении компьютеров в разных странах, может приводить к сбоям или работать недопустимо медленно и поэтому не рекомендуется.
Скачивание и установка инструментов удаленной отладки
На удаленном устройстве или сервере, на котором требуется выполнить отладку (не на компьютере Visual Studio), скачайте и установите правильную версию инструментов удаленной отладки по ссылкам, приведенным в следующей таблице.
- Скачайте последние версии инструментов удаленной отладки для вашей версии Visual Studio. Последняя версия инструментов удаленной отладки совместима с более ранними версиями Visual Studio, но более ранние версии инструментов удаленной отладки несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2017, скачайте последнее обновление инструментов удаленной отладки для Visual Studio 2017. В этом случае не следует скачивать средства удаленной отладки для Visual Studio 2019.)
- Скачивайте средства удаленной отладки с архитектурой, соответствующей архитектуре компьютера, на котором они будут устанавливаться. Например, если вы хотите отлаживать 32-разрядное приложение на удаленном компьютере под управлением 64-разрядной операционной системы, установите 64-разрядные инструменты удаленной отладки.
- Если вы выполняете удаленную отладку приложения ARM64EC на устройстве ARM64, установите инструменты удаленной отладки ARM64, а затем запустите удаленный отладчик 64-разрядной версии, который устанавливается вместе с этими инструментами. Его можно найти в папке Program Files (x86)\Microsoft Visual Studio\Common7\IDE\Remote Debugger\x64.
Чтобы запустить удаленный отладчик, можно не устанавливать инструменты удаленной отладки, а просто скопировать файл msvsmon.exe на удаленный компьютер. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только после установки инструментов удаленной отладки. Этот мастер может потребоваться для настройки, если вы захотите запускать удаленный отладчик как службу. Дополнительные сведения см. в разделе (Дополнительно) Настройка удаленного отладчика как службы.
- Для отладки приложений для Windows 10 и более поздних версий на устройствах ARM используйте ARM64 (доступно с последней версией инструментов удаленной отладки).
- Для отладки приложений Windows 10 на устройствах Windows RT используйте ARM, доступный только при загрузке инструментов удаленной отладки Visual Studio 2015.
В некоторых сценариях запуск удаленного отладчика из общей папки может оказаться самым эффективным решением. Дополнительные сведения см. в разделе Запуск удаленного отладчика из общей папки.
Установка удаленного отладчика
На удаленном компьютере найдите Удаленный отладчик в меню Пуск и запустите его.
Если у вас нет прав администратора на удаленном компьютере, щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите Запуск от имени администратора. В противном случае просто запустите его, как обычно.
Если вы планируете присоединиться к процессу, который работает от имени администратора или под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши приложение Удаленный отладчик и выберите пункт Запуск от имени администратора. Дополнительные сведения см. в разделе Запуск удаленного отладчика в качестве администратора.
При первом запуске удаленного отладчика (или перед его настройкой) появится диалоговое окно Конфигурация удаленной отладки.
Если API-интерфейс веб-служб Windows не установлен (это возможно только в Windows Server 2008 R2), нажмите кнопку Установить.
Выберите хотя бы один тип сетей, для которых вы намерены использовать инструменты удаленной отладки. Если компьютеры соединены через домен, необходимо выбрать первый пункт. Если компьютеры соединены через рабочую или домашнюю группу, выберите второй или третий пункт соответственно.
Щелкните Настроить удаленную отладку, чтобы настроить брандмауэр и запустить удаленный отладчик.
По завершении настройки появится окно Удаленный отладчик.
Теперь удаленный отладчик ожидает подключения. Введите предложенные имя сервера и номер порта, чтобы настроить конфигурацию удаленного подключения в Visual Studio.
Чтобы прекратить работу удаленного отладчика, щелкните Файл > Выход. Его можно снова запустить из меню Пуск или из командной строки:
Если вам нужно добавить разрешения для дополнительных пользователей, изменить режим проверки подлинности или настроить номер порта для удаленного отладчика, воспользуйтесь инструкциями по настройке удаленного отладчика.
Удаленная отладка проекта на C++
В приведенной ниже процедуре проект расположен в папке C:\remotetemp\MyMfc, а удаленный компьютер имеет имя MJO-DL.
Создайте приложение MFC с именем mymfc.
Создайте точку останова в легкодоступном месте приложения, например в файле MainFrm.cpp, в начале CMainFrame::OnCreate .
В обозревателе решений щелкните правой кнопкой мыши проект и выберите Свойства. Откройте вкладку Отладка.
Для параметра Загружаемый отладчик задайте значение Удаленный отладчик Windows.
Внесите в свойства следующие изменения:
Параметр Значение Удаленная команда C:\remotetemp\mymfc.exe Рабочий каталог C:\remotetemp Имя удаленного сервера MJO-DL:portnumber Подключение Удаленный доступ с аутентификацией Windows Тип отладчика Только машинный код Каталог развертывания C:\remotetemp. Дополнительные файлы развертывания C:\data\mymfcdata.txt. Если требуется развернуть дополнительные файлы (необязательно), соответствующая папка должна существовать на обоих компьютерах.
В обозревателе решений щелкните решение правой кнопкой мыши и выберите Диспетчер конфигураций.
Для конфигурации Отладка установите флажок Развертывание.
Начните отладку (выберите Отладка > Начать отладку или нажмите клавишу F5).
Исполняемый файл автоматически развернется на удаленном компьютере.
Если появится запрос на подключение к удаленному компьютеру, введите сетевые учетные данные.
На компьютере с Visual Studio вы должны увидеть, что выполнение остановилось в точке останова.
Кроме того, файлы можно развернуть как отдельный шаг. В обозревателе решений щелкните правой кнопкой мыши узел mymfc и выберите пункт Развернуть.
Если приложению требуются дополнительные файлы, не содержащие код, их можно указать в виде списка файлов, разделенных точками с запятой, в параметре Дополнительные файлы развертывания на странице Удаленный отладчик Windows.
Вместо этого вы можете включить такие файлы в проект и задать для свойства Содержимое значение Да на странице Свойства для каждого файла. Это приведет к тому, что файлы будут скопированы в Каталог развертывания, указанный на странице Удаленный отладчик Windows. Можно также изменить Тип элемента, указав значение Копировать файл, и дополнительные свойства, если файлы нужно копировать во вложенную папку в каталоге развертывания.
Настройка отладки с удаленными символами
Вы можете отлаживать код с использованием символов, созданных на компьютере Visual Studio. Производительность удаленного отладчика гораздо выше при использовании локальных символов. Если необходимо использовать удаленные символы, укажите, что монитор удаленной отладки должен искать символы на удаленном компьютере.
Начиная с версии Visual Studio 2013 с обновлением 2 можно использовать следующий параметр командной строки msvsmon для использования удаленных символов для управляемого кода: Msvsmon /FallbackLoadRemoteManagedPdbs
Читайте также: