Depurar aplicativos UWP em computadores remotos do Visual Studio

Você pode usar o Visual Studio para executar, depurar, criar perfil e testar um aplicativo da Plataforma Universal do Windows (UWP) em outro computador ou dispositivo. A execução do aplicativo UWP em um computador remoto é especialmente útil quando o computador do Visual Studio não dá 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 do Visual Studio devem ser conectados por uma rede ou conectados diretamente por meio de um cabo USB ou Ethernet. Não há suporte para depuração pela Internet.
• Você deve ativar o modo de desenvolvedor no computador do Visual Studio e no computador remoto.
• Os computadores remotos devem estar executando 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 nem dão suporte às ferramentas remotas.

Configuração de um projeto do Visual Studio para depuração remota

Você usa 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 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. Em Dispositivo de destino, selecione Máquina Remota 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 Do computador remoto ou selecione Localizar para pesquisar o dispositivo na caixa de diálogo Conexões Remotas.

   

Configurar um projeto de 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 aba 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 um computador remoto, insira ou selecione o nome da rede ou o endereço IP no campo Nome do Computador ou solte e 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 , você pode pesquisar um nome de computador remoto específico ou endereço IP ou detectar conexões automaticamente selecionando o ícone de atualização de seta arredondada. A caixa de diálogo pesquisa apenas dispositivos que estão executando no momento o depurador remoto na sub-rede local. 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 as Ferramentas Remotas para Visual Studio.

• Os dispositivos Windows Mobile 10 não exigem nem dão suporte às ferramentas remotas.
• As ferramentas remotas são instaladas automaticamente quando você implanta o aplicativo em computadores com Windows 11, computadores com Windows 10 executando a Atualização dos Criadores (versão 1703 e posterior), dispositivos Xbox, IoT e HoloLens.
• Em computadores com Windows 10 anterior ao Creator Update, você deve baixar, 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 ou servidor remoto no qual você deseja depurar, em vez do computador do Visual Studio, baixe e instale a versão correta das ferramentas remotas dos links na tabela a seguir.

• Baixe as ferramentas remotas com a mesma arquitetura do computador em que você as está instalando. 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) só está disponível quando você instala as ferramentas remotas. Talvez seja necessário usar o assistente de configuração se desejar executar o depurador remoto como um serviço. Para obter mais informações, confira (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 de administrador 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 se conectar a um processo em execução como administrador ou em execução em uma conta de usuário diferente (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 que você iniciar o depurador remoto (ou antes de configurá-lo), o assistente de Configuração de Depuração Remota é exibido.

   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 em que 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 homegroup, 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 do Windows 10 anteriores à Atualização para Criadores, 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, implanta e inicia no dispositivo remoto. O depurador suspende a execução em pontos de interrupção e você pode entrar, ultrapassar e sair 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 avançadas de implantação remota
• Testando aplicativos UWP com o Visual Studio
• Depurar aplicativos UWP no Visual Studio