Partilhar via

Personalizável Team Foundation compilação destinos

  • Artigo

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

MSBuild definem destinos como um MSBuild projeto é construído. O arquivo Microsoft.TeamFoundation.compilação.targets define a hierarquia de destino e um conjunto de predefinidos MSBuild tarefas e metas para Team Foundation Build usado para todas Team Foundation Build tipos. Definições de compilação incluem um arquivo de projeto chamado TfsBuild.proj.O arquivo de projeto pode ser associado a definição de compilação apenas um, ou várias definições de compilação.TfsBuild.proj importa o arquivo Microsoft.TeamFoundation.compilação.targets e fornece valores para várias propriedades e os grupos de itens.Você pode personalizar o arquivo TfsBuild.proj substituir destinos alguns a extensão de point-in-a hierarquia.O arquivo de destinos está localizado em <raiz >: \programa Files\MSBuild\Microsoft\VisualStudio\TeamBuild no agente de compilação.

Observação importante:

Não modifique o arquivo Microsoft.TeamFoundation.compilação.targets.

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

Destinos que podem ser personalizados com as 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 todos os Team Foundation Build alvos são definidos para extensibilidade. Inserir suas tarefas em um desses destinos que dependa dele quando você deve executar suas tarefas personalizadas durante o processo de compilação.

Observação:

Não recomendamos que substituem outros destinos.

Nome de destino

Descrição

BeforeEndToEndIteration

Insira sua tarefa este destino para executar tarefas personalizadas muito no início do processo de compilação.

AfterEndToEndIteration

Insira sua tarefa este destino para executar tarefas personalizadas ao participante do processo de compilação.

BeforeInitializeWorkspace

Insira sua tarefa este destino para executar tarefas personalizadas antes da inicialização do espaço de trabalho.

AfterInitializeWorkspace

Insira sua tarefa este destino para executar tarefas personalizadas após a inicialização do espaço de trabalho.

BuildNumberOverrideTarget

Insira este destino para personalizar o número da versão ou soltar local propriedades sua tarefa.A tarefa que você escreve deve criar uma propriedade de saída chamada BuildNumber.

BeforeClean

Chamado antes de limpar é tentado.Insira este destino para executar tarefas personalizado pre-clean sua tarefa.

AfterClean

Chamado após a conclusão limpa.Insira este destino para executar tarefas personalizadas post-clean sua tarefa.

BeforeGet

Chamado antes de fontes são recuperados do controle de fonte.Inserir sua tarefa nesse destino para executar tarefas personalizadas antes de fontes são recuperados.

AfterGet

Chamado depois que as fontes são recuperados.Insira sua tarefa este destino para executar tarefas personalizadas depois de fontes são recuperados.

BeforeLabel

Chamado antes de fontes são rotuladas.Insira a tarefa este destino para executar tarefas personalizadas antes do Label destino.

AfterLabel

Chamada a rotulação é concluída.Insira a tarefa este destino para executar tarefas personalizadas após o Label destino.

BeforeCompile

Chamado antes da compilação é iniciada.Inserir a tarefa nesse destino executar tarefas personalizadas para que os arquivos de código são compilados.

BeforeCompileConfiguration

Insira sua tarefa este destino para executar tarefas personalizadas antes da compilação de uma configuração individual.

BeforeCompileSolution

Insira sua tarefa este destino para executar tarefas personalizadas antes da compilação de uma solução individual.

AfterCompileSolution

Insira sua tarefa este destino para executar tarefas personalizadas após a compilação de uma solução individual.

AfterCompileConfiguration

Insira 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 sua tarefa este destino para executar tarefas personalizadas após os arquivos de código são compilados.Para um exemplo, consulte Demonstra Passo a passo: Configurando o Team compilação para construir um Visual Studio Setup projeto.

BeforeGetChangesetsAndUpdateWorkItems

Insira sua tarefa este destino para executar tarefas personalizadas antes de associação de conjuntos de alterações e atualizar itens de trabalho.

AfterGetChangesetsAndUpdateWorkItems

Insira 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 que os testes são executados.Insira a tarefa este destino para executar tarefas personalizadas antes do Test destino.

