Definir um processo de compilação é baseado no modelo padrão

Você pode usar o Modelo Padrão (DefaultTemplate.11.1.xaml) para definir rapidamente uma construção básica selecionando os projetos de código que você deseja criar.Você também pode usar esse modelo para incluir uma funcionalidade mais avançada (como execução de testes automatizados) e para ajustar vários aspectos do processo de compilação para atender às necessidades da equipe.

Permissões Necessárias

Para executar este procedimento, você deve ter as permissões de Editar definição de compilação definidas como Permitir.Para obter mais informações, consulte Team Foundation Permissões do servidor.

Para criar uma definição de compilação usando o modelo padrão

  1. No Team Explorer:

    1. Se você ainda não estiver conectado ao projeto de equipe no qual deseja trabalhar, conecte-se ao projeto de equipe.

    2. Escolha Ícone da home pagePágina Inicial e depois Ícone de compilaçõesCompilações.

    3. Na página de Compilações, escolha Nova definição de compilação.

    Uma nova janela de definição de compilação é exibida.

  2. Na guia Processo, em Modelo de processo de compilação, o Modelo Padrão é selecionado por padrão.Em Parâmetros do processo de compilação, expanda o nó Obrigatório, e especifique pelo menos uma solução ou projeto a compilar.

    Para obter mais informações, consulte Especificar os Projetos que Você Deseja Compilar posteriormente neste tópico.

  3. Use informações encontradas posteriormente neste tópico para concluir os campos que fornecem a funcionalidade que você deseja colocar nesta definição de compilação.

  4. Após a conclusão dos campos na guia Processo, especifique opções do processo de compilação nas outras guias.

    Para obter mais informações, consulte Criar uma definição de compilação.

Neste tópico.

  • Sobre os Parâmetros do Processo de Compilação para o Modelo Padrão

  • Especifique os Projetos que Você Deseja Compilar

  • Especifique as Plataformas e as Configurações que Você Deseja Compilar

  • Especificar quais Agentes de Compilação Processam Sua Compilação

  • Especificar Prazos do Agente de Compilação

  • Executar Testes Automatizados e Ativar Análise de Impacto de Teste

  • Especifique Parâmetros Básicos do Processo de Compilação

  • Especifique Parâmetros Avançados do Processo de Compilação

Sobre os Parâmetros do Processo de Compilação para o Modelo Padrão

Este tópico explica como definir uma compilação usando os parâmetros do processo de compilação em compilações que são baseadas no Modelo Padrão.As informações contidas neste tópico descrevem a funcionalidade que deve corresponder com o Visual Studio quando as seguintes condições forem verdadeiras:

  • Você está trabalhando em um projeto de equipe criado a partir de um dos modelos de processo incluídos no Visual Studio.

  • Ninguém em sua equipe removeu ou personalizou o DefaultTemplate.11.1.xaml.

Especifique os Projetos que Você Deseja Compilar

Na caixa Projetos para Compilar, você pode especificar uma ou mais soluções ou projetos de código para compilar.(Para exibir esta caixa, expanda o nó Obrigatório e, em seguida, expanda o nó Itens para Compilar.) Você deve especificar pelo menos uma solução ou projeto.

Se você estiver criando vários projetos relacionados, você normalmente deve adicioná-los a uma única solução e especificar esta solução na caixa Projetos para Compilar em vez de listar cada projeto separadamente.

Na caixa Projetos para Compilar, você pode escolher o botão de reticências (...) para abrir e usar a caixa de diálogo Soluções/Projetos para especificar as soluções ou projetos a compilar.

Para preencher manualmente a caixa Projetos para Compilar, você especifica o caminho de controle da versão completa para cada projeto ou solução que você deseje criar.Você limita cada valor com uma vírgula, como mostra o exemplo a seguir:

$/Features/FeatureA/Server/All Server Projects.sln, $/Features/FeatureA/Client/All Client Projects.sln

Observação importanteImportante

Certifique-se de que o caminho para cada projeto ou solução é um filho de um dos valores da Pasta de Controle do Código-Fonte que está listado na guia Área de Trabalho da definição de compilação.

Especifique as Plataformas e as Configurações que Você Deseja Compilar

Na caixa Configurações para Compilar, você pode especificar quais plataformas e configurações você deseja criar.(Para exibir esta caixa, expanda o nó Obrigatório e, em seguida, expanda o nó Itens para Compilar.) Por exemplo, você pode especificar que esta compilação deve compilar somente a configuração de lançamento da versão de 32 bits do seu projeto C++ incluindo Lançamento|x86 nessa caixa.

