Partager via

Présentation des fichiers de configuration de Team Foundation Build

  • Article

Mise à jour : novembre 2007

Team Foundation Build utilise le moteur MSBuild. Le processus Team Foundation Build 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 Target   L'élément Target définit le mode de génération du projet. Les éléments Target contiennent un jeu de 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.

Deux 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 Team System 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.

    Remarque importante :

    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 Comment : créer une définition de build. 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 $\Projet\TeamBuildTypes\DéfinitionBuild, où Projet 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.

Les fichiers suivants sont également importants :

  • TfsBuildService.exe.config

    Vous pouvez utiliser le fichier TfsBuildService.exe.config pour configurer certains aspects de Team Foundation Build. TfsBuildService.exe.config inclut les paramètres suivants : port à utiliser pour communiquer avec le serveur Team Foundation ; nombre maximal de processus utilisés par Team Foundation Build ; signalement d'erreurs et d'avertissements par projet ou par combinaison plateforme/configuration ; modification du nom des sous-répertoires des sources, fichiers binaires et résultats de test sur l'agent de build. Pour plus d'informations, consultez Comment : modifier les paramètres du fichier TfsBuildService.exe.config.

    Le fichier TfsBuildService.exe.config se trouve dans <racine>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies sur le serveur de couche Application.

  • 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. 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 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 des exemples.

Voir aussi

Tâches

Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée

Autres ressources

Personnalisation de Team Foundation Build

Concepts MSBuild