BeforeTestConfiguration

Inserir sua tarefa nesse destino para executar tarefas personalizadas antes do teste de uma configuração individual.

AfterTestConfiguration

Inserir sua tarefa nesse destino para executar tarefas personalizadas após o teste de uma configuração individual.

AfterTest

Chamado depois que o teste for concluído.Insira a tarefa este destino para executar tarefas personalizadas após o Test destino.

BeforeDropBuild

Chamado antes de salvar os binários internos, criar arquivos de log, e Resultados de Teste para o diretório de compilação-soltar no servidor versão.Inserir a tarefa nesse destino executar tarefas personalizadas para que os arquivos incorporados são salvos para o diretório de soltar.

AfterDropBuild

Chamado depois de soltar os binários internos, compilação arquivos de log e testar resultados para o servidor de versão.Insira este destino para executar tarefas personalizadas após os arquivos incorporados são salvos para o diretório de soltar a tarefa.

BeforeCreateWorkItem

Insira sua tarefa este destino para executar tarefas personalizadas antes da criação do item de trabalho.

AfterCreateWorkItem

Insira 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 que resultou de uma quebra de compilação.Insira a tarefa este destino para executar tarefas personalizadas antes do BuildBreak destino.

AfterOnBuildBreak

Chamado depois que um item de trabalho é criado sistema autônomo resultado de uma quebra de compilação.Insira a tarefa este destino para executar tarefas personalizadas após o BuildBreak destino.

GenerateDocumentation

Este é um destino vazio.Inserir sua tarefa nesse destino automaticamente gerar documentação durante o processo de compilação.

Substituindo destinos para executar tarefas personalizadas

Você escreve o código da tarefa deve estar combinado com um destino e os binários internos devem ser disponível no computador de construção, fornecendo o caminho de controle de fonte no arquivo TfsBuild.proj ou disponibilizando os binários no próprio computador compilação.You must also register the custom task in the TfsBuild.proj file by declaring it using the UsingTaskMSBuild element.Para obter mais informações, consulte Elemento UsingTask (MSBuild).Por fim, implante a DLL que contém a tarefa no computador de compilação personalizada.

Observação importante:

Cada definição de compilação associado com o arquivo TfsBuild.proj que você personalizar é afetada pela alterar.

Para obter um exemplo de uma implementação de ponta a ponta de uma tarefa personalizada, consulte Demonstra Passo a passo: Personalizando Team Foundation compilação com uma tarefa personalizada.

Ordem de execução de destino

A ordem de execução dos destinos depende do valor do CleanCompilationOutputOnly propriedade. If CleanCompilationOutputOnly é true, o (destinos limpaBeforeClean, CoreClean e AfterClean) for executada após o (destinos get e rótuloBeforeGet, CoreGet, AfterGet, BeforeLabel, CoreLabel, e AfterLabel). Se o CleanCompilationOutputOnly propriedade é false, destinos de limpos são executados antes dos destinos get e rótulo. If CleanCompilationOutputOnly é true, apenas os conjuntos intermediários são excluídos do diretório de códigos-fonte durante a CoreClean execução de destino. Se esta propriedade for definida como false, todo o diretório de códigos-fonte será excluído durante CoreClean execução de destino.

A tabela a seguir mostra a lista ordenada de destinos que são executadas com base no CleanCompilationOutputOnly é true ou false. Você pode substituir os destinos indicam.

CleanCompilationOutputOnly = true

