Propriétés Team Foundation Build personnalisables
Les propriétés MSBuild sont des paires clé-valeur que vous pouvez utiliser pour configurer vos builds. 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 des builds Visual C++
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 Personnaliser le groupe d'éléments SolutionToBuild.
Propriété |
Description |
|---|---|
BinariesRoot |
Définissez cette propriété pour qu'elle pointe sur la racine du dossier des fichiers binaires sur l'ordinateur de build. |
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. |
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é TeamBuildOutDir pour récupérer la valeur que Team Foundation Build aurait affecté à PublishDir si CustomizableOutDir 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. |
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). |
CustomPropertiesForClean |
Définissez cette propriété pour passer des valeurs personnalisées à chaque solution lorsque Team Foundation Build appelle la cible Clean. |
GetAllowUnmapped |
Affectez à cette propriété la valeur false pour faire échouer la build si les fichiers non mappés existent dans un jeu de réservations (pour l'archivage contrôlé et générations privées). |
GetAutoMerge |
Affectez à cette propriété la valeur false pour faire la génération échouer s'il y a des conflits pendant l'opération d'extraction de contrôle de version dans un archivage contrôlé ou génération privée. |
GetNoCIOption |
Affectez à cette propriété la valeur false pour exclure l'insertion de la chaîne * * * NO_CI * * * dans les commentaires d'archivage lors de l'exécution d'une build d'archivage contrôlé. N'oubliez pas que l'affectation à cette propriété de la valeur false provoque la mise en file d'attente des builds d'intégration continue concernées. |
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. |
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. |
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. |
PerformTestImpactAnalysis |
Affectez à cette propriété la valeur false pour désactiver l'analyse de l'impact du test. |
PublishTestResults |
Affectez à cette propriété la valeur false pour ignorer la publication des résultats de tests. |
SkipClean |
Définissez cette propriété pour ignorer la cible CoreClean. |
SkipDropBuild |
Définissez cette propriété pour ignorer la cible CoreDropBuild. |
SkipGet |
Définissez cette propriété pour ignorer la cible CoreGet. |
SkipGetChangesetsAndUpdateWorkItems |
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. |
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 à la place d'un avertissement lorsque l'utilisateur se heurte à une configuration non valide. |
SkipLabel |
Définissez cette propriété pour ignorer la cible CoreLabel. |
SkipPostBuild |
Définissez cette propriété pour ignorer la collecte d'ensembles de modifications et d'éléments de travail associés. |
SkipWorkItemCreation |
Définissez cette propriété pour ignorer la cible CoreCreateWorkItem. |
SolutionRoot |
Définissez cette propriété pour qu'elle pointe sur la racine du dossier des sources sur l'ordinateur de build. |
StopOnFirstFailure |
Attribuez à cette propriété la valeur true pour arrêter le nettoyage, la compilation ou le test au premier échec rencontré pendant l'exécution de la génération. |
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. |
Personnalisation des builds Visual C++
Team Foundation Build prend en charge également la personnalisation de la génération des projets Visual C++ 9.0. 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 Task.
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 |
Aucun |
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 :
Notes
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