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 onde você implantará seu aplicativo, configure seu projeto para se conectar ao computador remoto a partir do Visual Studio e, em seguida, implante e execute seu aplicativo.

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

Requerimentos

O depurador remoto é suportado no Windows 7 e em versões mais recentes e nas versões do Windows Server, começando com o Windows Server 2008 Service Pack 2. Para obter uma lista completa de requisitos, consulte Requisitos.

Observação

Não há suporte para depuração entre dois computadores conectados por meio de um proxy. A depuração através de uma ligação de alta latência ou baixa largura de banda, como a Internet de acesso telefónico, ou através da Internet entre países/regiões não é recomendada e pode falhar ou ser inaceitavelmente lenta.

Baixe e instale 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.

• 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 anteriores das ferramentas remotas 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 o Visual Studio 2019. Nesse cenário, não baixe as ferramentas remotas para o Visual Studio 2022.)
• Transfira as ferramentas remotas com a mesma arquitetura da máquina em que está a instalá-las. Por exemplo, se você quiser depurar um aplicativo de 32 bits em um computador remoto que executa 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.

Versão	Ligação	Observações
Visual Studio 2022	Ferramentas remotas	Compatível com todas as versões do Visual Studio 2022. Descarregue a versão correspondente para o sistema operativo do seu dispositivo (x86, x64 (AMD64) ou ARM64). Em versões mais antigas do Windows Server, consulte Desbloquear o download do ficheiro para obter ajuda no descarregamento das ferramentas remotas.
Visual Studio 2019	Ferramentas remotas	Ferramentas remotas para Visual Studio 2019 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Descarregue a versão que corresponde ao sistema operativo do seu dispositivo (x86, x64 (AMD64) ou ARM64). Em versões mais antigas do Windows Server, consulte para desbloquear o download de arquivos e obter ajuda com o download das ferramentas remotas.
Visual Studio 2017	Ferramentas remotas	Ferramentas remotas para Visual Studio 2017 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. Faça o download da versão que corresponde ao sistema operativo do seu dispositivo (x86, x64 (AMD64) ou ARM64). No Windows Server, consulte Desbloquear o ficheiro de download para obter ajuda com o download das ferramentas remotas.
Visual Studio 2015	Ferramentas remotas	Ferramentas remotas para Visual Studio 2015 estão disponíveis em My.VisualStudio.com. Se solicitado, ingresse no programa gratuito Visual Studio Dev Essentials ou entre com sua ID de assinatura do Visual Studio. No Windows Server, consulte Desbloquear o download de arquivos para obter ajuda com o download das ferramentas remotas.
Visual Studio 2013	Ferramentas remotas	Página de download na documentação do Visual Studio 2013
Visual Studio 2012	Ferramentas remotas	Página de download na documentação do Visual Studio 2012

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 quiser executar o depurador remoto como um serviço. Para obter mais informações, consulte (opcional) Configurar o depurador remoto como um serviço.

Observação

• Para depurar aplicativos do Windows 10 ou posteriores em dispositivos ARM, use o ARM64, que está disponível com a versão mais recente das ferramentas remotas.
• Para depurar aplicações do Windows 10 em dispositivos Windows RT, utilize ARM, que está disponível apenas no download das ferramentas remotas do Visual Studio 2015.

Dica

Em alguns cenários, pode ser mais eficiente executar o depurador remoto a partir de um compartilhamento de arquivos. Para obter mais informações, consulte executar o depurador remoto a partir de uma partilha de ficheiros.

Configurar o depurador remoto

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 inicia o depurador remoto (ou antes de o configurar), o assistente de Configuração de Depuração Remota aparece.

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

   

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, selecione Concluir 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 parar 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

Observação

Se você precisar adicionar permissões para usuários adicionais, alterar o modo de autenticação ou o número da porta para o depurador remoto, consulte Configurar o depurador remoto.

Depuração remota de um projeto C++

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

1. Crie um aplicativo de console C++ chamado CppConsoleApp

2. Defina um ponto de interrupção em algum lugar do aplicativo que seja facilmente alcançado, 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. Configurar o Depurador para iniciar como Depurador Remoto do Windows .

   

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

   Cenário	Valor
   Comando remoto	C:\remotetemp\CppConsoleApp.exe
   Diretório de Trabalho	C:\remotetemp
   Nome do servidor remoto	MySurface:número de porta
   Ligação	Remoto com Autenticação do Windows
   Tipo de depurador	Apenas nativos
   Diretório de implantação	C:\remotetemp
   Arquivos adicionais a implementar	$(ProjectDir)\dados

   Se você implantar pastas adicionais e quiser que todos os arquivos em uma pasta sejam implantados na mesma pasta, especifique um nome de pasta.

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

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

7. Para a configuração Depurar, selecione a caixa de seleção Deploy.

   

8. Iniciar a depuração (Depurar > Iniciar a depuraçãoou F5).

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

10. Se solicitado, insira as credenciais de rede para se conectar à máquina remota.

    As credenciais necessárias são específicas para a configuração de segurança da rede. Por exemplo, num computador de domínio, pode escolher um certificado de segurança ou introduzir o seu nome de domínio e palavra-passe. Em uma máquina que não seja de domínio, você pode inserir o nome da máquina e um nome de conta de usuário válido, como MySurface\name@something.com, juntamente com a senha correta.

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

    Dica

    Como alternativa, você pode implantar os arquivos como uma etapa separada. No Explorador de Soluções, clique com o botão direito do mouse no nó do projeto e escolha Implementar.

    Se tiver arquivos que não são código exigidos pela aplicação, pode especificá-los numa lista delimitada por ponto-e-vírgula em Arquivos Adicionais a Desdobrar na página de propriedades do Depurador com Depurador Remoto do Windows selecionado.

    Como alternativa, pode incluir os arquivos no seu projeto e definir a propriedade Content para Sim na página de Propriedades para cada arquivo. Esses ficheiros são copiados para o Deployment Directory especificado na página de propriedades do Depurador com o 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 Implementaçã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 é muito melhor quando você usa símbolos locais.

Se precisar utilizar símbolos remotos, deverá especificar os símbolos remotos no Visual Studio, adicionando uma partilha de ficheiros do Windows ao caminho de pesquisa de símbolos em Ferramentas > Opções > Depuração > Símbolos.

Conteúdo relacionado

• Debug ou depuração no Visual Studio
• Primeira olhada no depurador
• Configurar o Firewall do Windows para depuração remota
• Atribuições de porta do depurador remoto
• Depuração Remota de ASP.NET num computador IIS remoto
• Erros de depuração remota e solução de problemas