Depurar aplicativos UWP em computadores remotos do Visual Studio

É possível usar o Visual Studio para executar, depurar, analisar e testar um aplicativo de Plataforma Universal do Windows (UWP) em outro computador ou dispositivo. A execução do aplicativo UWP em um computador remoto é útil principalmente quando o computador do Visual Studio não oferece suporte a funcionalidades específicas da UWP, como toque, localização geográfica ou orientação física.

Pré-requisitos

Para depurar um aplicativo UWP em um dispositivo remoto do Visual Studio:

• O projeto do Visual Studio deve ser configurado para depuração remota.
• O computador remoto e o computador com o Visual Studio devem estar conectados por uma rede ou diretamente por um cabo Ethernet ou USB. Não há suporte à depuração pela Internet.
• Você deve ativar o modo de desenvolvedor no computador do Visual Studio e no computador remoto.
• Os computadores remotos devem executar as Ferramentas Remotas para Visual Studio.
  • Algumas versões do Windows 10 e posteriores iniciam e executam as ferramentas remotas automaticamente. Caso contrário, instale e execute as Ferramentas Remotas para Visual Studio.
  • Os dispositivos Windows Mobile 10 não exigem ou são compatíveis com ferramentas remotas.

Configurar o projeto do Visual Studio para depuração remota

Você usa o projeto Propriedades para especificar o dispositivo remoto a ser conectado. As configurações variam dependendo da linguagem de programação.

Cuidado

Por padrão, a página de propriedades define Universal (Protocolo Não Criptografado) como o Tipo de Autenticação para Windows 10 e conexões remotas posteriores. Talvez seja necessário definir Nenhuma Autenticação para se conectar ao depurador remoto. Os protocolos Universal (Protocolo Não Criptografado) e Sem Autenticação não têm segurança de rede, portanto, os dados passados entre o desenvolvimento e os computadores remotos são vulneráveis. Escolha esses tipos de autenticação somente em redes confiáveis em que você tenha a certeza de que não há risco de tráfego hostil ou malicioso.

Se você escolher Autenticação do Windows para o Tipo de Autenticação, precisará entrar no computador remoto durante a depuração. O depurador remoto também deve estar em execução no modo de Autenticação do Windows, com a mesma conta de usuário que no computador do Visual Studio.

Configurar um projeto C# ou Visual Basic para depuração remota

1. Selecione o projeto C# ou Visual Basic no Gerenciador de Soluções do Visual Studio e selecione o ícone Propriedades, pressione Alt+Enter ou clique com o botão direito do mouse e escolha Propriedades.

2. Selecione a guia Depurar.

3. No Dispositivo de destino, selecione Computador Remoto para um computador remoto ou Dispositivo para um dispositivo Windows Mobile 10 conectado diretamente.

4. Para um computador remoto, insira o nome da rede ou o endereço IP no campo Computador remoto ou selecione Localizar para pesquisar o dispositivo na caixa de diálogo Conexões Remotas.

   

Configurar um projeto C++ para depuração remota

1. Selecione o projeto C++ no Gerenciador de Soluções do Visual Studio e selecione o ícone Propriedades, pressione Alt+Enter ou clique com o botão direito do mouse e escolha Propriedades.

2. Selecione o nó de depuração.

3. No Depurador para abrir, selecione Computador Remoto para um computador remoto ou Dispositivo para um dispositivo Windows Mobile 10 conectado diretamente.

4. Para um computador remoto, insira ou selecione o nome da rede ou o endereço IP no campo Nome do computador ou, da lista suspensa, selecione Localizar para pesquisar o dispositivo na caixa de diálogo Conexões Remotas.

   

Usar a caixa de diálogo Conexões Remotas

Na caixa de diálogo Conexões Remotas, pesquise um nome de computador remoto ou endereço IP específico ou detecte conexões automaticamente selecionando o ícone de atualização de seta arredondada. A caixa de diálogo pesquisa apenas dispositivos na sub-rede local que estão executando o depurador remoto no momento. Nem todos os dispositivos podem ser detectados na caixa de diálogo Conexões Remotas.

Dica

Se você não conseguir se conectar a um dispositivo remoto pelo nome, tente usar seu endereço IP. Para determinar o endereço IP, no dispositivo remoto, insira ipconfig em uma janela de comando. O endereço IP aparece como Endereço IPv4.

Baixar e instalar as Ferramentas Remotas para Visual Studio

Para que o Visual Studio depure aplicativos em um computador remoto, o computador remoto deve estar executando o Ferramentas Remotas para Visual Studio.

• Os dispositivos Windows Mobile 10 não exigem ou são compatíveis com ferramentas remotas.
• Computadores Windows 11 e Windows 10 que executam a Atualização do Criador (versão 1703) e posterior, dispositivos Windows 10 Xbox, IoT e HoloLens instalam as ferramentas remotas automaticamente quando implanta o aplicativo.
• Nos computadores de Atualização do Criador Windows 10, você deve baixar, instalar e executar manualmente as ferramentas remotas no computador remoto antes de iniciar a depuração.

Baixar e instalar ferramentas remotas:

No dispositivo ou servidor remoto no qual você deseja depurar e não no computador do Visual Studio, baixe e instale a versão correta das ferramentas remotas usando os links na tabela a seguir.

