Visão geral dos logs no MSBuild

Artigo
08/04/2011

MSBuildregistradores fornecem uma maneira para personalizar a emissão de relatórios de eventos de compilação, mensagens, avisos e erros. Registradores de 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 é facilmente 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ê executar o MSBuild. exe a partir da linha de comando, MSBuild usa o agente de log de console padrão para exibir informações de evento de compilação na janela do console. Você pode personalizar o nível de detalhe que você deseja que o agente de log para o relatório usando o /verbosity Alternar na linha de comando.

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

Se você estiver usando um agente de log personalizado, você poderá ocultar as informações exibidas de agente de log padrão do console. Use o /noconsolelogger Alternar na linha de comando para desativar o agente de log de console padrão.

Agente de log de arquivo do MSBuild

MSBuildtambém inclui um agente de log de arquivo que logs criam informações de evento para um arquivo. Para executar o agente de log de arquivo, use a seguinte opção na linha de comando, onde MyLog.log é o arquivo para armazenar informações de log.

total de /l:fileLogger,Microsoft.Build;LogFile=MyLog.logIn, o agente de log de arquivo também aceita quatro parâmetros. Estes são:

Logfile: Um parâmetro obrigatório especifica o arquivo armazenar as informações de log.
Append: Um recurso opcional boolean parâmetro indica se ou não acrescentar o log para o arquivo especificado: truePara adicionar o log para o texto já está presente no arquivo. falsepara substituir o conteúdo do arquivo. O padrão é false.
Verbosity: Um parâmetro opcional que substitui a configuração de verbosidade de global para este agente de log do arquivo somente. Isso lhe permite efetuar registradores de várias, cada um com um detalhamento diferente.
Encoding: Um parâmetro opcional que especifica a codificação do arquivo, por exemplo, UTF-8.

Parâmetros múltiplos são separados por ponto e vírgula (;). Por exemplo, a seguinte linha de comando registra as informações de evento de compilação para o arquivo MyLog.loge anexa o log para o texto no arquivo, com diagnostic verbosidade 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 você quiser usar um agente de log diferente, por exemplo, o agente de log de console padrão durante uma compilação, especifique o agente de log personalizado usando o /logger Alternar 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 na MSBuild a linha de comando usando o /logger switch.

Você pode escrever seu próprios logger criando um tipo gerenciado que implementa o ILogger interface. Para obter mais informações, consulte Criar Loggers.