Destinos de compilação do personalizáveis Team Foundation

MSBuilddestinos definem como um MSBuild projeto é construído. O arquivo de Microsoft.TeamFoundation.Build.targets define a hierarquia de destino e predefinidos de um conjunto de MSBuild tarefas e metas para Team Foundation Build usado para todas as Team Foundation Build tipos. As definições de compilação incluir um arquivo de projeto é denominado TFSBuild. O arquivo de projeto pode ser associado com a definição de compilação apenas uma ou várias definições de compilação. TFSBuild importa o arquivo Microsoft.TeamFoundation.Build.targets e fornece valores para várias propriedades e os grupos de itens. Você pode personalizar o arquivo TFSBuild substituir alguns dos destinos de ponto de extensão na hierarquia. O arquivo de destinos encontra-se no <raiz>: \Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild no agente de compilação.

Importante
Não modifique o arquivo Microsoft.TeamFoundation.Build.targets.

Para obter mais informações sobre MSBuild destinos, consulte Destinos do MSBuild.

Destinos podem ser personalizados com tarefas

As tarefas estão contidas nos destinos. Tarefas fornecem o código que executa durante o processo de compilação. A tabela a seguir lista todas as Team Foundation Build destinos que estão definidos para extensibilidade. Insira suas tarefas dentre esses destinos dependendo de quando suas tarefas personalizadas devem ser executados durante o processo de compilação.

Observação
Não recomendamos que você substituir outros destinos.

Nome de destino	Descrição
BeforeEndToEndIteration	Insira a sua tarefa este destino para executar tarefas personalizadas do começo do processo de compilação.
AfterEndToEndIteration	Insira a sua tarefa este destino para executar tarefas personalizadas no final do processo de compilação.
BeforeInitializeWorkspace	Insira a sua tarefa este destino para executar tarefas personalizadas antes da inicialização do espaço de trabalho.
AfterInitializeWorkspace	Insira a sua tarefa este destino para executar tarefas personalizadas após a inicialização do espaço de trabalho.
BuildNumberOverrideTarget	Insira a sua tarefa este destino para personalizar o número de compilação ou descartar as propriedades do local. A tarefa que você escreve deve criar uma propriedade de saída chamada BuildNumber.
BeforeClean	Chamado antes de limpar é tentado. Insira a sua tarefa este destino para executar tarefas de personalizado pre-clean.
AfterClean	Chamado após a limpeza for concluída. Insira a sua tarefa este destino para executar tarefas personalizadas de post-clean.
BeforeGet	Chamado antes de fontes são recuperados do controle de origem. Insira a sua tarefa este destino para executar tarefas personalizadas antes de fontes são recuperados.
AfterGet	Chamado depois de fontes são recuperados. Insira a sua tarefa este destino para executar tarefas personalizadas, depois de recuperados de fontes.
BeforeLabel	Chamado antes de fontes são rotulados. Insira sua tarefa este destino para executar tarefas personalizadas antes de Label de destino.
AfterLabel	Chamado após a conclusão da rotulagem. Insira sua tarefa este destino para executar tarefas personalizadas o Label de destino.
BeforeCompile	Chamado antes do início da compilação. Insira a sua tarefa este destino para executar tarefas personalizadas antes que os arquivos de código são compilados.
BeforeCompileConfiguration	Insira a sua tarefa este destino para executar tarefas personalizadas antes que a compilação de uma configuração individual.
BeforeCompileSolution	Insira a sua tarefa este destino para executar tarefas personalizadas antes que a compilação de uma solução individual.
AfterCompileSolution	Insira a sua tarefa este destino para executar tarefas personalizadas após a compilação de uma solução individual.
AfterCompileConfiguration	Insira a sua tarefa este destino para executar tarefas personalizadas após a compilação de uma configuração individual.
AfterCompile	Chamado após a conclusão da compilação. Insira a sua tarefa este destino para executar tarefas personalizadas, depois que os arquivos de código são compilados.
BeforeGetChangesetsAndUpdateWorkItems	Insira a sua tarefa este destino para executar tarefas personalizadas antes de associar os conjuntos de alterações e atualizar itens de trabalho.
AfterGetChangesetsAndUpdateWorkItems	Insira a sua tarefa este destino para executar tarefas personalizadas após a associação de conjuntos de alterações e atualizar itens de trabalho.
BeforeTest	Chamado antes de testes são executados. Insira sua tarefa este destino para executar tarefas personalizadas antes de Test de destino.
BeforeTestConfiguration	Insira a sua tarefa este destino para executar tarefas personalizadas antes do teste de uma configuração individual.
AfterTestConfiguration	Insira a sua tarefa este destino para executar tarefas personalizadas após o teste de uma configuração individual.
AfterTest	Chamado depois que o teste for concluído. Insira sua tarefa este destino para executar tarefas personalizadas o Test de destino.
BeforeDropBuild	Chamado antes de salvar os binários internos, criar arquivos de log e resultados para o diretório de recebimento de compilação no servidor da versão de teste. Insira a sua tarefa este destino para executar tarefas personalizadas antes de salvar os arquivos criados para o diretório de recebimento.
AfterDropBuild	Chamado depois de soltar os binários internos e os resultados de teste para o servidor de lançamento. Insira a sua tarefa este destino para executar tarefas personalizadas, após os arquivos criados são salvas para o diretório de recebimento.
BeforeCreateWorkItem	Insira a sua tarefa este destino para executar tarefas personalizadas antes da criação do item de trabalho.
AfterCreateWorkItem	Insira a sua tarefa este destino para executar tarefas personalizadas após a criação do item de trabalho.
BeforeOnBuildBreak	Chamado antes de criar um item de trabalho como resultado de uma quebra de compilação. Insira sua tarefa este destino para executar tarefas personalizadas antes de BuildBreak de destino.
AfterOnBuildBreak	Chamado depois que um item de trabalho é criado como resultado de uma quebra de compilação. Insira sua tarefa este destino para executar tarefas personalizadas o BuildBreak de destino.
GenerateDocumentation	Este é um destino vazio. Insira a sua tarefa este destino para gerar documentação durante o processo de compilação.