• Baixe a atualização mais recente das ferramentas remotas para a sua versão do Visual Studio. As versões de ferramentas remotas anteriores não são compatíveis com versões posteriores do Visual Studio. (Por exemplo, se você estiver usando o Visual Studio 2019, baixe a atualização mais recente das ferramentas remotas para Visual Studio 2019. Nesse cenário, não baixe as ferramentas remotas para o Visual Studio 2022.)
• Baixe as ferramentas remotas com a mesma arquitetura que a o computador em que você as está instalando. Por exemplo, se você deseja depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas de x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas de ARM64.

Versão	Link	Observações
Visual Studio 2022	Ferramentas remotas	Compatível com todas as versões do Visual Studio 2022. Faça download da versão correspondente ao sistema operacional do seu dispositivo (x86, x64 [AMD64] ou ARM64). Nas versões mais antigas do Windows Server, consulte Desbloquear o download do arquivo para obter ajuda no download das ferramentas remotas.
Visual Studio 2019	Ferramentas remotas	As ferramentas remotas para Visual Studio 2019 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Faça download da versão correspondente ao sistema operacional do seu dispositivo (x86, x64 [AMD64] ou ARM64). Nas versões mais antigas do Windows Server, consulte Desbloquear o download do arquivo para obter ajuda no download das ferramentas remotas.
Visual Studio 2017	Ferramentas remotas	As ferramentas remotas para Visual Studio 2017 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Faça download da versão correspondente ao sistema operacional do seu dispositivo (x86, x64 [AMD64] ou ARM64). No Windows Server, consulte Desbloquear o download do arquivo para obter ajuda no download das ferramentas remotas.
Visual Studio 2015	Ferramentas remotas	As ferramentas remotas para o Visual Studio 2015 estão disponíveis no My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. No Windows Server, consulte Desbloquear o download do arquivo para obter ajuda no download das ferramentas remotas.
Visual Studio 2013	Ferramentas remotas	Página de download na documentação do Visual Studio 2013
Visual Studio 2012	Ferramentas remotas	Página de download na documentação do Visual Studio 2012

Você pode executar o depurador remoto copiando o msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas. No entanto, o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe) só estará disponível quando você instalar as ferramentas remotas. Talvez seja necessário usar o assistente de configuração se você quiser executar o depurador remoto como um serviço. Para obter mais informações, veja (Opcional) Configurar o depurador remoto como um serviço.

Observação

• Para depurar aplicativos Windows 10 ou posteriores em dispositivos ARM, use o ARM64, que está disponível com a versão mais recente das ferramentas remotas.
• Para depurar aplicativos Windows 10 em dispositivos Windows RT, use o ARM, que está disponível apenas no download de ferramentas remotas do Visual Studio 2015.
• Para depurar aplicativos x64 em um sistema operacional ARM64, execute o msvsmon.exe x64 instalado com as ferramentas remotas de ARM64.

Configurar as ferramentas remotas

1. No computador remoto, localize e inicie o Depurador Remoto no menu Iniciar.

   Se você não tiver permissões administrativas no computador remoto, clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Caso contrário, basta iniciá-lo normalmente.

   Se você estiver planejando anexar a um processo que está em execução como administrador ou estiver em execução em outra conta de usuário (como o IIS), clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Para obter mais informações, confira Executar o depurador remoto como administrador.

2. Na primeira vez em que você iniciar o depurador remoto (ou antes de configurá-lo), o assistente Configuração de Depuração Remota aparecerá.

   Na maioria dos cenários, escolha Avançar até chegar à página do assistente Configurar o Firewall do Windows.

   

3. Selecione pelo menos um tipo de rede no qual você deseja usar as ferramentas remotas. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupo doméstico, escolha o segundo ou terceiro item conforme apropriado.

   Depois, selecione Concluir para iniciar o depurador remoto.

4. Quando a configuração for concluída, a janela Depurador Remoto será exibida.

   

   Agora o depurador remoto está aguardando uma conexão. Use o nome do servidor e o número da porta mostrados para definir a configuração de conexão remota no Visual Studio.

Para interromper o depurador remoto, selecioneArquivo>Sair. Você pode reiniciá-lo no menu Iniciar ou na linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Depurar aplicativos UWP remotamente

A depuração remota funciona da mesma forma que a depuração local.

1. Nas versões de Atualização pré-Criador do Windows 10, verifique se o Monitor de Depuração Remota (msvsmon.exe) está em execução no dispositivo remoto.

2. No computador do Visual Studio, verifique se o destino de depuração correto (Computador Remoto ou Dispositivo) aparece ao lado da seta verde na barra de ferramentas.

3. Inicie a depuração selecionando Depurar>Iniciar depuração, pressionando F5 ou selecionando a seta verde na barra de ferramentas.

   O projeto recompila e, em seguida, implanta e inicia no dispositivo remoto. O depurador suspende a execução em pontos de interrupção, e você pode fazer step-into, step-over e step-out do código.

4. Se necessário, selecione Depurar>Parar Depuração ou pressione Shift+F5 para interromper a depuração e fechar o aplicativo remoto.

Conteúdo relacionado

• Opções de implementação remota avançadas
• Testando aplicativos UWP com o Visual Studio
• Depurar aplicativos UWP no Visual Studio