Удаленная отладка проекта C++ в Visual Studio

Чтобы выполнить отладку приложения Visual Studio на другом компьютере, установите и запустите удаленные средства на компьютере, где будет развернуто приложение, настройте проект для подключения к удаленному компьютеру из Visual Studio, а затем разверните и запустите приложение.

Сведения об удаленной отладке универсальных приложений Windows (UWP) можно найти в разделе "Отладка установленного пакета приложений".

Требования

Удаленный отладчик поддерживается в Windows 7 и более поздних версиях Windows Server, начиная с Windows Server 2008 с пакетом обновления 2 . Полный список требований см. в разделе Требования.

Скачивание и установка удаленных средств

На удаленном устройстве или сервере, на котором требуется выполнить отладку, а не на компьютере Visual Studio, скачайте и установите правильную версию удаленных средств из ссылок в следующей таблице.

• Скачайте последние средства удаленного доступа для вашей версии Visual Studio. Последняя версия средств удаленного доступа совместима с более ранними версиями Visual Studio, но более ранние версии удаленных средств несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2019, скачайте последнее обновление средств удаленного доступа для Visual Studio 2019. В этом сценарии не скачивайте средства удаленного доступа для Visual Studio 2022.)
• Скачайте удаленные средства с той же архитектурой, что и компьютер, на котором вы устанавливаете их. Например, если вы хотите выполнить отладку 32-разрядного приложения на удаленном компьютере под управлением 64-разрядной операционной системы, установите 64-разрядные средства удаленного доступа.
• Если вы выполняете удаленную отладку приложения ARM64EC на устройстве ARM64, установите удаленные средства ARM64, а затем запустите удаленный отладчик x64, который устанавливается с этими средствами. Это можно найти в каталоге: Program Files (x86)\Microsoft Visual Studio<версия>\Common7\IDE\Remote Debugger\x64.

Вы можете запустить удаленный отладчик, скопировав msvsmon.exe на удаленный компьютер, а не установив удаленные средства. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только при установке удаленных средств. Если вы хотите запустить удаленный отладчик в качестве службы, может потребоваться использовать мастер настройки. Дополнительные сведения см. в разделе (необязательно) Настройка удаленного отладчика в качестве службы.

Настройка удаленного отладчика

1. На удаленном компьютере найдите и запустите удаленный отладчик из меню "Пуск".

   Если у вас нет административных разрешений на удаленном компьютере, щелкните правой кнопкой мыши приложение удаленного отладчика и выберите запустить от имени администратора. В противном случае просто запустите его нормально.

   Если вы планируете подключиться к процессу, работающему в качестве администратора, или запускается под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши приложение удаленного отладчика и выберите Запустить от имени администратора. Дополнительные сведения см. в статье Запуск удаленного отладчика в качестве администратора.

2. При первом запуске удаленного отладчика (или перед его настройкой) появится мастер конфигурации удаленной отладки .

   В большинстве сценариев выберите Далее, пока не дойдёте до страницы настройки брандмауэра Windows мастера.

   

   

   Если API веб-служб Windows не установлен, что возможно только в Windows Server 2008 R2, нажмите кнопку Установить.

3. Выберите хотя бы один тип сети, в который вы хотите использовать удаленные средства. Если компьютеры подключены через домен, необходимо выбрать первый элемент. Если компьютеры подключены через рабочую или домашнюю группу, выберите второй или третий элемент соответствующим образом.

   Затем нажмите кнопку Готово, чтобы запустить удаленный отладчик.

   Затем выберите Настроить удаленную отладку, чтобы запустить удаленный отладчик.

4. После завершения настройки появится окно удаленного отладчика.

   

   

   Теперь удаленный отладчик ожидает подключения. Используйте имя сервера и номер порта, показанные для задания конфигурации удаленного подключения в Visual Studio.

Чтобы остановить удаленный отладчик, выберите Файл>Выйти. Его можно перезапустить из меню "Пуск" или из командной строки:

<Remote debugger installation directory>\msvsmon.exe

Удаленная отладка проекта C++

В следующей процедуре путь проекта — C:\remotetemp, а имя удаленного компьютера — MySurface.

1. Создание консольного приложения C++ с именем CppConsoleApp

2. Установите точку останова в приложении там, где это легко, например, в файле CppConsoleApp.cpp, в функции main.

3. В обозревателе решений щелкните правой кнопкой мыши на проект и выберите пункт Свойства. Откройте вкладку Отладка.

4. Установите отладчик для запускаудаленного отладчика Windows.

   

5. Внесите следующие изменения в свойства:

   Настройка	Ценность
   Удаленная команда	C:\remotetemp\CppConsoleApp.exe
   Рабочий каталог	C:\rэмотемп
   Имя удаленного сервера	MySurface:номер порта
   Связь	Удаленный доступ с проверкой подлинности Windows
   Тип отладчика	Только для родной среды
   Каталог развертывания	C:\rэмотемп
   Дополнительные файлы для развертывания	$(ProjectDir)\data

   Если вы развертываете дополнительные папки и хотите, чтобы все файлы из папки развертывались в одну папку, укажите имя папки.

   Дополнительные сведения о свойствах см. в параметрах проекта дляконфигурации отладки C++.

6. В обозревателе решений щелкните решение правой кнопкой мыши и выберите Configuration Manager.

7. Для конфигурации отладки установите флажок Развернуть.

   

8. Запуск отладки (Debug > Начать отладкуили F5).

9. Исполняемый файл автоматически развертывается на удаленном компьютере.

10. При появлении запроса введите сетевые учетные данные для подключения к удаленному компьютеру.

    Необходимые учетные данные зависят от конфигурации безопасности сети. Например, на компьютере домена можно выбрать сертификат безопасности или ввести доменное имя и пароль. На компьютере, отличном от домена, можно ввести имя компьютера и допустимое имя учетной записи пользователя, например MySurface\name@something.com, а также правильный пароль.

11. На компьютере Visual Studio вы увидите, что выполнение останавливается в точке останова.

    Совет

    Кроме того, файлы можно развернуть как отдельный шаг. В обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите Развернуть.

    Если у вас есть файлы, не относящиеся к коду, которые требуются для приложения, их можно указать в списке с точкой с запятой в Дополнительные файлы для развертывания на странице свойств Отладчик при выбранном Удаленном отладчике Windows.

    Кроме того, вы можете включить файлы в проект и задать для свойства содержимого значение Да на странице свойств для каждого файла. Эти файлы копируются в каталог развертывания , указанный на странице свойств отладчика с выбраным удалённым отладчиком Windows . Можно также изменить типа элемента на "Копировать файл" и указать дополнительные свойства, если вам потребуется скопировать файлы в подкаталог каталога развертывания.

Настройка отладки с использованием удаленных символов

Вы должны иметь возможность отлаживать код с помощью символов, которые вы создаете на компьютере Visual Studio. Производительность удаленного отладчика гораздо лучше при использовании локальных символов.

Если необходимо использовать удалённые символы, их нужно указать в Visual Studio, добавив общую папку Windows к пути поиска символов в Tools > Options > Отладка > Символы.

Связанное содержимое

• Отладка в Visual Studio
• Первый взгляд на отладчик
• настройка брандмауэра Windows для удаленной отладки
• Назначения Портов Удаленного Отладчика
• Удаленная отладка ASP.NET на IIS-компьютере
• ошибки удаленной отладки и устранение неполадок