Compartilhar via


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.

Observação importanteImportante

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çãoObservaçã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çãoObservaçã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çãoObservaçã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.

    Observação importanteImportante

    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

  1. InitializeBuildProperties

  2. BeforeEndToEndIteration

  3. BuildNumberOverrideTarget

  4. InitializeEndToEndIteration

  5. BeforeInitializeWorkspace

  6. CoreInitializeWorkspace

  7. AfterinitializeWorkspace

  8. InitializeBuild

  9. BeforeGet

  10. CoreGet

  11. AfterGet

  12. BeforeLabel

  13. CoreLabel

  14. AfterLabel

  15. BeforeClean

  16. CoreCleanCompilationOutput

  17. AfterClean

  18. BeforeCompile

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

  20. BeforeCompileConfiguration

  21. CoreCompileConfiguration (para cada solução de compilação)

  22. BeforeCompileSolution

  23. CoreCompileSolution

  24. AfterCompileSolution

  25. AfterCompileConfiguration

  26. AfterCompile

  27. BeforeGetChangesetsAndUpdateWorkItems

  28. CoreGetChangeSetsAndUpdateWorkItems

  29. AfterGetChangesetsAndUpdateWorkItems

  30. BeforeTest

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

  32. BeforeTestConfiguration

  33. CoreTestConfiguration

  34. AfterTestConfiguration

  35. AfterTest

  36. GenerateDocumentation

  37. BeforeDropBuild

  38. CoreDropBuild

  39. AfterDropBuild

  40. AfterEndToEndIteration

  1. InitializeBuildProperties

  2. BeforeEndToEndIteration

  3. BuildNumberOverrideTarget

  4. InitializeEndToEndIteration

  5. BeforeInitializeWorkspace

  6. CoreInitializeWorkspace

  7. AfterInitializeWorkspace

  8. BeforeClean

  9. CoreClean

  10. AfterClean

  11. InitializeBuild

  12. BeforeGet

  13. CoreGet

  14. AfterGet

  15. BeforeLabel

  16. CoreLabel

  17. AfterLabel

  18. BeforeCompile

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

  20. BeforeCompileConfiguration

  21. CoreCompileConfiguration (para cada solução de compilação)

  22. BeforeCompileSolution

  23. CoreCompileSolution

  24. AfterCompileSolution

  25. AfterCompileConfiguration

  26. AfterCompile

  27. BeforeGetChangesetsAndUpdateWorkItems

  28. CoreGetChangeSetsAndUpdateWorkItems

  29. AfterGetChangesetsAndUpdateWorkItems

  30. BeforeTest

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

  32. BeforeTestConfiguration

  33. CoreTestConfiguration

  34. AfterTestConfiguration

  35. AfterTest

  36. GenerateDocumentation

  37. BeforeDropBuild

  38. CoreDropBuild

  39. AfterDropBuild

  40. 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