Depuração remota de um projeto C++ no Visual Studio

Para depurar um aplicativo do Visual Studio em um computador diferente, instale e execute as ferramentas remotas no computador em que você implanta seu aplicativo, configure seu projeto para se conectar ao computador remoto do Visual Studio e, em seguida, execute e implante o seu aplicativo.

Componentes do depurador remotoRemote_debugger_components

Para obter informações sobre a depuração remota dos Aplicativos Universais do Windows (UWP), consulte Depurar um pacote de aplicativo instalado.

Requisitos

O depurador remoto tem suporte no Windows 7 e versões mais recentes do Windows Server a partir do Windows Server 2008 Service Pack 2. Para obter uma lista completa de requisitos, consulte Requirements.

Baixar e instalar as ferramentas remotas

No dispositivo ou servidor remoto no qual você deseja depurar, em vez do computador 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 um aplicativo de 32 bits em um computador remoto executando um sistema operacional de 64 bits, instale as ferramentas remotas de 64 bits.
• Se você estiver depurando remotamente um aplicativo ARM64EC em um dispositivo ARM64, instale as ferramentas remotas arm64 e inicie o depurador remoto x64 que é instalado com essas ferramentas. Isso pode ser encontrado em: Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64.

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 para a 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 o depurador remoto

Depois de instalar o depurador remoto, siga estas etapas.

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

   Captura de tela da configuração do depurador remoto.Configuração do Depurador Remoto

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

   Captura de tela da configuração do depurador remoto.Configuração do Depurador Remoto

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.

   Captura de tela da janela do depurador remotoJanela Depurador Remoto

   Captura de tela da janela do depurador remotoJanela Depurador Remoto

   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 em Visual Studio.

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

<Remote debugger installation directory>\msvsmon.exe

Depurar remotamente um project C++

No procedimento a seguir, o caminho do project é C:\remotetemp e o nome do computador remoto é MySurface.

1. Criar um aplicativo do Console C++ chamado CppConsoleApp

2. Defina um ponto de interrupção em algum lugar no aplicativo que é facilmente atingido, por exemplo, em CppConsoleApp.cpp, na função .

3. Em Solution Explorer, clique com o botão direito do mouse no project e selecione Properties. Abra a guia Depuração.

4. Defina Depurador para iniciar como Depurador Remoto do Windows.

   

5. Faça as seguintes alterações nas propriedades:

   Configuração	Valor
   Comando Remoto	C:\remotetemp\CppConsoleApp.exe
   Diretório de trabalho	C:\remotetemp
   Nome do servidor remoto	MySurface:portnumber
   Conexão	Remoto com Autenticação do Windows
   Tipo de Depurador	Somente Nativo
   Diretório de implantação	C:\remotetemp
   Arquivos adicionais a implantar	$(ProjectDir)\data

   Se você implantar outras pastas e quiser todos os arquivos em uma pasta implantada na mesma pasta, especifique um nome de pasta.

   Para obter mais informações sobre as propriedades, consulte Configurações do Projeto para Configuração de Depuração do C++.

6. Em Solution Explorer, clique com o botão direito do mouse na solução e escolha Configuration Manager.

7. Para a configuração de Depuração, selecione a caixa de seleção Implantar.

   

8. Iniciar depuração (Depurar Iniciar depuração, ou F5).

9. O executável é implantado automaticamente no computador remoto.

10. Se solicitado, insira as credenciais de rede para se conectar ao computador remoto.

    As credenciais necessárias são específicas para a configuração de segurança da rede. Por exemplo, em um computador de domínio, você pode escolher um certificado de segurança ou inserir seu nome de domínio e senha. Em um computador nondomain, você pode inserir o nome do computador e um nome de conta de usuário válido, como MySurface\, juntamente com a senha correta.

11. No computador Visual Studio, você deverá ver que a execução foi interrompida no ponto de interrupção.

    Dica

    Como alternativa, você pode implantar os arquivos como uma etapa separada. No Solution Explorer clique com o botão direito do mouse no nó project e escolha Deploy.

    Se você tiver arquivos não codificados exigidos pelo aplicativo, poderá especificá-los em uma lista delimitada por ponto-e-vírgula em Arquivos Adicionais para Implantar na página de propriedades do Depurador com o Depurador remoto do Windows selecionado.

    Como alternativa, você pode incluir os arquivos em seu project e definir a propriedade Content como Yes na página Properties para cada arquivo. Esses arquivos são copiados para o Diretório de Implantação especificado na página de propriedades do Depurador ao selecionar o Depurador Remoto do Windows. Você também pode alterar o Tipo de Item para Copiar Arquivo e especificar outras propriedades lá se precisar que os arquivos sejam copiados para uma subpasta do Diretório de Implantação.

Configurar a depuração com símbolos remotos

Você deve ser capaz de depurar seu código com os símbolos gerados no computador Visual Studio. O desempenho do depurador remoto é melhor quando você usa símbolos locais.

Se você precisar usar símbolos remotos, precisará especificar os símbolos remotos em Visual Studio adicionando um compartilhamento de arquivos do Windows ao caminho de pesquisa de símbolos.

Conteúdo relacionado

• Debugging no Visual Studio
• Introdução ao depurador
• Configurar o Firewall do Windows para Depuração Remota
• Atribuições de porta do depurador remoto
• Debug Remoto do ASP.NET em um IIS remoto
• Erros e solução de problemas de depuração remota