DicaDica

Se você tiver um grande codebase, você pode aumentar significativamente o quão rapidamente a compilação é processada criando apenas as configurações e as plataformas de que você precisa.

Se você deixar a caixa Configurações para Compilar vazia, a configuração padrão e a plataforma que é definida em cada solução ou projeto são compiladas.

Na caixa Itens para Compilar, você pode escolher o botão de reticências () para abrir e usar a caixa de diálogo Configurações para especificar os itens a serem compilação.Você também pode especificá-los manualmente.

Cada configuração na caixa Configurações para Compilar deve estar no seguinte formato:

Configuração|Plataforma

Você deve substituir os seguintes espaços reservados:

  • Configuração é um valor como Depuração, Lançamento, ou Todas as Configurações.

  • Plataforma é um valor como o Win32, x86, x64 ou Qualquer CPU.

As configurações na lista devem ser delimitadas por vírgulas.

Por exemplo, se você quisesse criar tanto configuração de Depuração quanto de Liberação do seu projeto C#, você especificaria Depuração|Qualquer CPU, Liberação|Qualquer CPU na caixa Configurações para Compilar.

Os tokens que você usa para configuração e plataforma devem corresponder aos tokens que estão configurados nas suas propriedades de solução ou propriedades de projeto de código.Se eles não corresponderem, você pode enfrentar resultados inesperados quando a compilação for concluída.

Especificar quais Agentes de Compilação Processam Sua Compilação

Para especificar quai agentes de compilação são usados para processar a sua compilação, expanda o nó Avançado, expanda o nó Configurações de Agente, e então especifique valores para os seguintes parâmetros:

  • Filtro de Nome: Você pode filtrar os agentes de compilação que são usados para processar esta definição de compilação digitando o nome do agente neste campo.Você também pode especificar um conjunto de nomes usando os caracteres curinga * e ?.Por exemplo, você pode especificar CI* para especificar qualquer agente cujo nome comece com os caracteres CI.Agentes iriam satisfazer este critério incluem CI, CI1, e CI_Agent2.

  • Filtro das Marcas: Especifique uma ou mais marcações para garantir que somente os agentes de compilação que possuam marcas correspondentes possam executar esta compilação.Você normalmente aplica marcas a determinados agentes de compilação para reservá-los para fins especiais.Por exemplo, você configura um agente de compilação em um computador de compilação que foi criado para processar as suas compilações de check-in com barreira.Você aplica a marca com barreira a este agente de compilação.Finalmente, você aplica a marca com barreira à definição de compilação para que ela seja processada somente pelo agente que também é marcado com a marca com barreira.Para especificar marcas, você escolhe o botão de reticências ().

    ObservaçãoObservação

    O grupo de agentes de compilação que estão disponíveis para processar esta compilação é determinado pelo controlador de compilação que você especificou para esta definição de compilação.Para alterar o controlador de compilação, escolha a guia Opções de Compilação, abra o menu Controlador de compilação, e então escolha um controlador de compilação.

  • Operador de Comparação de Marcas: No menu, escolha um dos seguintes valores:

    • MatchExactly: Escolha esse valor se você desejar que esta definição de compilação seja processada apenas pelos agentes de compilação que possuam exatamente o mesmo conjunto de marcas que você especificou na caixa Filtro das Marcas.Se você não especificar nenhuma marca, qualquer agente pode processar esta definição de compilação.

      DicaDica

      Escolhendo MatchExactly, você restringe os agentes que estão disponíveis para esta definição de compilação apenas àqueles que tenham o exato conjunto de marcas que estão no campo Filtro das Marcas.

    • MatchAtLeast: Escolha esse valor se você desejar que esta definição de compilação seja processada por qualquer agente de compilação que tenha pelo menos o mesmo conjunto de marcas que você especificou na caixa Filtro das Marcas.Se você não especificar nenhuma marca, somente os agentes que não tenham nenhuma marca poderão processar esta definição de compilação.

Especificar Prazos do Agente de Compilação

Para especificar prazos, expanda o nó Avançado, expanda o nó Configurações de Agente, e depois especifique os parâmetros na tabela a seguir.

Se você desejar...

Então defina este parâmetro…

Usando essa orientação…

Especifique o tempo máximo permitido para que o agente de compilação processe a compilação

Tempo Máximo de Execução

