Definir uma compilação usando o modelo padrão
Você pode usar o modelo padrão para definir rapidamente de uma compilação básica, selecionando os projetos de código que você deseja criar. Você também pode usar este modelo para incluir a funcionalidade mais avançada (como a execução de testes automatizados) e para ajustar vários aspectos do processo de compilação para atender às necessidades de sua equipe.
Permissões necessárias
Para executar este procedimento, você deve ter o Editar definição de compilação permissão definida Permitir. Para obter mais informações, consulte Permissões de Team Foundation Server.
Para criar uma definição de compilação usando o modelo padrão
Em Team Explorer, clique no projeto de equipe na qual você deseja definir sua compilação.
Sobre o Build menu, clique em Nova definição de compilação.
Em nome de definição de compilação, digite um nome.
Clique o processo guia.
Em criar um modelo de processo, o Modelo padrão é selecionada por padrão.
Em parâmetros de processo de compilação, expanda o necessária nó e especificar pelo menos uma solução ou projeto ao criar.
Para obter mais informações, consulte especificar os projetos que deseja construir posteriormente neste tópico.
Use as informações neste tópico para preencher os campos que fornecem a funcionalidade que você deseja colocar a definição de compilação.
Depois que você concluiu os campos a processo guia, preencha os campos na disparador, espaço de trabalho, Construir padrões, e Política de retenção guias.
Para obter mais informações, consulte Criar uma definição de compilação básico.
Neste tópico.
Sobre os parâmetros de processo de compilação para o modelo padrão
Especifique os projetos que você deseja criar
Especificar as plataformas e configurações que você deseja criar
Especifique quais agentes processo de compilação a compilação
Especificar limites de horário do agente de compilação
Executar testes automatizados
Especificar as categorias de teste
Configurar várias execuções de teste
Desativar temporariamente os testes
Habilitar análise de impacto de teste
Especificar parâmetros de processo de construção básicos
Especificar parâmetros de processo de compilação avançadas
Sobre os parâmetros de 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 são baseadas no modelo padrão. As informações neste tópico descrevem a funcionalidade que deve corresponder a Visual Studio Application Lifecycle Management (ALM) , desde que as seguintes condições forem verdadeiras:
Você está trabalhando em um projeto de equipe foi criado a partir de um dos dois modelos de processo estão incluídos no Visual Studio ALM: MSF for Agile Software Development v de 5.0 ou do MSF for CMMI Process Improvement v de 5.0.
Ninguém na sua equipe tenha removido ou personalizado o modelo padrão.
Especifique os projetos que você deseja criar
No projetos de construção caixa, você pode especificar um ou mais soluções ou projetos para criar. (Para exibir esta caixa, expanda o necessária nó e em seguida, expanda o itens para a compilação nó.) Você deve especificar pelo menos uma solução ou projeto.
Se você estiver criando várias relacionadas a projetos, normalmente, você deve adicioná-los para uma solução única e especificar essa solução na projetos de construção caixa em vez de listar cada projeto separadamente.
No projetos de construção caixa, você pode clicar no botão de reticências (...) para abrir e usar o /Projetos de soluções caixa de diálogo para especificar as soluções ou projetos para criar.
Para preencher o projetos de construção manualmente, especifique o caminho de controle de versão completa para cada projeto ou solução que você deseja criar. Você pode delimitar cada valor com uma vírgula, como mostra o exemplo a seguir:
$/ Recursos/FeatureA/servidor/todos servidor Projects.sln, $/ recursos/FeatureA/cliente/todos os Projects.sln de cliente
.gif "Observação importante") Importante |
|---|
Certifique-se de que o caminho para cada projeto ou solução é um filho de um do Pasta de controle de origem valores que está listado na espaço de trabalho guia de definição de compilação. |
Especificar as plataformas e configurações que você deseja criar
No configurações de compilação caixa, você pode especificar quais plataformas e configurações que você deseja criar. (Para mostrar esta caixa, expanda o necessária nó e em seguida, expanda o itens para a compilação nó.) Por exemplo, você pode especificar que esta compilação deve criar apenas a configuração de lançamento da versão de 32 bits do seu projeto de C++, incluindo Release|x86 nesta caixa.
Dica
Se você tiver uma grande base de código, você pode aumentar significativamente a rapidez com a compilação é processada, baseando-se somente as configurações e plataformas que você precisa.
Se você deixar o configurações de compilação caixa vazia, a configuração padrão e a plataforma é definida em cada solução ou projeto é construído.
No itens para a compilação caixa, você pode clicar o botão de reticências (...) para abrir e usar o configurações caixa de diálogo para especificar quais itens de compilação. Você também pode especificá-los manualmente.
Cada configuração de configurações de compilação caixa deve ser da seguinte forma:
Configuração|Plataforma
Você deve substituir os seguintes espaços reservados:
Configuração é um valor, como Debug, Release ou todas as configurações.
Plataforma é um valor como, por exemplo, Win32, x86, x64 ou qualquer CPU.
As configurações da lista devem ser delimitadas por vírgulas.
Por exemplo, se você quisesse criar configuração de depuração e de lançamento do projeto C#, você especificaria Debug|Qualquer CPU, Release|Qualquer CPU na configurações de compilação caixa.
Os tokens que podem ser usados para configuração e plataforma devem coincidir com os tokens que são configurados em suas propriedades de solução ou propriedades do projeto de código. Se eles não corresponderem, você pode enfrentar resultados inesperados quando sua compilação é concluída.
Especifique quais agentes processo de compilação a compilação
Para especificar quais agentes de compilação são usados para processar a sua compilação, expanda o Advanced nó, expanda o Configurações do agente nó e, em seguida, especifique valores para os seguintes parâmetros:
Filtro de nome: Você pode filtrar os agentes de compilação que são usados para processar a definição de compilação, digitando o nome do agente nesse campo. Você também pode especificar um conjunto de nomes usando o * e? caracteres curinga. Por exemplo, você poderia especificar CI * para especificar qualquer agente cujo nome começa com os caracteres de CI. Os agentes que correspondam a esse critério incluem CI, CI1 ou CI_Agent2.
Filtro de marcas: Especifica uma ou mais marcas para garantir que somente os agentes de compilação que têm marcas correspondentes serão executados nesta compilação. Você normalmente pode aplicar marcas em determinados agentes de compilação reservá-los para fins especiais. Por exemplo, você configurar um agente de compilação em uma máquina de compilação é projetada para processar suas criações gated check-in. Aplicar a marca com a porta para o agente de compilação. Finalmente, você aplicar o gated marca para a definição de compilação para que ela é processada apenas pelo agente também está marcada com a marca gated. Para especificar marcas, você clica no botão de reticências (...).
.gif "Observação")
ObservaçãoO pool 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 a definição de compilação. Para modificar o controlador de compilação, clique o Construir padrões guia, abrir o Construir o controlador menu e clique em um controlador de compilação.
Operador de comparação de marca: No menu, clique em um dos seguintes valores:
MatchExactly: Clique neste valor se você desejar que essa definição de compilação a ser processado por somente aqueles criar agentes que tenham o mesmo conjunto de marcas que você especificou na Filtro de marcas caixa. Se você não especificar quaisquer marcas, qualquer agente que pode processar a definição de compilação.
Dica
Clicando em MatchExactly, você restringir os agentes que estão disponíveis para esta definição de compilação a apenas aqueles que possuem o conjunto exato de marcas que estão na Filtro de marcas campo.
MatchAtLeast: Clique neste valor se você desejar que essa definição de compilação a ser processado por qualquer agente de compilação que possui pelo menos o mesmo conjunto de marcas que você especificou na Filtro de marcas caixa. Se você não especificar quaisquer marcas, apenas os agentes que não há marcas podem processar a definição de compilação.
Especificar limites de horário do agente de compilação
Para especificar limites de tempo, expandir o Advanced nó, expanda o Configurações do agente nó e especifique os parâmetros na tabela a seguir.
Se você gostaria de … |
Em seguida, defina este parameter… |
Usando este guidance… |
|---|---|---|
Especifique o tempo máximo permitido para o agente de compilação a compilação de processo. |
Tempo de execução máximo |
Digite um valor de intervalo de tempo no formato de 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 concluiu seu trabalho após 4 horas, 30 minutos e 15 segundos. Especifique um valor de 00: 00: 00 se você quiser que o agente de compilação ilimitado de dar tempo para processar a compilação. |
Especifique o tempo máximo permitido para atribuir a solicitação de compilação para um agente de compilação |
Tempo de espera máximo |
Digite um valor de intervalo de tempo no formato de 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 foi 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 a controladora de compilação ilimitada tempo para encontrar um agente de compilação para processar a definição de compilação. |
Executar testes automatizados
Você pode criar sua compilação para realizar uma ou mais automatizado de teste é executado. Para cada teste que você configure, você pode especificar as configurações a seguir:
quais testes são executados.
quais configurações são usadas para executar o teste.
Se a compilação falhar se um teste falhar
ImportanteA compilação pode executar os testes somente se ela é processada por um agente de compilação no qual Visual Studio Test Professional 2010 está instalado. Para obter mais informações, consulte Criar e trabalhar com os agentes de compilação.
Para configurar sua compilação para executar os testes automatizados
Sobre o processo guia de sua definição de compilação, expanda o básica nó.
Selecione o Testes automatizados caixa e clique no botão de reticências (...) nesta caixa.
O Testes automatizados caixa de diálogo aparece.
Execute uma das seguintes etapas:
Para adicionar uma novo execução de teste, clique em Add.
Para modificar uma execução de teste existente, clique nele e, em seguida, clique em Editar.
O O teste de adicionar/editar caixa de diálogo aparece.
Clique no método que você deseja usar para executar os testes:
Testar a especificação de arquivo do assembly (recomendada)
Deixe o valor padrão (** \*test*.dll) se desejar que o agente de compilação para pesquisar recursivamente para todos os arquivos. dll que corresponde ao * test*.dll na binaries subdiretório do agente de compilação trabalhando directory. Como alternativa, modifique a especificação de arquivo para atender às suas necessidades.
(Opcional) Especificar um Arquivo de configurações de teste para configurar como os testes são executados. Para obter mais informações, consulte Criar um teste automatizado de configurações para executar testes a partir de Visual Studio.
Arquivo de metadados de teste (. vsmdi)
Se você clicar nesta opção, clique em Procurar para localizar e especificar o arquivo de metadados de teste que você deseja usar. Você pode, então, ambos deixar o Executar todos os testes nesse arquivo VSMDI selecionada, de caixa de seleção ou desmarcá-la e, em seguida, selecione um ou mais testes na listas de teste para executar lista.
Para obter mais informações, consulte Listas de definição de teste para agrupar os testes.
Clique o Argumentos decritérios/ guia.
(Opcional) Filtre os testes a serem executados por categoria.
Para obter mais informações, consulte Especificar categorias de teste posteriormente neste tópico.
(Opcional) Filtre os testes a serem executados por prioridade.
Dica
Se você tiver atribuído prioridades aos seus testes, este parâmetro pode ser um mecanismo importante para ajudá-lo a definir um equilíbrio entre um teste completo e mais rápido se baseia.
Definir Prioridade mínima de teste a ambos um inteiro positivo é menor que ou igual a Prioridade máxima de teste ou -1 para não indicar nenhum valor mínimo.
Definir Prioridade máxima de teste a ambos um inteiro positivo é igual ou maior que Mínimo prioridade de teste ou -1 para não indicar nenhum valor máximo.
Se você desejar que a compilação falhar se qualquer um dos testes nesse teste executar falhar, selecione o Falhar a compilação em caso de falha de teste caixa de seleção. Se você deixar essa caixa de seleção desmarcada e se algum teste falhar, a compilação concluída será classificada como Foi parcialmente bem-sucedida.
Clique em OK.
Especificar as categorias de teste
Você pode usar categorias de teste para filtrar os testes que são executados durante a execução de teste.
Atribuir categorias a seus testes
Antes de usar categorias de teste para filtrar os testes que você execute, você deve primeiro atribuir categorias aos seus testes usando Test Professional 2010. Por exemplo, você poderia criar uma categoria de teste chamada CI e em seguida, especifique a categoria na integração contínua de compilações. Você pode criar outra categoria para os testes de verificação de compilação chamados bvt e em seguida, especifique a categoria em compilações programadas, como, por exemplo, sua compilação noturna.
Para obter mais informações, consulte Definindo categorias de teste para agrupar os testes.
Especificar as categorias de teste para a execução de teste
Você pode especificar categorias de teste de duas maneiras:
Quando criar o teste executado, conforme explicado anteriormente neste tópico.
Modificando uma execução de teste existente. (Você modificar um teste existente, execute, expandindo o básica nó, expandindo o Testes automatizados nó, expandindo a execução do teste que você deseja modificar e, em seguida, clicando no Filtro de categorias caixa.)
Você pode especificar categorias de teste em uma das seguintes formas:
Especifica uma categoria de teste único para incluir ou excluir. Por exemplo, você tem uma categoria de teste que é chamada BVT. Você definir esse parâmetro como bvt para executar somente os testes que fazem parte desta categoria ou! bvt para executar todos os testes exceto os testes que fazem parte desta categoria.
Especificar várias categorias de teste usando o & & ("e" operador) e o! ("não" operador). Por exemplo, você pode especificar rápida & & gui & &! profundo para executar somente testes que são parte de dois a rápida e categorias de gui, mas que não fazem parte da categoria profunda.
Especificar várias categorias de teste usando o | ("ou" operador) e o! ("não" operador). Por exemplo, você pode especificar o quick|gui|!profundo executar os testes que fazem parte da categoria rápida, testes que fazem parte da categoria de gui e quaisquer testes que não fazem parte da categoria profunda.
Configurar várias execuções de teste
Você pode configurar como muitas execuções de teste é necessário atender aos requisitos de compilação da sua equipe e testar o processo. Por exemplo, talvez você precise configurar várias execuções de teste em uma única compilação nas seguintes situações:
Você tem dois conjuntos de testes:
Um conjunto de testes de núcleo de alta prioridade que deve passar. Adicionar a uma execução de teste que especifica um A prioridade de teste de mínimo e Prioridade máxima de teste 1. Selecionar o compilação de falha em caso de falha do teste caixa de seleção.
Um conjunto de testes menos importantes que você deseja executar, mas que não são necessários para passar para a compilação ser usada. Adicionar a uma execução de teste que especifica um A prioridade de teste de mínimo de 2 e uma Prioridade máxima de teste 3. Você pode deixar o falhar a compilação em caso de falha do teste caixa de seleção desmarcada.
Você deseja executar o mesmo conjunto de testes com configurações de teste diferentes.
Você deseja que o principal conjunto de módulos (assemblies) que você criar para estar sujeito a cobertura de código. No entanto, você tem outro conjunto de módulos (assemblies) de uma fonte externa que não requerem cobertura de código. Para habilitar esse tipo de processo, você poderia usar duas execuções de teste que estão configuradas para utilizar dois conjuntos de arquivos de configurações de teste.
Desativar temporariamente os testes
Se você deverá desativar temporariamente os testes sem excluir a execução de teste, expanda o Advanced nó e o conjunto de Desativar testes para True. Definir o valor de volta para False quando você deseja ativar testes novamente.
Habilitar análise de impacto de teste
Os testadores e desenvolvedores talvez precise saber como as alterações de código são circundadas em uma compilação concluída afetaram os testes. Quando você habilita a análise de impacto de teste em uma compilação, o sistema analisa e, em seguida, emite relatórios sobre como alterações de código afetado seus testes no relatório da compilação da compilação concluída.
Para habilitar a análise de impacto de teste
Configure análise de impacto de teste em um arquivo de configurações de teste.
Para obter mais informações, consulte Como: Coletar dados para verificar quais testes devem ser executados após alterações de código.
Crie uma execução de teste está configurado para usar o arquivo de configurações de teste.
Para obter mais informações, consulte Executar testes automatizados anteriormente neste tópico.
Expanda o nó avançado e certifique-se de que Analisar o impacto no teste for definido como True e que Desativar testes for definido como False.
Especificar parâmetros de processo de construção básicos
Muitas vezes é necessário modificar os parâmetros do processo de compilação no básica o nó para concluir com êxito a alguns dos cenários mais comuns.
Se você gostaria de … |
Em seguida, defina este parameter… |
Usando este guidance… |
|---|---|---|
Personalizar a convenção de que é usada para nomear as compilações concluídas |
Formato de número de compilação |
Você e sua equipe podem carregar dados úteis para o nome de cada compilação concluída. Por exemplo, o valor padrão inclui tokens que são substituídos com as seguintes informações:
Para personalizar este parâmetro, você pode digitar texto diretamente para esse campo. No entanto, você pode modificar o valor e exibir os símbolos disponíveis clicando no botão de reticências mais facilmente (...) para abrir e, em seguida, usar o Editor do formato BuildNumber caixa de diálogo. Na caixa de diálogo, clique em Macros para exibir e inserir os símbolos que você deseja usar. |
Especificar se e como limpar o espaço de trabalho do agente de compilação antes que ele processa a compilação |
Limpar o espaço de trabalho |
Nesse menu, clique em um dos seguintes valores:
Dica
Se o processo de compilação não precisam de limpeza adicionais que o todos os opção 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.
|
Especifique como detalhado que você deseja que o log de compilação a ser |
Detalhamento do log |
Você pode controlar a verbosidade do log que aparece no relatório da compilação. Para obter uma lista dos valores e seus efeitos correspondentes, consulte Valores de verbosidade de log posteriormente neste tópico. Para obter mais informações, consulte Exibir a janela de resultados de compilação. |
Analisar seu código para localizar defeitos comuns |
Realizar análise de código |
Nesse menu, clique em um dos seguintes valores:
Para obter mais informações, consulte um dos seguintes tópicos: |
Armazenar seus símbolos para habilitar recursos como a depuração de históricos |
Índice de fontes e o caminho para publicar os símbolos |
Você pode configurar a sua definição de compilação para publicar dados de símbolo para habilitar recursos como a depuração de históricos. Para habilitar Serviço Team Foundation Build para usar SymStore para armazenar seus símbolos, execute as seguintes etapas:
Para obter mais informações, consulte Depuração com IntelliTrace e os tópicos a seguir no site da Microsoft: |
Valores de verbosidade do log
A tabela a seguir lista os valores de verbosidade do log e seus efeitos correspondentes.
Valor |
Construir erros |
Avisos de compilação |
Alta importância Criar Mensagens |
Prioridade normal Criar Mensagens |
Baixa prioridade Criar Mensagens |
Propriedades de atividade do fluxo de trabalho (entradas e saídas) |
|---|---|---|---|---|---|---|
Mínimo |
Y |
N |
N |
N |
N |
N |
Normal |
Y |
Y |
Y |
N |
N |
N |
Detalhadas |
Y |
Y |
Y |
Y |
N |
N |
Diagnóstico |
Y |
Y |
Y |
Y |
Y |
Y |
O valor de verbosidade do log que você especificar também afeta a verbosidade de mensagens provenientes do MSBuild. Para obter mais informações, consulte Referência de linha de comando do MSBuild.
Especificar parâmetros de processo de compilação avançadas
Os parâmetros do processo de compilação é oferecido na Advanced nó são aqueles que você precise modificar para concluir com êxito a alguns dos cenários menos comuns.
Se você gostaria de … |
Em seguida, defina este parameter… |
Usando este guidance… |
|---|---|---|
Validar o seu código contra os diagramas de camada |
Argumentos do MSBuild |
Inclua o valor do parâmetro a seguinte seqüência: /p:ValidateArchitecture = true. Para obter mais informações, consulte Como: Valide.NET Code contra os diagramas de camada. |
Especificar argumentos de linha de comando para passar para a construção da MS |
Argumentos do MSBuild |
Se o seu processo de construção requer que você passar argumentos para MSBuild, digitá-los a Argumentos de MSBuild parâmetro. Para obter mais informações, consulte Referência de linha de comando do MSBuild. |
Vincular cada compilação concluída com todos os conjuntos de alterações que acompanhou o código, bem como seus itens de trabalho associados |
Associar os conjuntos de alterações e itens de trabalho |
Na maioria dos casos a prática recomendada é definir esse parâmetro para True (o valor padrão). Isso é especialmente verdadeiro para as compilações programadas (como uma compilação noturno) porque você geralmente usa concluídas com êxito de compilações programadas para confirmar as correções ou executar testes adicionais. Cada definição de compilação mantém seu próprio registro de quais conjuntos de alterações e o trabalho itens estiverem aguardando para ser associado com a próxima compilação concluída. Por exemplo, changeset 382 baseia-se por compilação a e b de compilação. Construir um está na fila e concluída com êxito. Construção b está na fila e falha. Changeset 382 está agora vinculado com a compilação concluída com êxito da compilação e a compilação concluída com falhas de b de compilação. Changeset 382 não serão vinculadas com a próxima compilação concluída da compilação, mas será vinculado com a próxima compilação concluída do b de compilação. |
Copie para a pasta de soltar os executáveis e outros binários resultantes da criação de projetos |
Saídas de copiar para pasta suspensa |
Defina este parâmetro como True para copiar arquivos executáveis e outros binários resultantes da criação de projetos para essa pasta drop. Observação
A pasta de recebimento é especificada na Construir padrões guia.
|
Criar um item de trabalho quando a compilação falhar |
Criar o Item de trabalho em caso de falha |
Defina este parâmetro como True se você deseja que o sistema para criar um item de trabalho quando a compilação falha. |
Criar uma versão específica do seu código-fonte |
Obter versão |
Especifique o versionspec que identifica a versão que você deseja criar. Para obter mais informações sobre versionspecs, consulte Sintaxe de linha de comando (controle de versão). |
Rótulo da 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ê deseja que o sistema para marcar cada arquivo de código-fonte com um rótulo. Esta ação permite que sua equipe para identificar facilmente qual versão de cada arquivo é incluído na compilação concluída. |
Especifique o número de bits, a versão do MSBuild é usado para processar a sua compilação |
Plataforma do MSBuild |
Especifique um dos seguintes valores:
|