Exibir, salvar e configurar arquivos de log de build

  • Artigo

Depois de compilar um projeto no Visual Studio IDE, é possível exibir informações sobre sse build na Janela de Saída. Usando essas informações, você pode solucionar uma falha de build, exibir as linhas de comando exatas usadas em todas as ferramentas de build ou obter informações completas de diagnóstico sobre todo o processo de build.

  • Para projetos C++, você também pode exibir as mesmas informações em um arquivo de log criado e salvo durante a criação de um projeto.

  • Para projetos .NET, clique na janela de saída de build e pressione Ctrl+S. O Visual Studio solicitará um local para salvar as informações da janela de Saída em um arquivo de log.

Também é possível usar o IDE para especificar que tipos de informações você deseja exibir sobre cada build.

Se você compilar qualquer tipo de projeto usando o MSBuild, é possível criar um arquivo de log para salvar informações sobre o build. Para obter mais informações, consulte Obtendo logs de build.

Para exibir o arquivo de log de build para um projeto C++

  1. No Gerenciador de Arquivos ou no Explorador de Arquivos do Windows, abra o seguinte arquivo (em relação à pasta raiz do projeto): Release\{NomeDoProjeto}.Log ou Debug\{NomedoProjeto}.log

Para criar um arquivo de log de build para um projeto de código gerenciado

  1. Na barra de menus, escolha Compilar>Compilar Solução.

  2. Na janela de Saída, clique em algum lugar no texto.

  3. Pressione Ctrl+S.

    O Visual Studio solicitará um local para salvar a saída de build.

Você também pode gerar logs executando o MSBuild diretamente na linha de comando, usando a opção de linha de comando -fileLogger (-fl). Confira Obter logs de build com o MSBuild.

Para alterar a quantidade de informações incluídas no log de build

  1. Na barra de menus, escolha Ferramentas>Opções.

  2. Na página Projetos e Soluções, escolha a página Compilar e Executar.

  3. Na lista Detalhamento da saída de build do projeto no MSBuild, escolha um dos valores e, em seguida, escolha o botão OK.

A tabela a seguir mostra como os detalhes do log (valores de coluna) afetam quais tipos de mensagem (valores de linha) são registrados em log.

Tipo de mensagem/Detalhamento Quiet Minimal Normal Detalhado Diagnostic
Errors ✅ ✅ ✅ ✅ ✅
Warnings ✅ ✅ ✅ ✅ ✅
Mensagens de alta prioridade ✅ ✅ ✅ ✅
Mensagens de prioridade normal ✅ ✅ ✅
Mensagens de baixa prioridade ✅ ✅
Informações adicionais do mecanismo MSBuild ✅

Se você quiser ver as linhas de comando usadas no compilador e em outras ferramentas, escolha pelo menos o nível de detalhamento Detalhado.

Para obter mais informações, confira Caixa de diálogo Opções, Projetos e Soluções, Criar e Executar e LoggerVerbosity.

Importante

É necessário recompilar o projeto para que suas alterações entrem em vigor na Janela de Saída (todos os projetos) e no arquivo <NomeDoProjeto>.txt (apenas projetos C++).

Usar logs binários para facilitar a navegação em arquivos de log grandes

Logs binários são um recurso opcional para projetos do .NET que proporcionam 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 as Ferramentas do Sistema para Projetos. Saiba mais em https://msbuildlog.com e Log binário.

Logs binários são um recurso opcional para projetos do .NET que proporcionam 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 as Ferramentas do Sistema para Projetos 2022. Saiba mais em https://msbuildlog.com e Log binário.

Conteúdo relacionado