Tâches de Team Foundation Build
Mise à jour : novembre 2007
Les tâches MSBuild sont contenues dans les cibles. Ces tâches fournissent le code exécuté pendant le processus de génération. MSBuild fournit une bibliothèque de tâches courantes. Pour plus d'informations, consultez Référence des tâches MSBuild.
Le fichier .targets MSBuild pour Team Foundation Build, Microsoft.TeamFoundation.Build.targets, définit plusieurs tâches Team Foundation Build par défaut que vous pouvez personnaliser en définissant les propriétés du fichier TfsBuild.proj. Par exemple, la cible CoreGet inclut une tâche Get qui vous permet de récupérer un ensemble de modifications spécifique pour un type de build. Par défaut, la tâche Get récupère les fichiers les plus récents. Pour plus d'informations sur les fichiers .targets, consultez Fichiers .Targets MSBuild.
Liste des tâches par défaut contenues dans le fichier Microsoft.TeamFoundation.Build.targets
Les tâches suivantes peuvent être personnalisées en modifiant leurs propriétés.
Tâche de Team Foundation Build |
Cible associée |
|---|---|
|
Synchronise les sources sur l'ordinateur de build. Elle déclenche également des événements pour informer le journal de chaque fichier et version récupéré dans l'espace de travail local. |
Get |
|
Étiquette tous les fichiers sources d'un espace de travail spécifié. |
Label |
GenCheckinNotesUpdateWorkItems, tâche Génère la liste de tous les ensembles de modifications et éléments de travail qui ont été créés ou affectés pendant une génération. Les étiquettes sont utilisées pour référencer une build spécifique. |
La cible GetChangeSetsAndUpdateWorkitems est appelée si la génération est exécutée avec succès. La cible GetChangeSetsOnBuildBreak est appelée si la génération échoue. |
|
Crée un élément de travail pour les erreurs se produisant pendant le processus de génération. Met également à jour le champ Found In de l'élément de travail avec un lien vers le numéro de build spécifique. |
CreateWorkItem |
|
Crée un espace de travail sur l'ordinateur de build. |
InitializeWorkspace |
|
Supprime l'espace de travail créé pendant l'exécution de la génération. Les fichiers eux-mêmes ne sont pas supprimés de l'ordinateur de build. Si l'espace de travail spécifié n'existe pas, DeleteWorkspaceTask émet un avertissement. |
InitializeWorkspace |
UpdateBuildNumberDropLocation, tâche Crée un dossier à un emplacement spécifié pour recevoir les fichiers générés. Met à jour également le numéro de build. |
InitializeEndToEndIteration |
|
Exécute un ensemble de tests pendant la génération et en publie les résultats. |
RunTestWithConfiguration |
|
Insère les étapes de génération dans la build. |
None |
|
Donne les valeurs initiales des propriétés de génération. |
InitializeBuildProperties |
|
Définit toutes les propriétés de génération pouvant être définies. |
None |
WorkspaceItemConverterTask, tâche Convertit les éléments serveur du contrôle de version en éléments d'espace de travail locaux et les éléments locaux en éléments serveur du contrôle de version. |
ResolveSolutionPathsForEndToEndIteration et ResolveTestFilesForEndToEndIteration |
Modification des tâches de Team Foundation Build
Pour modifier les tâches définies dans le fichier de définition Microsoft.TeamFoundation.Build.targets, examinez les propriétés de la tâche à modifier et définissez-les dans le fichier TfsBuild.proj de votre type de build Team Foundation Build. La tâche CreateNewWorkItem est définie comme suit.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
BuildId="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Pour personnaliser l'élément de travail créé en cas d'échec de génération, définissez l'élément WorkItemFieldValues dans le fichier TFSBuild.proj :
.gif "Remarque") 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