Procédure pas à pas : exploration du contrôle de version Team Foundation

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas présente les fonctionnalités d'intégration du contrôle de version dans Visual Studio Team System Team Foundation Server.

Cette procédure pas à pas décrit comment utiliser le contrôle de version dans l'IDE de Visual Studio Team System Team Foundation Server. Vous pouvez notamment apprendre à effectuer les tâches suivantes :

Définir le contrôle de version Team Foundation comme plug-in de contrôle de version par défaut pour Visual Studio Team System Team Foundation Server.
Créer un nouveau projet dans Visual Studio.
Ajouter le projet au contrôle de version pour créer un espace de travail local où vous pourrez stocker, modifier et tester vos fichiers sous contrôle de version.
Archiver votre solution.
Ajouter un fichier au projet soumis au contrôle de version et modifier un projet existant.
Valider toutes les modifications en attente dans l'espace de travail local auprès du serveur de contrôle de version.

Composants requis

Avant de pouvoir exécuter cette procédure pas à pas, vous devez :

Spécifier un serveur Team Foundation Server. Pour plus d'informations sur la façon de se connecter à un serveur Team Foundation Server, consultez Comment : établir une connexion à Team Foundation Server.
Créer ou ouvrir un projet d'équipe existant. Pour plus d'informations, consultez Procédure pas à pas : création d'un nouveau projet d'équipe ou Procédure pas à pas : rejoindre d'un projet d'équipe.

Autorisations requises

Pour exécuter cette procédure pas à pas, vous devez disposer des autorisations Lire et Archiver.

Définir le contrôle de version Team Foundation en tant que plug-in de contrôle de code source

Avant d'utiliser le contrôle de version Team Foundation, vous devez configurer Visual Studio de façon à utiliser le plug-in du contrôle de version Team Foundation comme illustré dans la procédure suivante. Pour plus d'informations, consultez Comment : configurer Visual Studio avec le contrôle de version Team Foundation.

Remarque :
Visual Studio est configuré pour utiliser automatiquement le plug-in contrôle de version Team Foundation lorsque Team Explorer est installé après Visual Studio.

Pour configurer l'utilisation du contrôle de version Team Foundation dans Visual Studio

Dans le menu Outils, sélectionnez Options.
Dans la boîte de dialogue Options, développez Contrôlede code source, puis cliquez sur Sélection du plug-in.
Dans la liste déroulante Plug-in de contrôle de code source actif, sélectionnez Visual Studio Team Foundation Server.
Cliquez sur OK.

Ajouter un projet au contrôle de version

Lorsque vous créez des projets, vous pouvez les ajouter ainsi au contrôle de version pour les gérer dans le contrôle de version Team Foundation. La première fois que vous ajoutez un projet au contrôle de version, le contrôle de version Team Foundation vous crée un espace de travail. Un espace de travail est une copie côté client des fichiers et dossiers sur le serveur Team Foundation. Lorsque vous ajoutez, modifiez, supprimez, déplacez, renommez ou gérez n'importe quel élément sous contrôle de version, vos modifications sont conservées sur le client. Elles sont identifiées comme des modifications en attente dans l'espace de travail sur l'ordinateur local.

L'espace de travail offre un espace isolé où vous pouvez écrire et tester votre code. Vos changements n'affectent pas la stabilité des sources archivées. Vous n'êtes pas affecté par les modifications effectuées par vos coéquipiers. Les modifications en attente sont isolées dans un espace de travail jusqu'à ce que vous les validiez sur le serveur Team Foundation en les archivant.

Vous pouvez créer plusieurs espaces de travail sur votre ordinateur pour chaque serveur Team Foundation. Pour plus d'informations, consultez Utilisation des espaces de travail du contrôle de version.

