Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Usando opções de linha de comando com MSBuild, você pode especificar quantos dados de compilação você deseja revisar e se você deseja salvar dados de compilação em um ou mais arquivos. Você também pode especificar um registrador personalizado para coletar dados de compilação. Para obter informações sobre as opções de linha de comando do MSBuild que este tópico não aborda, consulte Referência de linha de comando.
Observação
Se você criar projetos usando o IDE do Visual Studio, poderá solucionar problemas dessas compilações revisando os logs de compilação. Para obter mais informações, consulte Como exibir, salvar e configurar arquivos de log de compilação.
Definir o nível de detalhe
Quando você cria um projeto usando o MSBuild sem especificar um nível de detalhes, as seguintes informações aparecem no log de saída:
Erros, avisos e mensagens que são categorizados como altamente importantes.
Alguns eventos de status.
Um resumo da compilação.
Ao usar o interruptor -verbosity (-v), pode controlar a quantidade de dados que aparecem no log de saída. Para solucionar problemas, use um nível de detalhamento de detailed (d) ou diagnostic (diag), que fornece mais informações.
O processo de compilação pode ser mais lento quando você define o -verbosity para detailed e ainda mais lento quando você define o -verbosity para diagnostic.
msbuild MyProject.proj -t:go -v:diag
Configurações de verbosidade
A tabela a seguir mostra como a verbosidade do log (valores de coluna) afeta quais tipos de mensagem (valores de linha) são registrados.
| 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 | ✅ | ✅ | |||
| Informações adicionais sobre o mecanismo MSBuild | ✅ |
Salvar o log de compilação em um arquivo
Você pode usar o interruptor -fileLogger (-fl) para salvar dados de compilação em um arquivo. O exemplo a seguir salva dados de compilação em um arquivo chamado msbuild.log.
msbuild MyProject.proj -t:go -fileLogger
No exemplo a seguir, o ficheiro de log é chamado MyProjectOutput.log e o detalhamento da saída de log é definido como diagnostic. Você especifica essas duas configurações usando o -fileLoggerParameters alternador (-flp).
msbuild MyProject.proj -t:go -fl -flp:logfile=MyProjectOutput.log;verbosity=diagnostic
Para obter mais informações, consulte Referência de linha de comando.
Salve a saída de log em vários arquivos
O exemplo a seguir salva todo o log para msbuild1.log, apenas os erros para JustErrors.log e apenas os avisos para JustWarnings.log. O exemplo usa números de arquivo para cada um dos três arquivos. Os números de arquivo são especificados logo após os comutadores -fl e -flp (por exemplo, -fl1 e -flp1).
As -fileLoggerParameters opções (-flp) para os arquivos 2 e 3 especificam o nome de cada arquivo e o que incluir em cada arquivo. Nenhum nome é especificado para o arquivo 1, portanto, o nome padrão de msbuild1.log é usado.
msbuild MyProject.proj -t:go -fl1 -fl2 -fl3 -flp2:logfile=JustErrors.log;errorsonly -flp3:logfile=JustWarnings.log;warningsonly
Se você estiver usando um shell que interpreta ponto-e-vírgula (por exemplo, bash), coloque aspas simples ou duplas em torno de qualquer opção que tenha ponto-e-vírgula para evitar que ele seja interpretado como um separador de comando. Para obter mais informações, consulte Referência de linha de comando.
Salvar um log binário
Você pode salvar o log no formato binário compactado utilizando a opção -binaryLogger (-bl). Esse log inclui uma descrição detalhada do processo de compilação e pode ser lido por determinadas ferramentas de análise de log.
No exemplo a seguir, um arquivo de log binário é criado com o nome binarylogfilename.
-bl:binarylogfilename.binlog
Você pode usar o visualizador de log estruturado para exibir logs binários de uma forma que torna muito mais fácil ver o que está acontecendo.
Para obter mais informações, consulte Referência de linha de comando.
Usar um registrador personalizado
Você pode escrever seu próprio logger criando um tipo gerenciado que implementa a ILogger interface. Você pode usar um registrador personalizado, por exemplo, para enviar erros de compilação por e-mail, registrá-los em um banco de dados ou registrá-los em um arquivo XML. Para obter mais informações, consulte Criar loggers.
Na linha de comando do MSBuild, uma pessoa especifica o registador personalizado usando a opção -logger. Você também pode usar o -noconsolelogger interruptor para desativar o registrador de console padrão.