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.
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.
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"/>
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.
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 |
---|---|
|
|
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.
SetBuildBreakProperties
BeforeOnBuildBreak
GetChangesetsOnBuildBreak
BeforeDropBuild
CoreDropBuild
AfterDropBuild
BeforeCreateWorkItem
CoreCreateWorkItem
AfterCreateWorkItem
CoreOnBuildBreak
AfterOnBuildBreak
Consulte também
Conceitos
Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation