Depuração remota de um projeto C# ou Visual Basic no Visual Studio

Para depurar uma aplicação Visual Studio que foi implementada num computador diferente, instale e execute as ferramentas remotas no computador onde implementou a sua aplicação, configure o seu project para se ligar ao computador remoto a partir do Visual Studio e depois execute a sua aplicação.

Captura de ecrã dos componentes do depurador remoto.Componentes_do_depurador_remoto

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 versões mais recentes e em versões do Windows Server a partir do Windows Server 2008 Service Pack 2. Para obter uma lista completa de requisitos, consulte Requisitos.

Baixe e instale as ferramentas remotas

No dispositivo remoto ou servidor onde pretende depurar, em vez da máquina do Visual Studio, descarregue e instale a versão correta das ferramentas remotas a partir dos links na tabela seguinte.

• Transfira as ferramentas remotas com a mesma arquitetura da máquina em que está a instalá-las. 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 para 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.

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 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 anexar a um processo que está a ser executado como administrador ou sob uma conta de utilizador diferente (como o IIS), clique com o botão direito no aplicativo Depurador Remoto e selecione Executar como administrador. Para obter mais informações, consulte 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 será exibido.

   Na maioria dos cenários, selecione Configurar depuração remota.

   Captura de ecrã da configuração do Depurador Remoto.Configuração do Depurador Remoto

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

   Captura de ecrã da configuração do Depurador Remoto.Configuração do Depurador Remoto

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.

   Captura de ecrã da janela do depurador remotojanela do depurador remoto

   Captura de ecrã da janela do depurador remotojanela do depurador remoto

   O depurador remoto está agora à espera de uma ligação. Use o nome do servidor e o número de porta mostrados para definir a configuração da ligação remota no Visual Studio.

Para interromper o depurador remoto, selecione ArquivoSair. Você pode reiniciá-lo a partir do menu Iniciar ou da linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Depure remotamente o projeto

O depurador não pode implementar aplicações de ambiente de trabalho Visual C# ou Visual Basic para uma máquina remota, mas ainda assim pode depurá-las remotamente da seguinte forma. O procedimento a seguir pressupõe que pretendes depurá-lo num computador chamado MJO-DL, conforme mostrado na ilustração abaixo.

1. Crie um WPF project chamado MyWpf.

   Se estiver a tentar depurar remotamente uma aplicação MAUI em vez de WPF, veja Depurar remotamente uma aplicação .NET MAUI no Windows.

2. Defina um ponto de interrupção em algum lugar no código que seja facilmente alcançado.

   Por exemplo, você pode definir um ponto de interrupção em um manipulador de botões. Para fazer isso, abra o MainWindow.xaml, adicione um controlo Button a partir da Toolbox, depois faça duplo clique no botão para abrir o seu manipulador.

3. No Solution Explorer, clique com o botão direito no project e escolha Properties.

4. Na página Propriedades , selecione o separador Depurar .

   Para projetos C# direcionados a .NET Core ou .NET 5+, a partir do Visual Studio 2022, escolha a interface de perfis de lançamento de Debug Debug launch profiles UI no separador Debug para configurar as definições de debug remota.

   

   Caso contrário, para .NET Framework, mudas as definições de depuração remota diretamente no separador Debug.

   

   Para projetos C# direcionados a .NET Core ou .NET 5+, a partir do Visual Studio 2022, escolha os perfis de lançamento Debug UI no separador Debug para configurar as definições para depuração remota.

   

   Caso contrário, para .NET Framework, mudas as definições de depuração remota diretamente no separador Debug.

   

5. Verifique se a caixa de texto Diretório de trabalho está vazia.

6. Escolha Usar máquina remotae digite na caixa de texto seunomedamáquina:porta. O número da porta é mostrado na janela do depurador remoto.

   Neste exemplo, use:

   MJO-DL:4026 em Visual Studio 2022 ou posterior

7. Certifique-se de que a opção Ativar depuração de código nativo não está selecionada.

8. Constrói o projecto.

