Depurar com o Visual Studio

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Os servidores de símbolos permitem que os depuradores recuperem automaticamente os arquivos de símbolo corretos sem saber nomes de produtos, números de build ou nomes de pacote. Esses arquivos contêm informações úteis para o depurador e geralmente têm a extensão PDB . Você pode usar o Visual Studio para consumir seus símbolos do servidor de símbolos do Azure Artifacts ou de outras fontes externas para entrar no código e depurar seu aplicativo.

Adicionar servidor de símbolos do Azure Artifacts

Para depurar com símbolos do servidor de símbolos do Azure Artifacts, devemos autenticar no servidor e adicionar um novo servidor de símbolos Azure DevOps Services ao nosso ambiente do Visual Studio.

  1. No Visual Studio, selecione Ferramentas>Opções>de Depuração.

  2. Selecione Símbolos na lista e selecione o + sinal para adicionar um novo local do servidor de símbolos do Azure DevOps.

    Adicionar um novo local do servidor de símbolos do Azure DevOps

  3. Uma nova caixa de diálogo Conectar-se ao Servidor de Símbolos do Azure DevOps será aberta, selecione sua conta no menu suspenso e selecione a organização à qual você deseja se conectar. Selecione Conectar quando terminar de se conectar ao servidor de símbolos.

    Conectar-se ao Servidor de Símbolos do Azure DevOps

  4. Em seguida, o servidor de símbolos é adicionado à lista de locais de arquivo de símbolo.

    Novo servidor de símbolos adicionado à lista de locais de arquivo de símbolo

Depurar módulos otimizados

Se você estiver planejando depurar um módulo otimizado (exemplo de binários de versão) ou um código-fonte de terceiros, recomendamos que você desmarque a caixa de seleção nas opções do Enable Just My Code Visual Studio.

Para fazer isso, selecione Opções de Ferramentas> e, em seguida, Depuração. Selecione Geral na lista e, em seguida, desmarque Habilitar Apenas Meu Código.

Habilitar apenas meu código – habilitar a depuração de código-fonte de terceiros

Observação

Para habilitar o suporte para arquivos PDB portáteis, marcar caixa de seleção Habilitar suporte Source Link e habilitar o suporte para arquivos PDB do Windows em servidores de símbolos, marcar caixa de seleção Habilitar Suporte do Servidor de Origem, ambos localizados em Ferramentas>Opções>Depuração>Geral.

Iniciar a depuração

Você pode começar a depurar seu aplicativo de algumas maneiras diferentes:

  • Pressione F5 para iniciar o aplicativo com o depurador anexado ao processo do aplicativo.
  • Selecione Depurar>Iniciar Depuração.
  • Selecione o botão Iniciar Depuração na barra de ferramentas de depuração.

Quando você iniciar o depurador, o Visual Studio tentará carregar seus símbolos da pasta de cache primeiro antes de baixá-los do servidor de símbolos artifacts que adicionamos na seção anterior.

Depois que o Visual Studio encontrar e carregar seus símbolos, você poderá percorrer seu código e depurar seu aplicativo. Confira Navegar pelo código com o depurador do Visual Studio para obter mais detalhes.