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:

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