Exibir, salvar e configurar arquivos de log de compilação
Depois de criar um projeto no Visual Studio Interactive Development Environment (IDE), você pode exibir informações registradas sobre a compilação na janela Visual Studio Output. Os dados de saída podem ser salvos em arquivos de log que você pode exibir no Visual Studio e outros editores.
Os logs podem ajudá-lo a solucionar problemas na compilação. Você pode localizar as linhas de comando exatas usadas para todas as ferramentas de compilação e obter dados de diagnóstico completos sobre todo o processo de compilação. Visual Studio fornece opções para especificar os tipos de informações que você deseja ver na saída de compilação e arquivos de log de compilação.
Este artigo descreve como gerar, configurar e exibir arquivos de log de compilação no Visual Studio.
Gerar e visualizar arquivos de log de compilação
Use os procedimentos a seguir para gerar e exibir arquivos de log de compilação para seu cenário.
projeto C++:
Visual Studio salva os arquivos de log para você quando você cria seu projeto. Os locais comuns para os arquivos de log incluem Release\<ProjectName>.log, Debug\<ProjectName>.loge <ProjectName>.txt. Todos os locais de arquivo são relativos à pasta raiz do projeto e baseados em sua configuração específica.
Use do Windows Explorer ou do Explorador de Arquivos para navegar até o arquivo de log.
Abra o arquivo de log em seu editor preferido.
Projeto .NET:
Para projetos .NET, instrua o Visual Studio a salvar os arquivos de log:
No Visual Studio, seleccione Construir>Construir Solução.
Na janela Output, selecione no texto e use o Ctrl+S atalho de teclado.
O Visual Studio solicita um local para salvar a saída da compilação. Em seguida, você pode abrir os arquivos de log desse local no Visual Studio ou em outro editor.
MSBuild:
Você pode gerar logs de compilação executando o MSBuild diretamente da linha de comando usando a opção de linha de comando
-fileLogger(-fl). Para obter mais informações, veja Obter logs de compilação com o MSBuild.Com o MSBuild, você também pode gerar logs binários (
-binaryLoggerou-blopção de linha de comando). Você pode exibir logs binários no Structured Log Viewer. O visualizador de log estruturado fornece uma interface do usuário mais rica que pode facilitar a compreensão de processos de compilação complexos.
Você pode definir variáveis de ambiente para configurar o Visual Studio para gravar um log binário no sistema de arquivos. Defina MSBuildDebugEngine para 1 e defina MSBUILDDEBUGPATH para o local desejado do arquivo de log de compilação. As variáveis devem ser definidas no ambiente no qual o Visual Studio é iniciado. Essas configurações afetam todas as compilações do Visual Studio, portanto, podem não ser uma boa opção se você quiser apenas logs para uma invocação específica da compilação.
Para obter suporte mais avançado à interface do usuário para criar logs em projetos .NET, considere instalar a extensão Project System Tools. Com a extensão instalada, pode-se ativar e desativar o registo binário na interface do utilizador e escolher na lista de registos. No entanto, devido à forma como se integra com o sistema de compilação do Visual Studio, os logs são um pouco diferentes daqueles que se obteriam da janela de saída ou com as variáveis de ambiente.
Especificar a verbosidade de dados para registos de construção
Você pode especificar quantas informações incluir nos arquivos de log de compilação. A quantidade de dados nas colunas do arquivo de log é medida como verbosidade do registrador. O número de linhas do arquivo de log representa mensagens coletadas. A verbosidade do log (valores de coluna) afeta os tipos de mensagens registradas (valores de linha). A verbosidade discreta resulta em logs mínimos na saída da compilação. de diagnóstico é a configuração mais detalhada e gera arquivos de log com todos os dados possíveis.
A tabela a seguir mostra quais tipos de mensagens são coletadas com base na verbosidade do registrador:
| Tipo de mensagem / Verbosidade | Silencioso | Mínimo | Normal | Detalhado | Diagnóstico |
|---|---|---|---|---|---|
| Erros | ✅ | ✅ | ✅ | ✅ | ✅ |
| Advertências | ✅ | ✅ | ✅ | ✅ | ✅ |
| Mensagens de alta importância | ✅ | ✅ | ✅ | ✅ | |
| Mensagens de importância normal | ✅ | ✅ | ✅ | ||
| Mensagens de baixa importância | ✅ | ✅ | |||
| Outras informações do mecanismo MSBuild | ✅ |
Você pode configurar a verbosidade do logger com as seguintes etapas:
No Visual Studio, selecione Ferramentas>Opções para abrir a caixa de diálogo Opções .
Na caixa de diálogo, expanda a secção Projetos e Soluções e selecione o separador Compilar e Executar.
Use a lista suspensa de verbosidade da saída de compilação do projeto MSBuild e selecione a sua preferência de saída de compilação.
Use a lista suspensa de verbosidade do arquivo de log de compilação do projeto MSBuild e selecione sua preferência de verbosidade do logger.
Dica
Se você quiser ver as linhas de comando usadas para o compilador e outras ferramentas, escolha pelo menos o nível detalhado de verbosidade.
Para aplicar as alterações, selecione OK.
Importante
Você deve reconstruir o projeto para que as alterações entrem em vigor na janela de saída . Para projetos C++, a reconstrução do projeto também garante que as alterações sejam refletidas no arquivo
Para obter mais informações, consulte caixa de diálogo Opções, Projetos e soluções, Criar e executar e LoggerVerbosity.
Usar logs binários para arquivos de log grandes
Os logs binários são um recurso opcional para projetos .NET que permite que você tenha uma experiência de navegação de log mais rica que pode facilitar a localização de informações em logs grandes. Para usar logs binários, instale o Project System Tools. Para obter mais informações, consulte https://msbuildlog.com e Binary Log.
Os logs binários são um recurso opcional para projetos .NET que permite que você tenha uma experiência de navegação de log mais rica que pode facilitar a localização de informações em logs grandes. Para usar logs binários, instale o Project System Tools 2022. Para obter mais informações, consulte https://msbuildlog.com e Binary Log.