CleanCompilationOutputOnly = false

  1. InitializeBuildProperties

  2. BeforeEndToEndIteration (pode substituir)

  3. BuildNumbersubstituirTarget (pode substituir)

  4. InitializeEndToEndIteration

  5. BeforeInitializeWorkspace (pode substituir)

  6. CoreInitializeWorkspace

  7. AfterinitializeWorkspace (pode substituir)

  8. InitializeBuild

  9. BeforeGet (pode substituir)

  10. CoreGet

  11. AfterGet (pode substituir)

  12. BeforeLabel (pode substituir)

  13. CoreLabel

  14. AfterLabel (pode substituir)

  15. BeforeClean (pode substituir)

  16. CoreCleanCompilationOutput

  17. AfterClean (pode substituir)

  18. BeforeCompile (pode substituir)

  19. CoreCompile (para cada combinação de plataforma/configuração)

  20. BeforeCompileConfiguration (pode substituir)

  21. CoreCompileConfiguration (para cada solução criar)

  22. BeforeCompileSolution (pode substituir)

  23. CoreCompileSolution

  24. AfterCompileSolution (pode substituir)

  25. AfterCompileConfiguration (pode substituir)

  26. AfterCompile (pode substituir)

  27. BeforeGetChangesetsAndUpdateWorkItems (pode substituir)

  28. CoreGetChangeSetsAndUpdateWorkItems

  29. AfterGetChangesetsAndUpdateWorkItems (pode substituir)

  30. BeforeTest (pode substituir)

  31. CoreTest (para cada combinação de plataforma/configuração)

  32. BeforeTestConfiguration (pode substituir)

  33. CoreTestConfiguration

  34. AfterTestConfiguration (pode substituir)

  35. AfterTest (pode substituir)

  36. GenerateDocumentation (pode substituir)

  37. PackageBinaries (pode substituir)

  38. BeforeDropBuild (pode substituir)

  39. CoreDropBuild

  40. AfterDropBuild (pode substituir)

  41. AfterEndToEndIteration (pode substituir)

  1. InitializeBuildProperties

  2. BeforeEndToEndIteration (pode substituir)

  3. BuildNumbersubstituirTarget (pode substituir)

  4. InitializeEndToEndIteration

  5. BeforeInitializeWorkspace (pode substituir)

  6. CoreInitializeWorkspace

  7. AfterInitializeWorkspace (pode ser substituída)

  8. BeforeClean (pode substituir)

  9. CoreClean

  10. AfterClean (pode substituir)

  11. InitializeBuild

  12. BeforeGet (pode substituir)

  13. CoreGet

  14. AfterGet (pode substituir)

  15. BeforeLabel (pode substituir)

  16. CoreLabel

  17. AfterLabel (pode substituir)

  18. BeforeCompile (pode substituir)

  19. CoreCompile (para cada combinação de plataforma/configuração)

  20. BeforeCompileConfiguration (pode substituir)

  21. CoreCompileConfiguration (para cada solução criar)

  22. BeforeCompileSolution (pode substituir)

  23. CoreCompileSolution

  24. AfterCompileSolution (pode substituir)

  25. AfterCompileConfiguration (pode substituir)

  26. AfterCompile (pode substituir)

  27. BeforeGetChangesetsAndUpdateWorkItems (pode substituir)

  28. CoreGetChangeSetsAndUpdateWorkItems

  29. AfterGetChangesetsAndUpdateWorkItems (pode substituir)

  30. BeforeTest (pode substituir)

  31. CoreTest (para cada combinação de plataforma/configuração)

  32. BeforeTestConfiguration (pode substituir)

  33. CoreTestConfiguration

  34. AfterTestConfiguration (pode substituir)

  35. AfterTest (pode substituir)

  36. GenerateDocumentation (pode substituir)

  37. PackageBinaries (pode substituir)

  38. BeforeDropBuild (pode substituir)

  39. CoreDropBuild

  40. AfterDropBuild (pode substituir)

  41. AfterEndToEndIteration (pode substituir)

A seguir está uma lista de destinos que são executadas quando ocorrer um erro durante a execução do CoreCompile destino. Você pode substituir os destinos são indicados.

  1. SetBuildBreakProperties

  2. BeforeOnBuildBreak (pode substituir)

  3. GetChangesetsOnBuildBreak

  4. BeforeDropBuild (pode substituir)

  5. CoreDropBuild

  6. AfterDropBuild (pode substituir)

  7. BeforeCreateWorkItem (pode substituir)

  8. CoreCreateWorkItem

  9. AfterCreateWorkItem (pode substituir)

  10. CoreOnBuildBreak

  11. AfterOnBuildBreak (pode ser substituída)

Consulte também

Tarefas

Como: Gravar uma tarefa

Conceitos

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

Propriedades personalizáveis Team Foundation compilação

Equipe Foundation compilação tarefas