9. Cria uma pasta no computador remoto que siga o mesmo caminho da pasta Debug no teu computador Visual Studio: <source path>\MyWPF\MyWPF\bin\Debug.

10. Copie o executável que acabou de construir do seu computador Visual Studio para a pasta recém-criada no computador remoto.

    Atenção

    Não faça alterações no código ou reconstrua (ou você deve repetir esta etapa). O executável copiado para a máquina remota deve corresponder exatamente à origem e aos símbolos locais.

    Podes copiar o project manualmente, usar XCopy, Robocopy, PowerShell ou outras opções.

11. Verifique se o depurador remoto está em execução na máquina de destino (se não estiver, procure por Depurador Remoto no menu Iniciar). A janela do depurador remoto tem esta aparência.

    

    Captura de ecrã da janela do depurador remoto para VS 2022.janela do depurador remoto

12. Em Visual Studio, inicie a depuração (Depurar > Iniciar Depuração, ou F5).

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

    As credenciais necessárias variam dependendo da configuração de segurança da rede. Por exemplo, num computador de domínio, pode 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 MJO-DL\, juntamente com a senha correta.

    Deves ver que a janela principal da aplicação WPF está aberta no computador remoto.

14. Se necessário, tome medidas para atingir o ponto de interrupção. Você verá que o ponto de interrupção está ativo. Se não estiver, os símbolos do aplicativo não foram carregados. Tenta novamente e, se isso não funcionar, obtém informações sobre como carregar símbolos e como os diagnosticar em Compreender ficheiros de símbolos e as definições de símbolos do Visual Studio.

15. Na máquina Visual Studio, deves ver que a execução parou no ponto de interrupção.

    Se tiver ficheiros que não sejam código que precisam de ser usados pela aplicação, deve incluí-los no Visual Studio project. Crie uma pasta project para os ficheiros adicionais (no Solution Explorer, clique em Adicionar > Nova Pasta). Depois adiciona os ficheiros à pasta (no Solution Explorer, clica em Adicionar > Item Existente, e depois seleciona os ficheiros). Na página Propriedades de cada ficheiro, selecione Copiar para Diretório de Saída como Copiar sempre.

Depurar remotamente uma aplicação .NET MAUI no Windows

.NET As aplicações MAUI são aplicações empacotadas que precisam de ser registadas quando implementadas, não apenas copiadas para uma máquina remota. Para depuração remota, você pode implantar uma versão não empacotada do aplicativo.

Use um dos seguintes métodos para depuração remota:

• Publique a aplicação no dispositivo remoto como uma aplicação não empacotada usando os passos descritos em Use a CLI para publicar aplicações .NET MAUI não empacotadas para Windows, e depois siga os passos deste artigo para depuração remota. (Ignore as etapas para copiar o aplicativo.)

• Siga os passos deste artigo, incluindo os passos para criar um perfil de Lançamento de Depuração para o projeto. Antes de começar a depurar, edite manualmente o ficheiro launchSettings.json, substituindo o valor commandNameProject por MsixPackage, como mostrado aqui.

  "Remote Profile": {
    "commandName": "MsixPackage",
    "remoteDebugEnabled": true,
    "remoteDebugMachine": "170.200.20.22",
    "authenticationMode": "None"
  }
  

  Ao iniciares a depuração, este método implanta primeiro uma versão não empacotada da aplicação e inicia-a.

  Observação

  Não é possível editar launchSettings.json na janela de diálogo do perfil de arranque de depuração depois de alterar o valor para .

Configurar a depuração com símbolos remotos

Deverias conseguir depurar o teu código com os símbolos que geras no computador do Visual Studio. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais. Se tiveres de usar símbolos remotos, tens de indicar ao monitor de depuração remota que procure símbolos na máquina remota.

Você pode usar a seguinte opção de linha de comando msvsmon para usar símbolos remotos para código gerenciado:

Para obter mais informações, consulte a ajuda de depuração remota (pressione F1 na janela do depurador remoto ou clique em Ajuda Uso).

Conteúdo relacionado

• Depuração em 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