Partager via

Propriétés Team Foundation Build personnalisables

  • Article

Mise à jour : novembre 2007

Les propriétés MSBuild sont des paires clé-valeur que vous pouvez utiliser pour configurer vos générations. Pour plus d'informations, consultez Propriétés MSBuild.

Le fichier Microsoft.TeamFoundation.Build.targets définit plusieurs cibles, tâches et propriétés MSBuild pour Team Foundation Build. Vous pouvez modifier ces propriétés dans le fichier TFSBuild.proj pour :

  • passer des valeurs aux tâches et aux cibles Team Foundation Build

  • substituer certaines actions de génération

Pour plus d'informations sur le fichier TFSBuild.proj, consultez Présentation des fichiers de configuration de Team Foundation Build.

Dans ce document :

Personnalisation de générations VC++

Propriétés utilisées pour personnaliser des tâches

Propriétés qui peuvent être substituées

Le tableau suivant répertorie les propriétés définies pour Team Foundation Build. Vous pouvez les substituer dans le fichier TfsBuild.proj pour personnaliser le processus de génération. Pour plus d'informations, consultez Comment : personnaliser le groupe d'éléments SolutionToBuild.

Propriété

Description

CustomPropertiesForClean

Définissez cette propriété pour passer des valeurs personnalisées à chaque solution lorsque Team Foundation Build appelle la cible Clean.

CustomPropertiesForBuild

Définissez cette propriété pour passer des valeurs personnalisées à chaque solution lorsque Team Foundation Build appelle sa cible par défaut (habituellement Build).

SkipClean

Définissez cette propriété pour ignorer la cible CoreClean.

IncrementalGet

Attribuez à cette propriété la valeur true pour exécuter une commande Get incrémentielle. Il s'agit d'une propriété de commodité qui attribue à CleanCompilationOutputOnly la valeur true, à SkipInitializeWorkspace la valeur true et à ForceGet la valeur false.

IncrementalBuild

Attribuez à cette propriété la valeur true pour réaliser une génération incrémentielle. Il s'agit d'une propriété de commodité qui attribue à SkipClean la valeur true, à SkipInitializeWorkspace la valeur true et à ForceGet la valeur false.

CleanCompilationOutputOnly

Attribuez à cette propriété la valeur true pour supprimer uniquement les assemblys intermédiaires du répertoire des sources pendant l'exécution de la cible CoreClean. Si cette propriété a la valeur false, tout le répertoire des sources est supprimé pendant l'exécution de la cible CoreClean.

SkipGetChangesetsUpdateWorkItems

Attribuez à cette propriété la valeur true pour ignorer l'association d'ensembles de modifications et mettre à jour les éléments de travail pour les générations réussies.

SolutionRoot

Définissez cette propriété pour qu'elle pointe sur la racine du dossier des sources sur l'ordinateur de build.

BinariesRoot

Définissez cette propriété pour qu'elle pointe sur la racine du dossier des fichiers binaires sur l'ordinateur de build.

LabelComment

Définissez cette propriété pour spécifier le commentaire utilisé par la tâche Label.

LabelName

Définissez ce nom d'étiquette pour spécifier le nom utilisé par la tâche Label. Par défaut, le nom d'étiquette a la valeur $(BuildNumber) dans la cible InitializeEndToEndIteration.

OutDir

Définissez cette propriété pour spécifier l'emplacement des fichiers de sortie dans le répertoire de travail de build.

UpdateAssociatedWorkItemsOnBuildBreak

Attribuez à cette propriété la valeur true pour mettre à jour les éléments de travail associés même pour une génération rompue.

StopOnFirstFailure

Attribuez à cette propriété la valeur true pour arrêter le nettoyage, la compilation et/ou le test au premier échec rencontré pendant l'exécution de la génération.

SkipGet

Définissez cette propriété pour ignorer la cible CoreGet.

SkipLabel

Définissez cette propriété pour ignorer la cible CoreLabel.

SkipInitializeWorkspace

Définissez cette propriété pour ignorer la cible CoreInitializeWorkspace.

SkipInvalidConfigurations