Pour créer une nouvelle solution et un nouveau projet

Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez Visual C# dans le volet Types de projets.
Dans le volet droit, cliquez sur Application Windows Forms.
Dans la zone Nom, tapez MyWindowsApp, puis tapez un chemin d'accès dans la zone Emplacement.
Activez la case à cocher Ajouter au contrôle de code source, puis cliquez sur OK.
Dans la zone Ajouter la solution au contrôle de code source, sélectionnez le projet d'équipe que vous souhaitez utiliser pour cette procédure pas à pas.
Cliquez sur OK.

Vous pouvez également ajouter des solutions et des projets à partir de la ligne de commande ou dans le menu Visual Studio. Toutefois, cette méthode d'ajout de projets et de solutions ne les lie pas. La liaison active les fonctionnalités de contrôle de version. Cela inclut les diverses icônes de contrôle de version indicatrices d'état de l'Explorateur de solutions. Pour plus d'informations, consultez Comment : lier et annuler la liaison de projets et de solutions, Add, commande et Comment : ajouter au contrôle de version des fichiers et des dossiers non liés au projet ou à la solution.

Fenêtre Modifications en attente

La fenêtre Modifications en attente fournit des informations sur l'état des modifications en attente dans votre espace de travail. Utilisez-le pour garder une trace des informations associées à vos modifications telles que les éléments de travail et notes d'archivage pertinents. Vous pouvez utiliser le menu Affichage pour accéder à la fenêtre Modifications en attente. Pour plus d'informations, consultez Utilisation des fenêtres Archiver et Modifications en attente.

Remarque :
Utilisez la version la plus récente de toutes les sources pertinentes du serveur et compilez votre code pour vérifier qu'il se génère sans erreur avant d'archiver les modifications en attente.

Ensuite, vous devez utiliser la fenêtre Modifications en attente pour archiver vos nouveaux fichiers de solution sous contrôle de version.

Pour archiver les modifications en attente de la solution sous contrôle de version

Dans le menu Générer, cliquez sur Générer la solution pour confirmer que la génération de l'application s'effectue sans erreur.
Si la fenêtre Modifications en attente n'est pas ouverte, dans le menu Affichage, cliquez sur Autres fenêtres, puis sur Modifications en attente.

La fenêtre Modifications en attente répertorie vos fichiers de solution à ajouter. Cela signifie les fichiers sont créés dans votre espace de travail, mais n'ont pas été ajoutés au serveur.
Dans la boîte de dialogue de la fenêtre Modifications en attente, entrez le commentaire « Ajout d'un nouveau projet au contrôle de version » dans la zone Commentaire.
Cliquez sur Archiver pour archiver les modifications en attente d'ajout dans le serveur.

Pour plus d'informations, consultez Modifications en attente et Comment : archiver les modifications en attente. Pour plus d'informations, consultez Envoi de modifications au serveur du contrôle de version.

Modifier le projet soumis au contrôle de version

Le contrôle de version fait partie intégrante du développement de Visual Studio. Par exemple, lorsque vous ajoutez un fichier à un projet soumis au contrôle de version, Visual Studio extrait silencieusement le fichier du projet et le met à jour automatiquement.

Lorsque vous ajoutez un fichier à un projet soumis au contrôle de version, Visual Studio suppose que vous souhaitez modifier le fichier avant de le mettre à la disposition de vos coéquipiers. Par conséquent, les fichiers ajoutés récemment ne sont pas archivés automatiquement. Ils sont traités comme des ajouts en attente de contrôle de version. Lorsque vous archivez explicitement vos modifications non validées, vous créez un ensemble de modifications dans le serveur

Pour ajouter un fichier à un projet soumis au contrôle de version

Cliquez avec le bouton droit sur le projet dans l'Explorateur de solutions, cliquez sur Ajouter, puis sur Classe.
Dans la boîte de dialogue Ajouter un nouvel élément, cliquez sur Ajouter pour ajouter Class1.cs à votre projet.

Class1.cs apparaît avec les autres fichiers projet dans la fenêtre Modifications en attente et son type de modification est ajouter. Dans l'Explorateur de solutions, vous pouvez voir que l'icône de signal du projet est passée d'un verrou bleu à une coche rouge. Cette icône indique que le fichier projet est extrait. Notez que Class1.cs apparaît avec un symbole plus (+). Cela indique un ajout en attente.

