Propriedades personalizáveis Team Foundation compilação

[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 as propriedades são pares chave–valor você pode usar para configurar compilações. Para obter mais informações, consulte Propriedades do MSBuild.

O arquivo Microsoft.TeamFoundation.compilação.targets define vários MSBuild destinos, tarefas e propriedades para Team Foundation Build. Você pode modificar essas propriedades no arquivo TFSBuild.proj para:

• Passar valores para Team Foundation Build destinos e tarefas

• Substituir certas ações de construção

Para obter mais informações sobre o arquivo TFSBuld.proj, consulte Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation.

Neste documento

Personalização do VC ++ compilações

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 substitui-los no arquivo TfsBuild.proj para personalizar o processo de compilação.Para obter mais informações, consulte Como: Personalizar o agrupar de Item SolutionToBuild.

Propriedade	Descrição
CustomPropertiesForClean	conjunto Essa propriedade para passar valores personalizados para cada solução quando Team Foundation Build chamadas a Clean destino.
CustomPropertiesForBuild	conjunto Essa propriedade para passar valores personalizados para cada solução quando Team Foundation Build chama o destino padrão (normalmente Build).
SkipClean	conjunto Essa propriedade para ignorar o CoreClean destino.
IncrementalGet	conjunto Esta propriedade como true Para fazer um get incremental. Esta é uma propriedade de conveniência que define CleanCompilationOutputOnly trueSkipInitializeWorkspace para truee ForceGet para false.
IncrementalBuild	Defina esta propriedade como true Para fazer uma compilação incremental. Esta é uma propriedade de conveniência que define SkipClean trueSkipInitializeWorkspace para truee ForceGet para false.
CleanCompilationOutputOnly	conjunto Esta propriedade como true Para excluir apenas os conjuntos intermediários do diretório de fontes durante o CoreClean execução de destino. Se essa propriedade for conjunto para false, o diretório de fontes inteiro será excluído durante CoreClean execução de destino.
SkipGetChangesetsUpdateWorkItems	conjunto Esta propriedade como true para ignorar a associação de changeconjuntos e atualização dos itens de trabalho para compilações bem-sucedidas.
SolutionRoot	conjunto essa propriedade para apontar para a raiz da pasta fontes no compilação computador.
BinariesRoot	conjunto essa propriedade para apontar para a raiz da pasta binários no compilação computador.
LabelComment	Defina esta propriedade para conjunto o comentário usado pelo Label tarefa.
LabelName	conjunto este nome de rótulo para conjunto o nome usado pelo Label tarefa.  Por padrão, o nome de rótulo é definido como $(BuildNumber) na InitializeEndToEndIteration destino.
OutDir	Defina esta propriedade para conjunto o local dos arquivos de saída no diretório de trabalho de compilação.
UpdateAssociatedWorkItemsOnBuildBreak	conjunto Esta propriedade como true Para actualizar itens de trabalho associados, mesmo para uma compilação interrompida.
StopOnFirstFailure	conjunto Esta propriedade como true Para interromper a limpeza, compilação e/ou teste na primeira falha encontrada durante a execução de compilação.
SkipGet	conjunto Essa propriedade para ignorar o CoreGet destino.
SkipLabel	conjunto Essa propriedade para ignorar CoreLabel destino.
SkipInitializeWorkspace	conjunto Essa propriedade para ignorar o CoreInitializeWorkspace destino.
SkipInvalidConfigurations	conjunto Esta propriedade como false para gerar um erro, em vez de um aviso quando o usuário encontra uma configuração inválido.
SkipPostBuild	conjunto Essa propriedade para ignorar changeconjuntos associado e itens de trabalho de coleta.
SkipDropBuild	conjunto Essa propriedade para ignorar o CoreDropBuild destino.
SkipWorkItemCreation	conjunto Essa propriedade para ignorar o CoreCreateWorkItem destino.
CustomizableOutDir	conjunto Esta propriedade como true Quando você desejar impedir Team Foundation Build de conjunto seletiva OutDir para cada solução. Observe que você pode usar a propriedade TeamBuildPublishDir para recuperar o valor Team Foundation Build seria atribuiu a PublishDir se era CustomizablePublishDir conjunto para false.
CustomizablePublishDir	conjunto Esta propriedade como true quando desejar impedir que Team Foundation Build de conjunto seletiva diretório PublishDir para cada solução. Observe que você pode usar a propriedade TeamBuildPublishDir para recuperar o valor Team Foundation Build seria atribuiu a PublishDir se era CustomizablePublishDir conjunto para false.

Personalização do VC ++ compilações

Team Foundation Build também oferece suporte a criação de personalização Visual C++ projetos. Você pode usar as seguintes propriedades para conjunto propriedades de correspondentes de VCBuild usado por tarefa MSBuild Para criar Visual C++ projetos. Para obter mais informações, consulte Tarefa VCBuild.

Propriedade de compilação de equipe	Propriedade 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 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	conjunto para true Para usar variáveis de ambiente para caminho, INCLUDE, com BIBLIOTECAS e LIBcaminho. Caso contrário, conjunto-o para false. Esta propriedade corresponde à /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 tarefa folha arquivos gerados por Team Foundation Build e especificado na propriedade de substituir a VCBuild tarefa.

Propriedades usadas para personalizar tarefas

Cada padrão de Team Foundation Build tarefa no arquivo Microsoft.TeamFoundation.compilação.targets também inclui um conjunto de propriedades que você pode usar para personalizar a tarefa. Para obter mais informações sobre o Team Foundation Build tarefas, consulte Equipe Foundation compilação tarefas. Por exemplo, a CreateNewWorkItem tarefa é definida sistema autônomo a seguir.

<!-- 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, conjunto o WorkItemFieldValues no arquivo TFSBuild.proj:

Observação:
A seguir pressupõe que o Areapath e IterationPath propriedades também foram definidas.

<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

Como: 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