Attribuez à cette propriété la valeur false pour générer une erreur au lieu d'un avertissement lorsque l'utilisateur se heurte à une configuration non valide.

SkipPostBuild

Définissez cette propriété pour ignorer la collecte d'ensembles de modifications et d'éléments de travail associés.

SkipDropBuild

Définissez cette propriété pour ignorer la cible CoreDropBuild.

SkipWorkItemCreation

Définissez cette propriété pour ignorer la cible CoreCreateWorkItem.

CustomizableOutDir

Attribuez à cette propriété la valeur true si vous voulez empêcher que Team Foundation Build ne définisse le répertoire OutDir pour chaque solution. Notez que vous pouvez utiliser la propriété TeamBuildPublishDir pour récupérer la valeur que Team Foundation Build aurait affecté à PublishDir si CustomizablePublishDir avait la valeur false.

CustomizablePublishDir

Attribuez à cette propriété la valeur true si vous voulez empêcher que Team Foundation Build ne définisse le répertoire PublishDir pour chaque solution. Notez que vous pouvez utiliser la propriété TeamBuildPublishDir pour récupérer la valeur que Team Foundation Build aurait affecté à PublishDir si CustomizablePublishDir avait la valeur false.

Personnalisation de générations VC++

Team Foundation Build prend en charge également la personnalisation de la génération des projets Visual C++. Vous pouvez utiliser les propriétés suivantes pour définir les propriétés correspondantes de la tâche VCBuild utilisée par MSBuild pour générer les projets Visual C++. Pour plus d'informations, consultez VCBuild, tâche.

Propriété Team Build

Propriété de la tâche VCBuild

Description

VCBuildAdditionalLibPaths

AdditionalLibPaths

Spécifie des chemins d'accès supplémentaires pour rechercher des bibliothèques avant les chemins d'accès de la variable d'environnement LIB (correspond à l'option LIBPATH de LINK.exe).

VCBuildAdditionalOptions

AdditionalOptions

Spécifie des options de ligne de commande supplémentaires qui n'ont pas de paramètre de tâche dédié.

VCBuildToolPath

ToolPath

Spécifie l'emplacement à partir duquel la tâche VCBuild charge le fichier exécutable sous-jacent (VCBuild.exe).

VCBuildUseEnvironment

UseEnvironment

Attribuez à ce paramètre la valeur true pour utiliser des variables d'environnement pour les options PATH, INCLUDE, LIBS et LIBPATH. Sinon, attribuez-lui la valeur false. Cette propriété correspond à l'option /useenv de VCBuild.exe. Pour plus d'informations, consultez /useenv.

AdditionalVCOverrides

Aucune

Utilisez cette propriété pour spécifier des options supplémentaires pour les fichiers de feuille de propriétés VCBuild générés par Team Foundation Build et spécifiés dans la propriété Override de la tâche VCBuild.

Propriétés utilisées pour personnaliser des tâches

Chaque tâche Team Foundation Build par défaut contenue dans le fichier Microsoft.TeamFoundation.Build.targets inclut également un jeu de propriétés qui peuvent être utilisées pour personnaliser la tâche. Pour plus d'informations sur les tâches Team Foundation Build, consultez Tâches de Team Foundation Build. Par exemple, la tâche CreateNewWorkItem est définie comme suit :

<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
          TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
          BuildUri="$(BuildUri)"
          BuildNumber="$(BuildNumber)"
          Description="$(WorkItemDescription)"
          TeamProject="$(TeamProject)"
          Title="$(WorkItemTitle)"
          WorkItemFieldValues="$(WorkItemFieldValues)"
          WorkItemType="$(WorkItemType)"
          ContinueOnError="true" />

Pour personnaliser l'élément de travail créé en cas de défaillance de la build, définissez l'élément WorkItemFieldValues dans le fichier TFSBuild.proj :

Remarque :

La procédure suivante suppose que les propriétés Areapath et IterationPath ont également été définies.

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

Voir aussi

Tâches

Comment : utiliser des variables d'environnement dans une génération

Concepts

Présentation des fichiers de configuration de Team Foundation Build