Gerenciar a verbosidade de informações e controle de compilação
Você pode obter informações detalhadas sobre uma compilação concluída:
Como a compilação foi executada? A compilação foi bem-sucedida.Quando ela começou?Quanto tempo a compilação demorou?Como esta compilação foi executada com relação às compilações mais antigas?
O que foi compilado? Que soluções, conjuntos de alterações e correções de erro foram inseridos nesta compilação?
O que deu errado? Que avisos ou erros ocorreram?Que testes falharam?
Você pode sistematicamente controlar o detalhamento das informações que são armazenadas sobre cada compilação concluída quando você define seu processo de compilação.Como alternativa, você pode controlar este detalhamento para uma única execução de uma compilação quando você a enfileira manualmente.
Neste tópico
Como Informações de Compilação são Geradas e Fluem
Defina o Processo de Compilação
O Processo de Compilação é Enfileirado e Executado
Informações de Compilação são Geradas, Filtradas e Armazenadas
Recuperar Informações de Compilação
Definindo o Parâmetro do Processo de Compilação para Detalhamento de Log
Prática Recomendada: Defina o Menor Detalhamento Possível
Use o Detalhamento Mínimo ao Executar uma Compilação
Use o Detalhamento Mínimo ao Criar um Modelo Personalizado do Processo de Compilação
Para obter mais informações
Como Informações de Compilação são Geradas e Fluem
.png "Fluxo de configurações de compilação de informações e o detalhamento")
.gif "Hh190720.collapse_all(pt-br,VS.110).gif")
Defina o Processo de Compilação
.gif "Etapa 1")
Você pode controlar sistematicamente informações de detalhamento quando você desenvolve seu processo de compilação.Quando você cria ou edita uma definição de compilação que é baseada no Modelo Padrão ou no Modelo de Atualização, exiba a guia de Processo.No nó Básico, você pode selecionar um valor na lista Detalhamento de Log para especificar esse parâmetro do processo de compilação.
Nos casos em que os modelos internos não atendam às suas necessidades, você pode desenvolver um modelo personalizado do processo de compilação.Quando você cria esse tipo de modelo, você deve gravar cuidadosamente informações de compilação.Para obter mais informações, consulte Usar o Detalhamento Mínimo ao Criar um Modelo Personalizado do Processo de Compilação.
O Processo de Compilação é Enfileirado e Executado
.gif "Etapa 2")
Você pode substituir manualmente a definição de Detalhamento de Log quando você enfileirar uma definição de compilação que é baseada no Modelo Padrão ou no Modelo de Atualização.Na caixa de diálogo Enfileirar Compilação, escolha a guia Parâmetros, expanda o nó Básico e selecione um valor na lista de Detalhamento de Log para especificar esse parâmetro do processo de compilação.Esse valor é aplicado a uma única execução da compilação.
Informações de Compilação são Geradas, Filtradas e Armazenadas
.gif "Etapa 3")
O sistema de compilação passa o valor do parâmetro de processo de compilação de Detalhamento para Verbosity.Essa propriedade é usada para filtrar informações de compilação que é registrada em log e armazenadas no seu Team Foundation Server através de Information das seguintes fontes:
Atividades de fluxo de trabalho: Várias atividades de fluxo de trabalho produzem uma mensagem quando uma operação tem êxito ou um aviso ou um erro quando uma operação falha.Por exemplo, a atividade SyncWorkspace gera de mensagens de baixa prioridade quando baixa código-fonte e outros arquivos do servidor para o agente de compilação.Esta atividade gera erros quando falha ao baixar os arquivos.Como outro exemplo, a atividade OpenWorkItem gera um aviso quando falha ao criar um item de trabalho.
Você pode usar outras atividades de fluxo de trabalho para gravar diretamente suas próprias informações de compilação.Para obter mais informações, consulte Criar um Modelo Personalizado do Processo de Compilação que Grava as Informações com o Detalhamento Mínimo necessário.
Compilar o código: O processo de compilação usa a atividade MSBuild para aproveitar o MSBuild na compilação dos binários e realizar outras tarefas vitais.A propriedade Detalhamento desta atividade controla o detalhamento das informações que esse processo gera e publica nos seguintes locais:
O Team Foundation Server armazena resultados, erros, e avisos de compilação.
Um logon a pasta-depósito armazena as mesmas informações que o Team Foundation Server juntamente com todas mensagens restantes que MSBuild produz.
Testar código: O processo de compilação usa RunTests ou a atividade MSTest para executar testes.Todas as mensagens que o log dessas atividades é classificado com um valor da importância de elevação se o controlador de compilação é em- local, ou baixo se você estiver usando Controlador de compilação hospedado.
Recuperar Informações de Compilação
.gif "Etapa 4")
Enquanto a compilação está em execução e depois que é concluída, você pode recuperar tanto o resumo quanto as informações detalhadas da janela de resultados de compilação.Você pode copiar essas informações da janela para a área de transferência.Você também pode vincular diretamente à pasta-depósito para recuperar logs, binários e outros dados.
O Parâmetro do Processo de Compilação de Detalhamento de Log
Em um processo de compilação que é baseado no Modelo Padrão ou no Modelo de Atualização, você pode usar o parâmetro do processo de compilação de Detalhamento de Log para gerenciar o detalhamento das informações que são registradas em log e armazenadas.
A tabela a seguir lista os valores de detalhamento de log e seus efeitos correspondentes:
Valor |
Erros |
Avisos |
Mensagens de Compilação de Alta Prioridade |
Mensagens de Prioridade Normal |
Mensagens de Baixa Prioridade |
Propriedades da Atividade de Fluxo de Trabalho (entradas e saídas) |
|---|---|---|---|---|---|---|
Mínimo |
Y |
N |
N |
N |
N |
N |
Normal |
Y |
Y |
Y |
N |
N |
N |
Detalhado |
Y |
Y |
Y |
Y |
N |
N |
Diagnóstico (Dica: Na maioria dos casos você pode usar logs diagnóstico.Veja Diagnosticar problemas de compilação.) |
Y |
Y |
Y |
Y |
Controlador de compilação de Em- locais: Y |
Y |
Prática Recomendada: Defina o Menor Detalhamento Possível
Embora as informações de compilação sejam importantes, um processo de compilação que registra logs com muitas informações pode causar problemas.Esses problemas podem incluir consumir muito armazenamento em seu Team Foundation Server, diminuir o desempenho do Visual Studio, e sobrecarga de seus membros da equipe com mais informações do que podem manipular.
Use o Detalhamento Mínimo ao Executar uma Compilação
Quando você estiver executando uma compilação, geralmente você deve seguir a prática recomendada para usar a configuração de menor detalhamento que ainda fornece informações que você precisa para cumprir seu objetivo.
Use o Detalhamento Mínimo ao Criar um Modelo Personalizado do Processo de Compilação
Os usuários do seu processo de compilação dependem da filtragem de detalhamento para reduzir a sobrecarga de informações.Você pode ajudar a tornar essa filtragem mais eficiente tomando as seguintes medidas:
Certifique-se de você selecionar a atividade mais apropriada para gravar uma mensagem: Atividade WriteBuildMessage, Atividade WriteBuildWarning, Atividade WriteBuildError ou WriteBuildTestError.
Quando você usa a atividade Atividade WriteBuildMessage para registrar informações, aplique uma abordagem intencional e consistente para definir a propriedade de Prioridade.Quando você usa um valor mais alto de prioridade para sua mensagem, esteja ciente de que você está potencialmente aumentando a quantidade de dados que são armazenados e apresentados aos membros da sua equipe.
.gif "Observação") Observação |
|---|
O impacto de tais decisões pode ser especialmente dramático se você usar essas atividades dentro de uma estrutura de loop como DoWhile, ForEach<T> ou While. |
Para obter mais informações
Diagnosticar problemas de compilação descreve como obter logs diagnóstico.
Team Foundation Criar atividades descreve as atividades de fluxo de trabalho do processo de compilação que este tópico menciona.
Definir um processo de compilação é baseado no modelo padrão e Usar processos de construção de legado fornecem orientação sobre como criar e manter as definições de compilação que são baseadas no Modelo Padrão e no Modelo de Atualização.
Exibir resultados da compilação fornece orientação sobre como usar a janela de resultados de compilação.
IBuildDetail, BuildMessageImportance e BuildVerbosity descrevem alguns elementos chave da API do Team Foundation Build que fornecem funcionalidade de informações de compilação.
Referência de linha de comando MSBuild descreve MSBuild.
Especificar disparadores e as razões de compilação e Uma compilação de fila descrevem como enfileirar manualmente e automaticamente uma compilação.