Partager via

Présentation des fichiers de configuration de Team Foundation Build

  • Article

Cette rubrique explique les fichiers de configuration utilisés par le modèle de mise à niveau. Pour plus d'informations sur le modèle de mise à niveau, consultez Définir une build à l'aide du modèle de mise à niveau. Les fonctionnalités utilisées pour produire ces fichiers, telles que l' Assistant Création de fichier de projet MSBuild, sont uniquement disponibles dans Visual Studio Team System 2008.

Lors du traitement d'une build de modèle de mise à niveau, Team Foundation Build utilise le moteur MSBuild. Le processus est contrôlé par un jeu de fichiers XML qui correspondent au schéma de fichier projet MSBuild. Les éléments suivants de ces fichiers XML sont importants pour le processus de génération :

  • Élément cible   L'élément Target définit le mode de génération du projet. Les éléments Target contiennent un jeu des tâches que MSBuild exécute séquentiellement. Pour plus d'informations sur les cibles, consultez Cibles de MSBuild.

  • Élément Task   L'élément Task spécifie le code qui s'exécute pendant le processus de génération. Pour plus d'informations sur les tâches, consultez Tâches MSBuild.

    MSBuild contient une collection de tâches courantes qui peuvent être utilisées pour personnaliser le processus de génération. Pour plus d'informations, consultez Référence des tâches MSBuild.

  • Élément UsingTask   L'élément UsingTask spécifie l'assembly qui contient les tâches utilisées dans le processus de génération.

Les fichiers de script MSBuild peuvent importer d'autres fichiers de script. Par exemple, vous pouvez définir une configuration commune dans un fichier puis l'inclure dans d'autres configurations. Pour plus d'informations, consultez Comment : utiliser la même cible dans plusieurs fichiers projet.

Trois fichiers contrôlent le processus Team Foundation Build :

  • Microsoft.TeamFoundation.Build.targets

    Ce fichier définit le jeu de tâches et de cibles par défaut inclus dans Team Foundation Build. Par exemple, Clean, DropBuild et Compile. Chaque cible contient les tâches à appeler pour cette cible particulière. Certaines cibles de ce fichier dépendent d'autres cibles pour former une chaîne de cibles à exécuter dans un ordre particulier. Par exemple, la cible Compile dépendant de la cible BeforeCompile, toutes les tâches définies dans la cible BeforeCompile sont exécutées avant la cible Compile. Toutes les cibles définies dans ce fichier ne sont pas nécessairement exécutées dans chaque build. Par exemple, les builds de bureau n'exécutent pas la cible Clean.

    Le fichier Microsoft.TeamFoundation.Build.targets est fourni avec Visual Studio Application Lifecycle Management et se trouve dans le répertoire <racine>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild\. Une seule copie de ce fichier est disponible par ordinateur et elle est partagée par toutes les builds qui s'exécutent sur cet ordinateur.

    Important

    Ne modifiez pas le fichier Microsoft.TeamFoundation.Build.targets. En cas modification, chaque définition de build sera affectée. Pour personnaliser des définitions de build, modifiez le fichier TfsBuild.proj qui leur est associé.

  • TfsBuild.proj

    Il s'agit du fichier de configuration principal de Team Foundation Build. Il peut être associé à une seule définition de build ou bien être partagé par plusieurs définitions de build. Ce fichier stocke les paramètres de configuration que vous fournissez dans l'Assistant Création de fichier de projet MSBuild. Ceux-ci incluent le projet d'équipe, le type d'élément de travail créé en cas d'arrêt de génération, ainsi que la configuration et les solutions à générer. L'Assistant Création de fichier de projet MSBuild crée ce fichier lorsque vous créez un fichier projet pour une nouvelle définition de build. Pour plus d'informations, consultez Créer une définition de build de base. Ce fichier importe Microsoft.TeamFoundation.Build.targets et il est transmis à MSBuild. Toute modification apportée à ce fichier affecte les générations de toutes les définitions de build associées. Ce fichier est stocké par défaut dans le contrôle de code source sous le dossier $\MonProjet\TeamBuildTypes\DéfinitionBuild, où MonProjet désigne le nom du projet d'équipe et DéfinitionBuild désigne le nom de la définition de build. Vous pouvez également stocker ce fichier dans un emplacement différent en le spécifiant dans la boîte de dialogue Définition de build.

    Le fichier TfsBuild.proj inclut des exemples d'utilisation dans le texte de commentaire. Ces exemples incluent comment appeler des cibles personnalisées dans l'élément SolutionToBuild et comment passer des propriétés personnalisées à d'autres éléments.

  • TfsBuild.rsp

    Il s'agit d'un fichier vide généré par l'Assistant Création de fichier de projet MSBuild. Il peut être utilisé pour spécifier un journal personnalisé ou substituer les propriétés MSBuild. Pour plus d'informations, consultez Fichiers réponse MSBuild.

Cibles, propriétés et tâches

Les rubriques suivantes décrivent les cibles, tâches et propriétés par défaut qui sont définies dans Microsoft.TeamFoundation.Build.targets.

  • Cibles Team Foundation Build personnalisables
    Répertorie les cibles définies dans Microsoft.TeamFoundation.Build.targets que vous pouvez substituer en écrivant des tâches personnalisées. Cette rubrique inclut des exemples qui illustrent comment personnaliser le processus de génération.

  • Propriétés Team Foundation Build personnalisables
    Répertorie les propriétés par défaut définies dans Microsoft.TeamFoundation.Build.targets que vous pouvez substituer dans le fichier TfsBuild.proj. Cette rubrique inclut également des exemples.

  • Tâches de Team Foundation Build
    Répertorie les tâches par défaut définies dans Microsoft.TeamFoundation.Build.targets que vous pouvez modifier dans le fichier TfsBuild.proj pour personnaliser vos définitions de build. Cette rubrique inclut également des exemples.