Les fichiers sont extraits automatiquement et silencieusement quand vous décidez de modifier un fichier projet archivé.

Pour modifier un fichier existant dans un projet soumis au contrôle de version

Dans l'Explorateur de solutions, dans le dossier Propriétés, double-cliquez sur AssemblyInfo.cs.
Ajoutez une nouvelle directive using telle que using System.IO.Ports; au fichier dans l'éditeur de code.

Notez que Team Foundation extrait AssemblyInfo.cs automatiquement lorsque vous commencez à le modifier. Dans l'Explorateur de solutions, son icône de signal est modifiée en coche. Le système ajoute le fichier à la liste de fichiers sources dans la fenêtre Modifications en attente.

Synchroniser votre espace de travail avec la version du serveur la plus récente

Vous utilisez l'opération Obtenir la dernière version pour que les fichiers de votre espace de travail restent synchronisés avec la version la plus récente du serveur. Si vous effectuez une synchronisation et une génération avant chaque archivage, vous éviterez les interruptions de génération d'intégration. Une génération s'interrompt lorsque vous et un autre utilisateur archivez des modifications qui n'entrent pas en conflit mais qui sont mutuellement incompatibles et empêchent votre application de compiler.

Pour obtenir du serveur la version la plus récente pour votre espace de travail et effectuer une génération

Cliquez avec le bouton droit sur la solution dans l'Explorateur de solutions, puis cliquez sur Obtenir la dernière version (Récursif).
Dans le menu Générer, cliquez sur Générer la solution pour confirmer que la génération de l'application s'effectue sans erreur.

Archiver vos modifications en attente sur le serveur

Après avoir vérifié que votre application se génère avec la version la plus récente, vous pouvez archiver vos modifications dans le contrôle de version Team Foundation et rendre le projet visible pour vos coéquipiers.

Remarque :
Si votre application ne se génère pas car vous n'avez pas eu le temps de la tester ou si vous souhaitiez faire réviser votre code par un autre développeur, vous pouvez réserver vos modifications au lieu de les archiver. Pour plus d'informations, consultez Utilisation des jeux de réservations du contrôle de version.

Vous pouvez archiver des modifications en attente des façons suivantes :

À l'aide du sous-menu Contrôle de code source du menu Fichier.
En cliquant avec le bouton droit sur un fichier extrait dans l'Explorateur de solutions ou l'Explorateur du contrôle de code source.
En cliquant sur Archiver dans la fenêtre Modifications en attente.

Pour archiver toutes les modifications en attente sur le serveur

Dans le menu Affichage, cliquez sur Autres fenêtres, puis cliquez sur Modifications en attente.
Dans la fenêtre Modifications en attente, tapez un commentaire dans la zone Commentaire pour expliquer la nature de vos modifications.

Par exemple, tapez « directive using ajoutée » et, comme motif, « pour activer les appels à la classe Directory ».
Ouvrez le canal Éléments de travail et sélectionnez les éléments de travail qui s'appliquent à vos modifications en attente.

Pour plus d'informations, consultez Comment : associer des éléments de travail à des ensembles de modifications.

Ouvrez le canal Notes d'archivage et ajoutez les commentaires des notes d'archivage du Vérificateur de code, du Vérificateur de la sécurité et du Vérificateur des performances.

Remarque :
Les notes d'archivage peuvent être configurées comme des champs obligatoires par un administrateur. Elles doivent être remplies pendant le processus d'archivage. Les champs obligatoires sont indiqués par la couleur grisée dans l'arrière-plan de la zone de texte.

Pour plus d'informations sur la création de notes d'archivage et de transitions d'élément de travail personnalisées, consultez Procédure pas à pas : personnalisation des stratégies et notes d'archivage.

Cliquez sur Archiver.

