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ê implantará seu aplicativo, configurará seu projeto para se conectar ao computador remoto do Visual Studio e, em seguida, implantará e executará seu aplicativo.

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 do Visual Studio, baixe e instale a versão correta das ferramentas remotas dos links na tabela a seguir.

• Baixe as ferramentas remotas mais recentes para sua versão do Visual Studio. A versão mais recente das ferramentas remotas é compatível com versões anteriores do Visual Studio, mas 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 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: Arquivos de Programas (x86)\Microsoft Visual Studio<versão>\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

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, escolha Avançar até chegar à página do assistente Configurar o Firewall do Windows.

   

   

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

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.

   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 remotamente um projeto do C++

No procedimento a seguir, o caminho do projeto é 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 main.

3. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Propriedades. 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 sem 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 pastas adicionais e quiser todos os arquivos em uma pasta implantada na mesma pasta, especifique um nome de pasta.

   Para obter mais informações sobre propriedades, confira Configurações de projeto para uma configuração de depuração do C++.

6. No Gerenciador de Soluções, clique com o botão direito na solução e escolha Gerenciador de Configurações.

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 que não seja de domínio, você pode inserir o nome do computador e um nome de conta de usuário válido, como MySurface\name@something.com, juntamente com a senha correta.

11. No computador do 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 Gerenciador de Soluções , clique com o botão direito do mouse no nó do projeto e escolha Implantar.

    Se você tiver arquivos sem código exigidos pelo aplicativo, poderá especificá-los em uma lista delimitada por ponto-e-vírgula em Arquivos Adicionais a Implantar na página de propriedades do Depurador com Depurador Remoto do Windows selecionado.

    Como alternativa, você pode incluir os arquivos em seu projeto e definir a propriedade Conteúdo como Sim na página Propriedades de cada arquivo. Esses arquivos são copiados para o Diretório de Implantação especificado na página de propriedades do Depurador com Depurador Remoto do Windows selecionado. Você também pode alterar o Tipo de Item para Copiar Arquivo e especificar propriedades adicionais 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 do Visual Studio. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais.

Se você precisar usar símbolos remotos, será necessário especificar os símbolos remotos no Visual Studio adicionando um compartilhamento de arquivos do Windows ao caminho de pesquisa de símbolos no Tools > Options > Debugging > Symbols.

Conteúdo relacionado

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