Insira um valor do intervalo de tempo no formato hh:mm:ss.Por exemplo, a compilação falhará com um erro de tempo limite se você especificar um valor de 04:30:15 e o agente de compilação não tiver concluído seu trabalho após 4 horas, 30 minutos e 15 segundos.Especifique um valor de 00:00:00 se você deseja dar ao agente de compilação tempo ilimitado para processar a compilação.

Especifique o tempo máximo permitido para atribuir a solicitação de compilação a um agente de compilação

Tempo Máximo de Espera

Insira um valor do intervalo de tempo no formato hh:mm:ss.Por exemplo, a compilação falhará com um erro de tempo limite se você especificar um valor de 01:30:45 e a compilação não for atribuída a um agente de compilação após 1 hora, 30 minutos e 45 segundos.Especifique um valor de 00:00: 00 se você deseja dar ao controlador de compilação tempo ilimitado para localizar um agente de compilação para processar esta definição de compilação.

Executar Testes Automatizados e Analisar o Impacto de Teste

Você pode projetar sua compilação para executar um ou mais ensaios automatizados e analisar o impacto de alterações de código em seus testes.Para obter mais informações, consulte Teste de execução em seu processo de compilação.

Especifique Parâmetros Básicos do Processo de Compilação

Geralmente você deve alterar os parâmetros do processo de compilação no nó Básico para concluir com êxito alguns dos cenários mais comuns.

Se você desejar...

Então defina este parâmetro…

Usando essa orientação…

Executar um ou mais ensaios automatizados

Testes Automatizados

Teste de execução em seu processo de compilação

Personalizar a convenção que é usada para nomear compilações concluídas

Formato de Número da Compilação

Você e sua equipe podem carregar dados úteis no nome de cada compilação concluída.Para obter mais informações, consulte Trabalhar com números de compilação.

Para personalizar este parâmetro, você pode inserir texto diretamente neste campo.No entanto, você pode alterar o valor e exibir os tokens disponíveis mais facilmente escolhendo o botão de reticências () para abrir e então usar a caixa de diálogo Editor de BuildNumber.Nesta caixa de diálogo, escolha Macros para exibir e inserir os tokens que você deseja usar.

Especifique se e como limpar o espaço de trabalho do agente de compilação antes que ele processe a compilação

Limpar o Espaço de Trabalho

Neste menu, escolha um dos seguintes valores:

  • Selecione Todos para excluir todas as saídas e arquivos de código-fonte existentes antes da compilação ser processada.Use esta opção se você deseja que seu processo de compilação seja tão completo como possível em expor problemas no processo de compilação.

  • Selecione Saídas para excluir todas as saídas existentes mas para manter os arquivos de código-fonte que não foram alterados desde a compilação mais recente (executando um tf get sem a opção /all).

  • Selecione Nenhum para deixar as saídas existentes e manter os arquivos de código-fonte que não foram alterados desde a compilação mais recente (executando um tf get sem a opção /all).

DicaDica
Se seu processo de compilação não requer a limpeza adicional que a opção Todos executa, você pode reduzir significativamente o tempo necessário para executar a compilação se você especificar Nenhum (a opção mais rápida) ou Saídas.No entanto, é mais provável que sua equipe perca alguns tipos de defeitos (como aqueles introduzidos durante refatoração) se o espaço de trabalho não estiver limpo.

Especifique quão detalhado você deseja que o log de compilação seja

Detalhamento do Log

Informações de compilação são importantes para sua equipe, mas um processo de compilação que registra muitas informações pode causar problemas.Esses problemas podem incluir o esgotamento do armazenamento do servidor e recursos de CPU, reduzindo o desempenho do servidor, e degradando a experiência do usuário na janela de resultados de compilação no computador cliente.Você pode controlar a quantidade de informações que a sua implantação deve processar, armazenar, e exibir.Para obter mais informações, consulte Gerenciar a verbosidade de informações e controle de compilação.

Analise seu código para localizar defeitos comuns

Realizar Análise de Código

Neste menu, escolha um dos seguintes valores:

  • Selecione Como Configurado para analisar cada projeto de código em que esse recurso estiver habilitado.

  • Selecione Sempre para analisar cada projeto de código, independentemente se esse recurso estiver habilitado nos projetos de código.

  • Selecione Nunca para ignorar a análise de código.

Para obter mais informações, consulte um dos seguintes tópicos:

Armazene seus símbolos para habilitar recursos como a depuração histórica

Indexar Fontes e Caminho para Publicar Símbolos

Você pode configurar sua definição de compilação para publicar dados de símbolo para habilitar recursos como a depuração histórica.Para obter mais informações, consulte Publicar símbolo de dados.