Le processus d'archivage Team Foundation Server est conçu pour faciliter la tâche des utilisateurs individuels et l'extensibilité de l'équipe. Pour optimiser la convivialité, la fenêtre Modifications en attente suppose implicitement que vous souhaitez archiver toutes les modifications. Toutefois, vous pouvez facilement exclure des modifications en attente spécifiques du processus d'archivage. L'archivage applique généralement des jeux de modifications connexes et non des modifications individuelles. Inversement, lorsque vous archivez à partir de l'Explorateur de solutions ou du menu Fichier, Visual Studio suppose que vous souhaitez seulement archiver des modifications de l'élément sélectionné. Lorsque vous sélectionnez un conteneur de fichier, tel qu'un projet ou une solution, vous sélectionnez cet élément et les éléments qu'il contient pour l'archivage.

Un administrateur Team Foundation Server peut associer un jeu de stratégies d'archivage personnalisées à un projet d'équipe pour s'assurer que tous les archivages respectent des instructions ou des spécifications particulières.

Chaque membre de l'équipe peut créer des éléments de travail pour suivre les défauts des produits ou les demandes de fonctionnalité. Il peut associer un élément de travail à un projet spécifique. Lorsque vous terminez un élément de travail, vous pouvez l'associer aux modifications sources en le marquant comme tel sur le canal Éléments de travail dans la fenêtre Modifications en attente. Lorsque vous associez des éléments de travail à des modifications de source, vous impliquez votre responsabilité et garantissez un suivi attentif de l'état du travail.

Enfin, vous et votre équipe pouvez ajouter des notes pertinentes et cohérentes à chaque archivage. Le modèle de processus utilisé pour créer le projet d'équipe détermine la forme et le contenu de vos notes d'archivage. L'administrateur Team Foundation Server peut personnaliser le modèle de votre équipe. Les catégories de notes d'archivage peuvent inclure les éléments suivants : impact sur les performances, spécifications de documentation, instructions de test et instructions de génération.

Processus d'archivage

Lorsque vous cliquez sur Archiver, le système regroupe les fichiers sources sélectionnés et toutes les notes d'archivage et éléments de travail que vous avez spécifiés dans la fenêtre Modifications en attente. Le contrôle de version Team Foundation télécharge ensuite ce paquet sur le serveur Team Foundation et valide le paquet comme un nouvel ensemble de modifications. Un ensemble de modifications est un ensemble de révisions de fichier, de notes d'archivage, d'éléments de travail associés et de métadonnées de contrôle de version qui est stocké sur le serveur en tant qu'entité unique facile à gérer. Pour plus d'informations, consultez Utilisation des ensembles de modifications du contrôle de version.

Deuxièmement, tous les éléments de travail qui sont inclus dans l'ensemble de modifications sont mis à jour pour contenir des liens vers l'ensemble de modifications récemment créé.

Ensuite, les éléments de travail sont passés dans un flux de travail en fonction des règles de traitement prédéfinies qui existent. Par exemple, votre équipe peut définir une règle qui remplace automatiquement l'état "Actif" d'un bogue par l'état "Résolu" si son sous-état est "Correctif disponible" lorsque vous archivez le bogue. Les règles de traitement et le flux de travail sont créés par le modèle de processus qui a été utilisé pour créer le projet d'équipe. Toutefois, l'administrateur Team Foundation Server peut personnaliser les règles et le flux de travail. Pour plus d'informations, consultez Personnalisation des modèles de processus.

Enfin, le contrôle de version Team Foundation génère une notification par courrier électronique pour tous les membres de l'équipe qui souhaitent des notifications d'archivage.

Étapes suivantes

Après avoir effectué les étapes de cette procédure pas à pas, vous pouvez en apprendre davantage sur les fonctionnalités avancées dans le contrôle de version Team Foundation. Pour plus d'informations, consultez Procédure pas à pas : fonctionnalités avancées du contrôle de version. Cette procédure pas à pas vous indique comment créer une branche, fusionner et appliquer des étiquettes aux éléments de contrôle de version.

Voir aussi

Partager via