Procédure pas à pas : configuration de Team Build pour générer un projet d'installation Visual Studio
Mise à jour : novembre 2007
Vous pouvez personnaliser Team Foundation Build en ajoutant des tâches personnalisées ou en utilisant des tâches MSBuild qui sont exécutées à un point spécifié lors du processus de génération. Cette rubrique décrit les étapes requises pour personnaliser une définition de build afin d'utiliser la tâche Exec de MSBuild pour générer un projet d'installation Visual Studio.
Composants requis
Les éléments suivants sont nécessaires pour effectuer cette procédure pas à pas :
Un ordinateur client avec :
Development Edition installé
Team Explorer installé
Une connexion à un serveur Team Foundation Server disponible
Un répertoire local à utiliser comme votre espace de travail
Un projet d'équipe avec :
Une définition de build créée
Un espace de travail pour le contrôle de code source mappé au répertoire local
Pour plus d'informations, consultez Comment : créer un espace de travail mappé. Cette procédure pas à pas utilise l'espace de travail local : C:\DeploymentProjects.
Le contrôle de code source activé
Pour vérifier que Visual Studio est configuré pour utiliser contrôle de version Team Foundation, dans le menu Outils, cliquez sur Options, puis sur Contrôle de code source.
Sélectionnez Visual Studio Team Foundation Server dans la zone de liste Plug-in de contrôle de code source actif.
Un agent de build avec Team Foundation Build installé
Visual Studio doit être installé sur l'agent de build pour pouvoir utiliser la tâche Exec de MSBuild afin d'appeler devenv.exe pour générer un projet d'installation. Pour plus d'informations, consultez Exec, tâche et Commutateurs de la ligne de commande de Devenv.
.gif "Remarque") Remarque : |
|---|
L'agent de build est un ordinateur sur lequel les builds sont exécutées. Pour plus d'informations, consultez Comment : créer et gérer des agents de build. |
Autorisations requises
Pour effectuer cette procédure pas à pas, 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 créer un projet d'équipe, vous devez disposer de l'autorisation Créer de nouveaux projets avec la valeur Autoriser, et vous devez être membre du groupe Administration centrale de SharePoint dans Windows SharePoint Server et disposer des autorisations Gestionnaire de contenu dans SQL Reporting Services.
Vous devez avoir une autorisation d'installation sur l'ordinateur sur lequel vous exécutez le programme d'installation créé par Team Foundation Build.
Création d'un projet Visual Studio
Les procédures contenues dans cette procédure pas à pas créent une application Windows Forms C# simple qui est utilisée comme exemple pour configurer Team Foundation Build afin de générer un projet d'installation Visual Studio.
Pour créer une application Windows Forms Visual Studio
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Fichier.
Dans la boîte de dialogue Nouveau projet, sélectionnez Visual C# dans le volet Types de projets. Dans le volet Modèles, sélectionnez Application Windows Forms.
Tapez HelloWorldTest dans la zone Nom. Dans la zone Emplacement, tapez C:\DeploymentProjects ou ouvrez l'espace de travail local que vous avez sélectionné pour votre projet d'équipe.
Cliquez sur OK.
HelloWorldTest apparaît dans l'Explorateur de solutions, et Form1.cs apparaît dans le Concepteur Windows Forms.
Dans le menu Affichage, cliquez sur Boîte à outils pour afficher la liste de contrôles.
Déplacez un contrôle Button dans votre formulaire.
Double-cliquez sur le nouveau bouton pour ouvrir l'éditeur de code.
Visual C# a inséré une méthode appelée button1_Click.
Ajoutez le code suivant à la méthode :
private void button1_Click(object sender, EventArgs e) { MessageBox.Show("Hello World!"); }Dans le menu Fichier, cliquez sur Enregistrer tout pour enregistrer vos modifications.
Dans le menu Générer, cliquez sur Générer HelloWorldTest pour générer votre solution et vérifier qu'aucune erreur de génération ne se produit.
Pour créer un projet de déploiement
Sélectionnez la solution HelloWorldTest dans l'Explorateur de solutions, et dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
Dans la boîte de dialogue Ajouter un nouveau projet, développez le nœud Autres types de projets dans le volet Types de projets, cliquez sur Configuration et déploiement, puis cliquez sur Projet d'installation dans le volet Modèles. Dans la zone Nom, tapez HelloWorldTestInstaller.
Cliquez sur OK pour fermer la boîte de dialogue.
Le projet est ajouté à l'Explorateur de solutions et l'Éditeur du système de fichiers s'ouvre.
Pour ajouter l'application HelloWorldTest au programme d'installation
Sélectionnez HelloWorldTestInstaller dans l'Explorateur de solutions. Dans l'Éditeur du système de fichiers, cliquez avec le bouton droit sur le nœud Dossier d'application, pointez sur Ajouter puis cliquez sur Fichier.
Dans la boîte de dialogue Ajouter des fichiers, ouvrez l'emplacement de HelloWorldTest.exe, sélectionnez-le, puis cliquez sur Ouvrir.
Son emplacement dans cette procédure pas à pas est C:\DeploymentProjects\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe. Votre chemin d'accès peut être différent selon l'emplacement de votre espace de travail local.
Dans le menu Fichier, cliquez sur Enregistrer tout pour enregistrer vos modifications.
Dans le menu Générer, cliquez sur Générer HelloWorldTestInstaller pour générer une copie locale du programme d'installation et vérifier qu'aucune erreur de génération ne se produit.
Pour vérifier que le projet d'installation a généré le programme d'installation, ouvrez l'emplacement du fichier de sortie. HelloWorldTestInstaller.msi et setup.exe doivent apparaître dans l'emplacement du fichier de sortie.
Remarque :Pour rechercher le fichier de sortie, cliquez avec le bouton droit sur le projet HelloWorldTestInstaller dans l'Explorateur de solutions, puis cliquez sur Propriétés. Dans la boîte de dialogue Pages de propriétés de HelloWorldTestInstaller, la zone Nom du fichier de sortie contient l'emplacement des fichiers du programme d'installation.
Pour modifier le fichier vdproj pour utiliser Team Foundation Build
Cliquez avec le bouton droit sur le projet HelloWorldTestInstaller dans l'Explorateur de solutions, puis cliquez sur Propriétés. Dans la boîte de dialogue Pages de propriétés de HelloWorldTestInstaller, cliquez sur Gestionnaire de configurations.
Vérifiez que la zone Générer est sélectionnée pour HelloWorldTest et HelloWorldTestInstaller.
Cliquez sur Fermer pour fermer la boîte de dialogue Gestionnaire de configurations, puis sur OK pour fermer la boîte de dialogue Pages de propriétés de HelloWorldTestInstaller.
Dans le menu Fichier, cliquez sur Enregistrer tout pour enregistrer vos modifications.
Localisez le fichier HelloWorldTestInstaller.vdproj.
Son emplacement dans cette procédure pas à pas est C:\DeploymentProjects\HelloWorldTest\HelloWorldTestInstaller. Votre chemin d'accès peut être différent selon l'emplacement de votre espace de travail local.
Cliquez avec le bouton droit sur HelloWorldTestInstaller.vdproj, pointez sur Ouvrir avec, puis cliquez sur Choisir un programme. Dans la boîte de dialogue Ouvrir avec, sélectionnez Bloc-notes dans le volet Programmes, puis cliquez sur OK pour ouvrir HelloWorldTestInstaller dans le Bloc-notes.
Vérifiez que tous les chemins d'accès sont répertoriés comme des chemins d'accès relatifs à l'emplacement des fichiers HelloWorldTestInstaller.vdproj.
Aucun chemin d'accès absolu ne doit être répertorié.
Pour ajouter et archiver HelloWorldTest dans le contrôle de code source Team Foundation
Cliquez avec le bouton droit sur la solution HelloWorldTest dans l'Explorateur de solutions, puis cliquez sur Ajouter la solution au contrôle de code source.
Un signe « + » jaune apparaît à côté de tous les fichiers. Cela indique qu'ils sont en attente d'ajout au contrôle de code source.
Cliquez avec le bouton droit sur la solution HelloWorldTest dans l'Explorateur de solutions, puis cliquez sur Archiver. Dans la boîte de dialogue Archiver - Fichiers sources - Espace de travail : <Nom de l'espace de travail>, faites défiler jusqu'aux fichiers sélectionnés. Désactivez la zone Nom associée à HelloWorldTest.exe, puis cliquez sur Archiver.
Les fichiers sont maintenant archivés dans contrôle de version Team Foundation.
.gif "Remarque importante")
Remarque importante :Assurez-vous que vous désactivez le fichier exécutable car vous configurez Team Foundation Build pour générer un nouveau fichier exécutable.
Modification du fichier TFSBuild.proj
Avant de générer le projet HelloWorldTestInstaller à l'aide de Team Foundation Build, vous devez créer une définition de build ou utiliser une définition de build existante que vous pouvez modifier. Pour plus d'informations, consultez Comment : créer une définition de build. Vous devez modifier le fichier projet TFSBuild.proj associé à votre définition de build pour lui indiquer de générer le projet d'installation.
Pour modifier le fichier TFSBuild.proj pour générer le projet d'installation
Dans le menu Affichage, pointez sur Autres fenêtres, puis cliquez sur Explorateur du contrôle de code source.
Dans l'Explorateur du contrôle de code source, développez votre projet d'équipe dans le volet Dossiers et localisez le fichier TFSBuild.proj que vous avez créé. L'emplacement par défaut est dans le dossier TeamBuildTypes, situé sous votre dossier de projet d'équipe.
Dans le volet d'affichage, sélectionnez le type de build que vous souhaitez utiliser pour générer HelloWorldTest et HelloWorldTestInstaller. Si vous n'avez pas de copie du fichier dans votre espace de travail local, cliquez avec le bouton droit sur le dossier TeamBuildType, puis cliquez sur Obtenir la dernière version.
Cette action rend les fichiers disponibles pour qu'ils puissent être extraits à des fins de modification.
Dans le volet d'affichage, double-cliquez sur votre type de build, cliquez avec le bouton droit sur TFSBuild.proj, puis cliquez sur Extraire pour modification. Dans la boîte de dialogue Extraire, sélectionnez Aucun - Autoriser l'extraction partagée, puis cliquez sur Extraire.
Une coche rouge apparaît en regard du fichier TFSBuild.proj et indique l'état de son contrôle de code source.
Double-cliquez sur le fichier TFSBuild.proj pour l'ouvrir dans l'éditeur XML de Visual Studio.
Ajoutez le code suivant en caractères gras à la fin du fichier TFSBuild.proj, avant de fermer la balise </Project>.
<Target Name="AfterCompile"> <Exec Command=""$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv" "$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" /Build "Debug|Any CPU""/> <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target>Cette commande utilise la tâche exec de MSBuild pour générer le projet d'installation HelloWorldTestInstaller en appelant le programme devenv.exe. Pour plus d'informations, consultez Exec, tâche. La tâche copy de MSBuild permet de copier les fichiers .msi et .exe vers le répertoire de sortie de Team Foundation Build. Pour plus d'informations, consultez Copy, tâche.
La cible AfterCompile est exécutée une fois que Team Foundation Build a terminé l'exécution de la cible CoreCompile, où l'application HelloWorldTest est compilée. Pour plus d'informations sur les noms de cibles, consultez Présentation des fichiers de configuration de Team Foundation Build.
Dans le menu Fichier, cliquez sur Enregistrer pour enregistrer vos modifications, puis fermez le fichier TFSBuild.proj.
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur TFSBuild.proj, puis cliquez sur Archiver les modifications en attente. Si vous le souhaitez, vous pouvez ajouter un commentaire dans la boîte de dialogue Archiver - Fichiers sources - Espace de travail : <nom de l'espace de travail>. Cliquez sur Archiver pour archiver TFSBuild.proj dans le contrôle de code source.
Exécution de la définition de build
Une fois que vous avez modifié le fichier TFSBuild.proj et enregistré les modifications dans contrôle de version Team Foundation, exécutez la définition de build pour générer votre projet de déploiement.
Pour exécuter la définition de build d'équipe
Dans le menu Générer, cliquez sur Mettre en file d'attente une nouvelle build.
Dans la boîte de dialogue Mettre en file d'attente la build "Nom du projet d'équipe", sélectionnez la définition de build que vous souhaitez utiliser, l'agent de build, la priorité dans la file d'attente, puis cliquez sur File d'attente.
Pour plus d'informations, consultez Comment : démarrer ou mettre en file d'attente une définition de build.
Vous pouvez surveiller le processus de génération dans Build Explorer. Pour plus d'informations, consultez Comment : surveiller la progression de la génération.
Dans Build Explorer, cliquez sur le fichier journal sous le titre Résumé. Vérifiez si le fichier journal contient des erreurs.
Remarque :Vous pouvez ignorer sans risque l'avertissement MSB4078 : le fichier projet "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" n'est pas pris en charge par MSBuild et ne peut pas être généré. Le fichier est généré par le programme devenv.exe qui utilise la tâche Exec de MSBuild.
Pour installer le fichier d'installation généré
Localisez l'emplacement cible de build \\<emplacement cible>\Public_build\HelloWorldTestBuild_<numéro de build>\Release.
L'emplacement cible est le même partage de fichiers que l'emplacement du fichier journal et est répertorié sous le titre Résumé dans Build Explorer.
Copiez les fichiers HelloWorldTestInstaller.msi et setup.exe dans un ordinateur où vous êtes membre du groupe de sécurité Administrateur Windows ou vous disposez de l'autorisation Installer avec la valeur Autoriser.
Double-cliquez sur le fichier setup.exe et suivez les instructions de l'Assistant Installation.
HelloWorldTestInstaller.exe est installé sous le chemin d'accès <racine>:\Program Files\Microsoft\HelloWorldTestInstaller.
Accédez à <racine>:\Program Files\Microsoft\HelloWorldTestInstaller.
Pour exécuter l'application, double-cliquez sur le fichier .exe.
Étapes suivantes
Vous pouvez modifier le projet d'installation Visual Studio pour configurer l'Assistant Installation afin d'effectuer des étapes supplémentaires. Pour plus d'informations, consultez Concepts relatifs au déploiement de Windows Installer.
Voir aussi
Tâches
Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée
Autres ressources
Utilisation de définitions de build dans Team Foundation Build