Depurar aplicativos UWP em máquinas remotas do Visual Studio

Você pode usar o Visual Studio para executar, depurar, criar perfis e testar um aplicativo da Plataforma Universal do Windows (UWP) em outro computador ou dispositivo. Executar o aplicativo UWP em uma máquina remota é especialmente útil quando o computador 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.
• A máquina remota e o computador Visual Studio devem ser conectados através de uma rede ou conectados diretamente através de um cabo USB ou Ethernet. A depuração pela Internet não é suportada.
• Você deve ativar o modo de desenvolvedor no computador Visual Studio e na máquina remota.
• Os computadores remotos devem estar executando as Ferramentas Remotas para Visual Studio.
  • Alguns Windows 10 e versões 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 requerem nem suportam as ferramentas remotas.

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

Use as propriedades do projeto para especificar o dispositivo remoto ao qual se conectar. As configurações diferem dependendo da linguagem de programação.

Configurar um projeto de C# ou de 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 Debug.

3. Em Dispositivo de destino, selecione Máquina Remota para um computador remoto ou Dispositivo para um dispositivo Windows Mobile 10 conectado diretamente.

4. Para uma máquina remota, digite o nome da rede ou o endereço IP no campo Máquina remota ou selecione Localizar para procurar 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 a guia Depuração .

3. Em Depurador para iniciar, selecione Máquina Remota para um computador remoto ou Dispositivo para um dispositivo Windows Mobile 10 conectado diretamente.

4. Para uma máquina remota, digite ou selecione o nome da rede ou o endereço IP no campo Nome da máquina ou faça uma lista suspensa e selecione Localizar para procurar 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 , você pode procurar um nome de computador remoto ou endereço IP específico ou detetar automaticamente conexões selecionando o ícone de atualização de seta arredondada. O diálogo pesquisa apenas dispositivos na sub-rede local que estão atualmente a executar o depurador remoto. Nem todos os dispositivos podem ser detetados na caixa de diálogo Conexões remotas .

Baixe e instale as Ferramentas Remotas para Visual Studio

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

• Os dispositivos Windows Mobile 10 não requerem nem suportam as ferramentas remotas.
• Computadores com 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 você implanta o aplicativo.
• Nos PCs com Windows 10 anteriores à Atualização dos Criadores, deve transferir, instalar e executar manualmente as ferramentas remotas no computador remoto antes de iniciar a depuração.

Para baixar e instalar as ferramentas remotas:

No dispositivo remoto ou servidor em que você deseja depurar, em vez da máquina do Visual Studio, baixe e instale a versão correta das ferramentas remotas a partir dos links na tabela a seguir.

• Faça o download das ferramentas remotas que tenham a mesma arquitetura da máquina onde as está a instalar. Por exemplo, se você quiser depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas ARM64.

Você pode executar o depurador remoto copiando 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) está disponível somente quando você instala as ferramentas remotas. Talvez seja necessário usar o assistente de configuração se pretender executar o depurador remoto como um serviço. Para obter mais informações, consulte (Opcional) Configurar o depurador remoto como um serviço.

Configurar as ferramentas remotas

1. No computador remoto, localize e inicie o Depurador Remoto a partir do menu Iniciar.

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

   Se estiver a planear ligar-se a um processo que está a ser executado como administrador, ou está a ser executado numa conta de utilizador diferente (como o IIS), clique com o botão direito do rato na aplicação Depurador Remoto e selecione Executar como administrador. Para obter mais informações, consulte Executar o depurador remoto como administrador.

2. Na primeira vez que se iniciar o depurador remoto (ou antes de o configurar), será exibido o assistente de configuração de depuração remota .

   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 através 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.

   Em seguida, escolha Finalizar para iniciar o depurador remoto.

4. Quando a configuração estiver concluída, a janela Remote Debugger será exibida.

   

   

   O depurador remoto está agora aguardando uma ligaçã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, selecione Arquivo>Sair. Você pode reiniciá-lo a partir do menu Iniciar ou da 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 anteriores à Atualização para Criadores do Windows 10, verifique se o Monitor de Depuração Remota (msvsmon.exe) está em execução no dispositivo remoto.

2. No computador Visual Studio, verifique se o destino de depuração correto (Máquina Remota 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, implanta e inicia no dispositivo remoto. O depurador suspende a execução em pontos de interrupção, e pode-se entrar no, sobrepor e sair do código.

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

Conteúdo relacionado

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