Отладка приложений UWP на удаленных компьютерах из Visual Studio

2025-06-12

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.

Настройка проекта C# или Visual Basic для удаленной отладки

Выберите проект C# или Visual Basic в обозревателе решений Visual Studio и щелкните значок "Свойства ", нажмите клавиши ALT+ВВОД или щелкните правой кнопкой мыши и выберите "Свойства".
Выберите вкладку Отладка.
В разделе "Целевое устройство" выберите удаленный компьютер или устройство для устройства с прямым подключением к Windows Mobile 10.
Для удаленного компьютера введите сетевое имя или IP-адрес в поле удаленного компьютера или выберите "Найти ", чтобы найти устройство в диалоговом окне "Удаленные подключения".

Настройка проекта C++ для удаленной отладки

Выберите проект C++ в обозревателе решений Visual Studio и щелкните значок "Свойства ", нажмите клавиши ALT+ВВОД или щелкните правой кнопкой мыши и выберите "Свойства".
Перейдите на вкладку "Отладка ".
В разделе Отладчик для запуска выберите Удаленная машина для удаленного компьютера или Устройство для непосредственно подключенного устройства Windows Mobile 10.
Для удаленного компьютера введите или выберите сетевое имя или IP-адрес в поле "Имя компьютера " или в раскрывающемся списке и выберите "Найти ", чтобы найти устройство в диалоговом окне "Удаленные подключения".

Диалоговое окно "Удаленные подключения"

В диалоговом окне "Удаленные подключения" можно искать определенное имя удаленного компьютера или IP-адрес или автоматически обнаруживать подключения, выбрав значок обновления с округленной стрелкой. Диалоговое окно выполняет поиск только устройств в локальной подсети, на которых в настоящее время выполняется удаленный отладчик. Не все устройства можно обнаружить в диалоговом окне "Удаленные подключения ".

Диалоговое окно

Подсказка

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

Скачивание и установка средств удаленного доступа для Visual Studio

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

Устройства Windows Mobile 10 не требуют или поддерживают удаленные средства.
Компьютеры с Windows 11 и Windows 10 начиная с версии Обновления для Авторов (версия 1703) и более поздних версий, а также устройства на Windows 10, Xbox, IoT и HoloLens автоматически устанавливают удаленные инструменты при развертывании приложения.
На компьютерах с Windows 10 до обновления Creator's Update необходимо вручную скачать, установить и запустить удаленные средства на удаленном компьютере перед началом отладки.

Чтобы скачать и установить удаленные средства, выполните следующие действия.

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

Скачайте последнее обновление средств удаленного доступа для вашей версии Visual Studio. Более ранние версии удаленных средств несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2019, скачайте последнее обновление средств удаленного доступа для Visual Studio 2019. В этом сценарии не скачивайте средства удаленного доступа для Visual Studio 2022.)
Скачайте удаленные средства с той же архитектурой, что и компьютер, на котором вы устанавливаете их. Например, если вы хотите отлаживать приложения x86 на удаленном компьютере под управлением операционной системы x64, установите средства удаленного управления x64. Чтобы выполнить отладку приложений x86, ARM или x64 в операционной системе ARM64, установите удаленные средства ARM64.

Версия	Ссылка	Примечания.
Визуальная студия 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. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. Разблокируйте скачивание файла, чтобы получить помощь с загрузкой средств удаленного доступа.
Visual Studio 2017	удаленные инструменты	Средства удаленного доступа для Visual Studio 2017 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2015	удаленные инструменты	Средства удаленного доступа для Visual Studio 2015 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. В 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. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2013	удаленные инструменты	Страница загрузки в документации по Visual Studio 2013
Visual Studio 2012	удаленные инструменты	Страница загрузки в документации по Visual Studio 2012

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

Замечание

Для отладки приложений Windows 10 или более поздних версий на устройствах ARM используйте ARM64, которая доступна с последней версией удаленных средств.
Чтобы выполнить отладку приложений Windows 10 на устройствах Windows RT, используйте ARM, который доступен только в пакете скачивания удаленных средств разработки Visual Studio 2015.
Чтобы выполнить отладку приложений x64 в операционной системе ARM64, запустите x64 msvsmon.exe, установленный вместе с удаленными средствами ARM64.

Настройка средств удаленного доступа

На удалённом компьютере найдите и запустите Удалённый отладчик из меню «Пуск».

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

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

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

Если API веб-служб Windows не установлен, что бывает только на Windows Server 2008 R2, нажмите кнопку Установить.
Выберите хотя бы один тип сети, в который вы хотите использовать удаленные средства. Если компьютеры подключены через домен, необходимо выбрать первый элемент. Если компьютеры подключены через рабочую или домашнюю группу, выберите второй или третий элемент соответствующим образом.

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

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

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

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

<Remote debugger installation directory>\msvsmon.exe

Удаленная отладка приложений UWP

Удаленная отладка работает так же, как локальная отладка.

На версиях Windows 10 до обновления Creators Update убедитесь, что монитор удалённой отладки (msvsmon.exe) запущен на удалённом устройстве.
На компьютере Visual Studio убедитесь, что рядом с зеленой стрелкой на панели инструментов появится правильный целевой объект отладки (удаленный компьютер или устройство).
Начните отладку, выбрав Отладка>Начать отладку, нажав F5 или выбрав зеленую стрелку на панели инструментов.

Проект перекомпилирует, затем развертывает и запускается на удаленном устройстве. Отладчик приостанавливает выполнение в точках прерывания, и вы можете по шагам входить в код, пропускать его и выходить из него.
При необходимости выберите "Отладочная>остановка отладки" или нажмите клавиши SHIFT+F5 , чтобы остановить отладку и закрыть удаленное приложение.