Especifique Parâmetros Avançados do Processo de Compilação

Os parâmetros do processo de compilação oferecidos no nó Avançado são aqueles que você precisará alterar para concluir com êxito alguns dos cenários menos típicos.

Se você desejar...

Então defina este parâmetro…

Usando essa orientação…

Especificar configurações do agente de compilação

Configurações do Agente

Especificar Quais Agentes de Compilação Processam Sua Compilação, Especificar Prazos do Agente de Compilação

Analisar o impacto de teste

Analisar o Impacto de Teste

Teste de execução em seu processo de compilação

Vincular cada compilação concluída com todos os conjuntos de alterações inseridos no código bem como seus itens de trabalho associados

Associar Conjuntos de Alterações e Itens de Trabalho

Na maioria dos casos a prática recomendada é definir esse parâmetro como True (o valor padrão).Isso é especialmente verdadeiro para compilações agendadas (como uma compilação noturna) porque você freqüentemente usa compilações agendadas concluídas com êxito para confirmar correções ou executar testes adicionais.

Cada definição de compilação mantém seu próprio registro dos conjuntos de alterações e os itens de trabalho ficam aguardando para serem associados com a próxima compilação concluída.Por exemplo, o conjunto de alterações 382 é compilado tanto pela Compilação A quanto pela Compilação B.Compilação A é colocada na fila e concluída com êxito.Compilação B é colocada na fila e falha.O conjunto de alterações 382 é agora associado com a compilação concluída com êxito da Compilação A e com a compilação concluída sem êxito da Compilação B. O conjunto de alterações 382 não será vinculado com a próxima compilação concluída da Compilação A, mas será vinculado com a próxima compilação concluída da Compilação B.

Crie um item de trabalho quando a compilação falhar

Criar Item de Trabalho em Caso de Fracasso

Defina o parâmetro como True se você desejar que o sistema crie um item de trabalho quando a compilação falhar.

Desativar testes

Desativar Testes

Teste de execução em seu processo de compilação

Criar uma versão específica de seu código-fonte

Obter Versão

Especificar o versionspec que identifica a versão que você deseja criar.

Para obter mais informações sobre versionspecs, consulte Sintaxe de linha de comando.

Rotular a versão de cada arquivo que foi compilado em cada compilação concluída

Fontes de Rótulo

Defina este parâmetro como True se você desejar que o sistema marque cada arquivo de código-fonte com um rótulo.Esta ação permite que sua equipe identifique facilmente qual versão de cada arquivo está incluída na compilação concluída.

Validar seu código diante dos diagramas de camada

Argumentos do MSBuild

Inclua a seguinte cadeia de caracteres neste valor do parâmetro: /p: ValidateArchitecture=true.

Para obter mais informações, consulte Validar o código com diagramas de camada.

Especificar argumentos de linha de comando para passar para o MS Build

Argumentos do MSBuild

Se seu processo de compilação requer que você passe argumentos para o MSBuild, incorpore-os no parâmetro Argumentos do MSBuild.Para obter mais informações, consulte Referência de linha de comando MSBuild.

Especificar o número de bits da versão do MSBuild que é usada para processar a sua compilação

Plataforma do MSBuild

Especifique um dos seguintes valores:

  • Especifique Automático se você deseja executar o MSBuild no mesmo número de bits de CPU do Serviço Team Foundation Build que está instalado no agente de compilação.

  • Especifique X86 para sempre processar esta compilação usando a versão de 32 bits do MSBuild.

    Como o Visual Studio é executado como um aplicativo de 32 bits, você pode enfrentar problemas quando sua compilação for processada por um agente de compilação que esteja executando a versão de 64 bits do Serviço Team Foundation Build.Especificando X86, você pode resolver esses tipos de problemas.

  • Especifique X64 para sempre processar esta compilação usando a versão de 64 bits do MSBuild.

Se você especificar este valor, você deve certificar-se (por exemplo, usando uma marca conforme explicado anteriormente neste tópico) de que sua compilação é processada por um agente de compilação que seja hospedado por um computador de compilação de 64 bits.Caso contrário, sua compilação falhará.

Enfileirar uma compilação particular

Local de Destino Particular

Você normalmente não especifica um valor para este parâmetro na definição de compilação.Para obter mais informações sobre como enfileirar uma compilação particular, consulte Uma compilação de fila.

Organize os arquivos de saída por solução

Saídas de Compilação Específicas da Solução

Defina este parâmetro como True se você deseja organizar arquivos de saída por solução.