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.

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.

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.

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.

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.

   

   

   Se a API de Serviços Web do Windows não estiver instalada, o que ocorre apenas no Windows Server 2008 R2, selecione o botão Instalar.

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.

   Em seguida, selecione Configurar depuração remota 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