Propriedades do personalizáveis Team Foundation Build
MSBuildas propriedades são pares de key–value, você pode usar para configurar compilações. Para obter mais informações, consulte Propriedadesdo MSBuild.
O arquivo de Microsoft.TeamFoundation.Build.targets define várias MSBuild destinos, tarefas e propriedades de Team Foundation Build. Você pode modificar essas propriedades no arquivo TFSBuild para:
Passar valores para Team Foundation Build tarefas e destinos
Substituir certas ações de compilação
Para obter mais informações sobre o arquivo de TFSBuld.proj, consulte Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation.
Neste documento
Personalizar o Visual C++ cria.
Propriedades usadas para personalizar tarefas
Propriedades que podem ser substituídas.
A tabela a seguir lista as propriedades que são definidas para Team Foundation Build. Você pode substituí-los no arquivo TFSBuild para personalizar o processo de compilação. Para obter mais informações, consulte Personalizar o grupo de itens SolutionToBuild.
Propriedade |
Descrição |
|---|---|
BinariesRoot |
Defina essa propriedade para apontar para a raiz da pasta no computador de compilação de binários. |
CleanCompilationOutputOnly |
Defina esta propriedade como true para excluir apenas os conjuntos intermediários 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. |
CustomizableOutDir |
Definir essa propriedade true Quando você deseja evitar Team Foundation Build de definir OutDir para cada solução. Observe que você pode usar a propriedade TeamBuildOutDir para recuperar o valor Team Foundation Build seriam atribuídas a PublishDir se CustomizableOutDir foi definido como false. |
CustomizablePublishDir |
Definir essa propriedade true Quando você deseja evitar Team Foundation Build de definir o diretório PublishDir para cada solução. Observe que você pode usar a propriedade TeamBuildPublishDir para recuperar o valor Team Foundation Build seriam atribuídas a PublishDir se CustomizablePublishDir foi definido como false. |
CustomPropertiesForBuild |
Definir essa propriedade para passar valores personalizados em cada solução quando Team Foundation Build chama este destino padrão (geralmente Build). |
CustomPropertiesForClean |
Definir essa propriedade para passar valores personalizados em cada solução quando Team Foundation Build chamadas de Clean de destino. |
GetAllowUnmapped |
Defina esta propriedade como false para fazer a compilação falhar se não mapeado arquivos existem em um shelveset (para gated check-in e compilações particulares). |
GetAutoMerge |
Definir essa propriedade false para fazer a compilação falhar se houver conflitos durante a versão controle obter a operação em um check-in gated ou compilação particular. |
GetNoCIOption |
Defina esta propriedade como false para excluir a inserção da *** NO_CI *** seqüência de caracteres no check-in comentários ao executar um gated check-in build. Esteja ciente que definir essa propriedade como false será afetado de causa integração contínua de compilações sejam enfileiradas. |
IncrementalBuild |
Definir essa propriedade true para fazer uma compilação incremental. Esta é uma propriedade de conveniência que define SkipClean como true, SkipInitializeWorkspace para truee ForceGet para false. |
IncrementalGet |
Definir essa propriedade true fazer get incremental. Esta é uma propriedade de conveniência que define CleanCompilationOutputOnly como true, SkipInitializeWorkspace para truee ForceGet para false. |
LabelComment |
Definir essa propriedade para definir o comentário usado pelo Label de tarefas. |
LabelName |
Definir esse nome de rótulo para definir o nome usado pelo Label de tarefas. Por padrão, o nome de rótulo é definido para $(BuildNumber) na InitializeEndToEndIteration de destino. |
OutDir |
Defina essa propriedade para definir o local dos arquivos de saída no diretório de trabalho de compilação. |
PerformTestImpactAnalysis |
Definir essa propriedade false para desativar a análise de impacto de teste. |
PublishTestResults |
Definir essa propriedade false para ignorar publishing test results. |
SkipClean |
Definir essa propriedade para ignorar o CoreClean de destino. |
SkipDropBuild |
Definir essa propriedade para ignorar o CoreDropBuild de destino. |
SkipGet |
Definir essa propriedade para ignorar o CoreGet de destino. |
SkipGetChangesetsAndUpdateWorkItems |
Definir essa propriedade true para ignorar a associação de conjuntos de alterações e atualizar itens de trabalho para compilações bem-sucedida. |
SkipInitializeWorkspace |
Definir essa propriedade para ignorar o CoreInitializeWorkspace de destino. |
SkipInvalidConfigurations |
Definir essa propriedade false para gerar um erro em vez de um aviso quando o usuário encontra uma configuração inválida. |
SkipLabel |
Definir essa propriedade para ignorar CoreLabel de destino. |
SkipPostBuild |
Defina essa propriedade para ignorar a coleta changesets associados e itens de trabalho. |
SkipWorkItemCreation |
Definir essa propriedade para ignorar o CoreCreateWorkItem de destino. |
SolutionRoot |
Defina essa propriedade para apontar para a raiz da pasta fontes no computador de compilação. |
StopOnFirstFailure |
Definir essa propriedade true para interromper a limpeza, compilação ou teste na primeira falha encontrada durante a execução de compilação. |
UpdateAssociatedWorkItemsOnBuildBreak |
Definir essa propriedade true a atualização dos itens de trabalho associados mesmo para uma compilação interrompida. |
Personalizar o Visual C++ cria.
Team Foundation Buildtambém suporta a personalização a criação de Visual C++ 9.0 projetos. Você pode usar as seguintes propriedades para definir as propriedades correspondentes na VCBuild tarefa usada por MSBuild para criar Visual C++ projetos. Para obter mais informações, consulte VCBuild Task.
Propriedade de compilação de equipe |
Propriedade da tarefa VCBuild |
Descrição |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
Especifica os caminhos adicionais para procurar pelas bibliotecas antes que os caminhos de variáveis de ambiente LIB são pesquisados (corresponde à opção LIBPATH para o link. exe). |
VCBuildAdditionalOptions |
AdditionalOptions |
Especifica opções de linha de comando adicionais que não têm parâmetros da tarefa dedicado. |
VCBuildToolPath |
ToolPath |
Especifica o local de onde o VCBuild tarefa carrega o arquivo executável subjacente (vcbuild. exe). |
VCBuildUseEnvironment |
UseEnvironment |
Defina como true para usar variáveis de ambiente para o caminho, INCLUSÃO, BIBLIOTECAS e LIBPATH. Caso contrário, defina-o como false. Essa propriedade corresponde do /useenv opção para VCBuild.exe. Para obter mais informações, consulte /useenv. |
AdditionalVCOverrides |
Nenhum |
Use esta propriedade para especificar opções adicionais para o VCBuild folha de tarefa (s) geradas por Team Foundation Build e especificado na propriedade de substituição do VCBuild de tarefas. |
Propriedades usadas para personalizar tarefas
Cada padrão Team Foundation Build tarefas no arquivo Microsoft.TeamFoundation.Build.targets também inclui um conjunto de propriedades que você pode usar para personalizar a tarefa. Para obter mais informações sobre Team Foundation Build tarefas, consulte Tarefas do Team Foundation Build. Por exemplo, o CreateNewWorkItem tarefa é definida como segue.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Para personalizar o item de trabalho é criado em caso de falha de compilação, defina a WorkItemFieldValues no arquivo TFSBuild:
.gif "Observação") Observação |
|---|
A seguir pressupõe que o Areapath e IterationPath Propriedades também foram definido. |
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>
Consulte também
Tarefas
How to: Usar variáveis de ambiente em uma compilação
Conceitos
Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation