Compartilhar via


Visão geral do registrar em log no MSBuild

MSBuild registradores fornecem uma maneira para personalizar a emissão de relatórios de eventos de compilação, mensagens, avisos e erros. Registradores de podem exibir informações na janela do console, gravar XML ou um arquivo de texto ou inserir dados de compilação em um banco de dados.

MSBuild loggers

Um agente de log é usado para retransmitir as informações de eventos de compilação, mensagens, avisos e erros para um log que com com facilidade lida e interpretada.A lógica de um agente de log é gravada em um tipo gerenciado que implementa o ILogger interface.

Agente de log de console padrão do MSBuild

Quando você executa o MSBuild.exe a partir da linha de comando, MSBuild usa o agente de log de console padrão para exibir evento de compilação informações na janela do console. Você pode personalizar o nível de detalhe que você deseja o agente de log ao relatório usando o /verbosity comutador na linha de comando.

O agente de log de console padrão aceita parâmetros adicionais que podem modificar a saída na janela do console.Esses parâmetros são especificados com o /consoleloggerparameters comutador na linha de comando.

Se você estiver usando um agente de log personalizado, convém ocultar as informações exibidas do agente de log de console padrão.Use o /noconsolelogger Alterne na linha de comando para desabilitar o agente de log de console padrão.

Arquivo MSBuild agente

MSBuild também inclui um agente de log do arquivo de logs criam informações de evento para um arquivo. Para executar o agente de log de arquivo, use a seguinte comutador na linha de comando, onde MyLog.log é o arquivo para armazenar as informações de log.

/l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log

No total, o agente de log de arquivo também aceita quatro parâmetros.Estes são:

  • Logfile: Um parâmetro obrigatório que especifica o arquivo para armazenar as informações de log.

  • Append: Um recurso opcional boolean parâmetro que indica a acrescentar o log ao arquivo especificado ou não: true Para adicionar o log do texto já presente no arquivo; false para substituir o Sumário do arquivo. O padrão é false.

  • Verbosity: Um parâmetro opcional que substitui a configuração global verbosidade para esse agente de log de arquivo só. Isso lhe permite efetuar várias loggers, cada um com um detalhamento diferente.

  • Encoding: Um parâmetro opcional que especifica a codificação do arquivo, por exemplo, UTF-8.

Vários parâmetros são separados por ponto-e-vírgula (;).Por exemplo, a seguinte linha de comando registra as informações do evento de compilação para o arquivo MyLog.loge anexa o log para o texto do arquivo, com diagnostic nível de detalhes e com UTF-8 codificação.

MSBuild MyProj.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log append=true;verbosity=diagnostic;encoding=utf-8

Especificando um agente de log

Se desejar usar um agente de log que não o agente de log de console padrão durante uma compilação, especifique o agente de log personalizado usando o /logger comutador na linha de comando. Para obter informações mais detalhadas em MSBuild Opções de linha de comando, consulte Referência de linha de comando do MSBuild.

Escrevendo um agente de log

A lógica de um agente de log é escrita em código gerenciado e especificada no MSBuild linha de comando usando o /logger Alterne.

Você pode escrever seu próprio agente de log criando um tipo gerenciado que implementa o ILogger interface. Para obter mais informações, consulte Como: Escrever um agente de log.

Consulte também

Tarefas

Como: Escrever um agente de log

Conceitos

registrar registrar registrar em log em um ambiente Multi-processador

Criando Forwarding Loggers

Outros recursos

Conceitos do MSBuild