Comment : configurer Team Foundation Build pour une génération incrémentielle
Mise à jour : novembre 2007
Une génération incrémentielle réutilise les résultats d'une génération antérieure conservés par Team Foundation Build pour exécuter une génération optimisée en fonctions des modifications effectuées depuis la dernière génération.
Une fois que vous avez créé une définition de build pour les générations incrémentielles, exécutez la première génération. Cela permet de créer l'espace de travail requis et d'obtenir tous les fichiers sources sur l'ordinateur de build.
Composants requis
Avant d'exécuter cette tâche, vous devez avoir les éléments suivants :
Accès au fichier TFSBuild.proj du type de build que vous souhaitez personnaliser.
Chaque définition de build d'équipe est associée à un fichier TFSBuild.proj qui se trouve dans le dossier $/MonProjetD'équipe/TeamBuildTypes/MonNomDeBuild du contrôle de version Team Foundation. MonProjetD'équipe est le nom de votre projet d'équipe. C'est le nœud racine de toutes vos sources de projet d'équipe. MonNomDeBuild est le nom que vous avez donné à votre définition de build. Pour plus d'informations sur la création de types de build Team Foundation Build, consultez Comment : créer une définition de build.
Espace de travail local contenant les fichiers de votre projet d'équipe et les fichiers de build de l'ordinateur local.
Pour plus d'informations, consultez Comment : créer un espace de travail mappé et Comment : obtenir la source de votre projet d'équipe.
Autorisations requises
Pour effectuer cette tâche, les autorisations Administrer une build et Administrer les espaces de travail doivent avoir la valeur Autoriser. Vous devez également disposer des autorisations Archiver et Extraire avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
Obtention d'une copie locale du fichier TFSBuild.proj
Avant de modifier le fichier TFSBuild.proj correspondant à votre définition de build, vous devez obtenir une copie locale.
Pour obtenir une copie locale du fichier TFSBuild.proj
Dans le menu Affichage, sélectionnez Autres fenêtres, puis Explorateur du contrôle de code source.
Dans l'Explorateur du contrôle de code source, cliquez sur Espaces de travail dans la barre d'outils, puis sélectionnez l'espace de travail dans la liste.
Ouvrez un dossier de projet d'équipe contenant votre type de build, puis développez le dossier TeamBuildTypes.
Cliquez avec le bouton droit sur le fichier TFSBuild.proj et sélectionnez Obtenir la dernière version pour copier la version la plus récente du fichier.
Pour plus d'informations, consultez Comment : obtenir la source de votre projet d'équipe.
Définition des propriétés dans le fichier TFSBuild.proj
Pour spécifier une génération incrémentielle, vous devez définir la propriété IncrementalBuild dans le fichier TFSBuild.proj.
Pour définir les propriétés dans le fichier TFSBuild.proj
IncrementalBuild est une propriété de commodité qui attribue à SkipClean la valeur true, à SkipInitializeWorkspace la valeur true et à ForceGet la valeur false.
Lorsque Team Foundation Build exécute une génération complète, il nettoie les fichiers dans le dossier de génération intermédiaire et les dossiers source dans la cible Clean. Dans une génération incrémentielle, cette cible doit être ignorée parce que ces fichiers doivent être intacts pour la génération suivante. Pour ce faire, SkipClean a la valeur true.
Dans le cadre d'une génération complète, Team Foundation Build supprime l'ancienne et recrée un espace de travail pour nettoyer et synchroniser les fichiers sources. Dans une génération incrémentielle, cette cible doit également être ignorée. Pour ce faire, SkipInitializeWorkspace a la valeur true.
Dans la tâche Get, Team Foundation Build récupère de nouveaux fichiers sources par défaut et remplace les fichiers existants dans l'espace de travail de génération. Pour récupérer uniquement les fichiers modifiés, la propriété ForceGet a la valeur false.
Pour attribuer à la propriété IncrementalBuild la valeur true, ajoutez la définition PropertyGroup à la fin du fichier TFSBuild.proj, avant la balise de fermeture </project>.
</ItemGroup> <PropertyGroup> <IncrementalBuild>true</IncrementalBuild> </PropertyGroup> </Project>
Voir aussi
Tâches
Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée
Concepts
Cibles Team Foundation Build personnalisables
Envoi de modifications au serveur du contrôle de version