Substituindo os destinos para executar tarefas personalizadas

Você escreve o código da tarefa deve estar combinado com um destino. Para obter mais informações, consulte Escrita de tarefa. Para escrever uma tarefa personalizada, você deve seguir estas etapas.

1. Escrever o código da tarefa e verifique se que os binários internos estão disponíveis no computador de construção, fornecendo o caminho de controle de origem no arquivo TFSBuild ou disponibilizando os binários no próprio computador compilação.

   Observação
   É boa prática para verificar o código da tarefa no controle de origem de codificação, mas não é absolutamente necessário.

2. Registrar a tarefa personalizada no arquivo TFSBuild, declarando-o usando o UsingTask MSBuild elemento.

   Para obter mais informações, consulte UsingTask elemento (MSBuild).

   <UsingTask 
       TaskName="MyTasks.SimpleTask" 
       AssemblyName="MyAssembly.Build.Tasks"/>
   

3. Execute a tarefa, inserindo-o destino desejado no arquivo TFSBuild.

   <Target Name="BeforeGet">
       <SimpleTask />
   </Target>
   

   Observação
   Adicionar esta marca faz com que os avisos de esquema XML. Você pode ignorar seguramente esses avisos.

4. Implante a DLL que contém a tarefa no computador de compilação personalizada.

   Importante
   Cada definição de compilação que está associada ao arquivo TFSBuild que você personalizar é afetada pela alteração.

Ordem de execução de destino

A ordem de execução dos destinos depende do valor de CleanCompilationOutputOnly propriedade. If CleanCompilationOutputOnly is true, the clean targets (BeforeClean, CoreClean and AfterClean) are executed after the get and label targets (BeforeGet, CoreGet, AfterGet, BeforeLabel, CoreLabel, and AfterLabel). Se o CleanCompilationOutputOnly é a propriedade false, os destinos de limpos são executados antes da destinos get e rótulo. Se CleanCompilationOutputOnly é true, apenas os conjuntos intermediários são excluídos do diretório de fontes durante a CoreClean execução de destino. Se essa propriedade estiver definida como false, o diretório de fontes inteiro será excluído durante CoreClean execução de destino.

A tabela a seguir mostra a lista ordenada de destinos que são executados com base no que se CleanCompilationOutputOnly é true ou false. Os destinos que você pode substituir são exibidos em negrito.

CleanCompilationOutputOnly = true

CleanCompilationOutputOnly = false

InitializeBuildProperties BeforeEndToEndIteration BuildNumberOverrideTarget InitializeEndToEndIteration BeforeInitializeWorkspace CoreInitializeWorkspace AfterinitializeWorkspace InitializeBuild BeforeGet CoreGet AfterGet BeforeLabel CoreLabel AfterLabel BeforeClean CoreCleanCompilationOutput AfterClean BeforeCompile CoreCompile (para cada combinação de plataforma/configuração) BeforeCompileConfiguration CoreCompileConfiguration (para cada solução de compilação) BeforeCompileSolution CoreCompileSolution AfterCompileSolution AfterCompileConfiguration AfterCompile BeforeGetChangesetsAndUpdateWorkItems CoreGetChangeSetsAndUpdateWorkItems AfterGetChangesetsAndUpdateWorkItems BeforeTest CoreTest (para cada combinação de plataforma/configuração) BeforeTestConfiguration CoreTestConfiguration AfterTestConfiguration AfterTest GenerateDocumentation BeforeDropBuild CoreDropBuild AfterDropBuild AfterEndToEndIteration

InitializeBuildProperties BeforeEndToEndIteration BuildNumberOverrideTarget InitializeEndToEndIteration BeforeInitializeWorkspace CoreInitializeWorkspace AfterInitializeWorkspace BeforeClean CoreClean AfterClean InitializeBuild BeforeGet CoreGet AfterGet BeforeLabel CoreLabel AfterLabel BeforeCompile CoreCompile (para cada combinação de plataforma/configuração) BeforeCompileConfiguration CoreCompileConfiguration (para cada solução de compilação) BeforeCompileSolution CoreCompileSolution AfterCompileSolution AfterCompileConfiguration AfterCompile BeforeGetChangesetsAndUpdateWorkItems CoreGetChangeSetsAndUpdateWorkItems AfterGetChangesetsAndUpdateWorkItems BeforeTest CoreTest (para cada combinação de plataforma/configuração) BeforeTestConfiguration CoreTestConfiguration AfterTestConfiguration AfterTest GenerateDocumentation BeforeDropBuild CoreDropBuild AfterDropBuild AfterEndToEndIteration

A seguir está a lista de destinos que são executadas quando ocorrer um erro durante a execução da CoreCompile de destino. Os destinos que você pode substituir são exibidos em negrito.

1. SetBuildBreakProperties

2. BeforeOnBuildBreak

3. GetChangesetsOnBuildBreak

4. BeforeDropBuild

5. CoreDropBuild

6. AfterDropBuild

7. BeforeCreateWorkItem

8. CoreCreateWorkItem

9. AfterCreateWorkItem

10. CoreOnBuildBreak

11. AfterOnBuildBreak

Consulte também

Conceitos

Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation

Propriedades do personalizáveis Team Foundation Build