Comparaison des éléments sous contrôle de version (Team Explorer Everywhere)
Vous pouvez comparer deux versions d'un fichier ou dossier sur un ordinateur local ou un serveur de contrôle de version pour identifier les différences entre ces versions. Par exemple, vous pouvez effectuer cette tâche pour identifier les différences entre deux branches ou entre des versions finales de votre application. Vous pouvez utiliser l'une des nombreuses approches pour comparer des fichiers et des dossiers.
Tâche |
|---|
Comparer les fichiers ou les dossiers : vous pouvez comparer une version d'un fichier texte ou XML ou d'un dossier sur l'ordinateur local avec une version sur le serveur de contrôle de version. Vous pouvez également comparer deux versions qui sont sur l'ordinateur local ou deux versions qui sont sur le serveur de contrôle de version. Vous pouvez effectuer ces comparaisons dans l'interface utilisateur par défaut ou à partir d'une invite de commandes si vous configurez un outil de comparaison externe. |
Configurer des outils de comparaison : si vous configurez un outil externe, vous pouvez comparer des fichiers qui ne sont pas des fichiers texte ou XML, et vous pouvez afficher les résultats dans l'interface utilisateur ou à partir d'une invite de commandes. Vous pouvez également configurer un outil externe si vous le préférez à l'outil par défaut fourni par le Plug-in Team Foundation Server pour Eclipse. .gif "Remarque importante") Important
Vous devez configurer un outil externe avant de pouvoir comparer des fichiers ou des dossiers à partir d'une invite de commandes.
|
Consulter les lignes modifiées dans un seul fichier : en consultant des annotations, vous pouvez afficher non seulement les lignes modifiées dans un fichier mais également le nom de l'utilisateur qui a modifié chaque ligne et la date et l'heure de modification de la ligne. Cet affichage ne fournit pas de comparaison côte à côte. |
Autorisations requises
Pour comparer un élément sur le serveur de contrôle de version avec un élément sur le serveur ou sur un ordinateur local, l'autorisation Lire doit avoir la valeur Autoriser. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Pour comparer deux fichiers sur un ordinateur local, vous n'avez pas besoin d'autorisations dans Visual Studio Team Foundation Server.
Comparer une version sur l'ordinateur local avec la version que vous avez extraite à l'origine du serveur de contrôle de version
Vous pouvez identifier les modifications que vous avez apportées à un ou plusieurs fichiers dans un dossier local puisque vous les avez extraits du contrôle de version.
Pour comparer des fichiers ou des dossiers à l'aide d'Explorateur de projets ou de l'Explorateur de package
- Dans l'Explorateur de package ou l'Explorateur de projets, cliquez avec le bouton droit sur le fichier ou dossier que vous souhaitez comparer, pointez sur Équipe, sur Comparer avec, puis cliquez sur Version de l'espace de travail non modifiée.
Pour comparer un fichier avec sa version d'espace de travail à partir d'une invite de commandes
Ouvrez une fenêtre d'invite de commandes.
Tapez tf diff FileName, puis appuyez sur Entrée.
Remplacez FileName par le chemin d'accès du fichier que vous souhaitez comparer. Pour plus d'informations, consultez Difference, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Avant de commencer cette procédure, vous devez suivre les instructions de Configure an External Tool to Compare Items at a Command Prompt.
Le fichier est comparé avec la version extraite pour votre espace de travail local.
Pour comparer un dossier et son contenu avec les versions d'espace de travail non modifiées à partir une invite de commandes
Ouvrez une fenêtre d'invite de commandes.
Tapez tf diff FolderName /recursive, puis appuyez sur Entrée.
Remplacez FolderName par le chemin d'accès du dossier dont vous souhaitez comparer le contenu. Pour plus d'informations, consultez Difference, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Avant de commencer cette procédure, vous devez suivre les instructions de Configure an External Tool to Compare Items at a Command Prompt.
Les fichiers dans le dossier que vous avez spécifié sont comparés avec les versions extraites pour votre espace de travail local.
Comparer une version sur l'ordinateur local à une version spécifique sur le serveur de contrôle de version
Vous pouvez comparer une version d'un élément sur un ordinateur local avec chacune des versions suivantes de cet élément sur le serveur de contrôle de version :
version la plus récente ;
version qui a un numéro de version spécifique ;
version qui existait à une date spécifique ;
version qui a une étiquette particulière ;
version telle qu'elle existait dans un ensemble de modifications spécifique ;
version extraite pour votre espace de travail local.
Notes
Pour plus d'informations, consultez Compare a version on the local computer to the version that you originally checked out.
Pour comparer des fichiers dans l'Explorateur de package ou l'Explorateur de projets
Dans l'Explorateur de package ou l'Explorateur de projets, cliquez avec le bouton droit sur un des fichiers que vous souhaitez comparer, pointez sur Équipe, sur Comparer avec, puis cliquez sur Autre version.
La boîte de dialogue Sélectionner les éléments à comparer s'affiche.
(Facultatif) Dans la zone Élément sélectionné (source), spécifiez un fichier source différent.
Dans la zone Comparer à (cible), cliquez sur Parcourir pour spécifier le fichier.
Vous pouvez également taper le chemin d'accès et le nom du fichier auquel vous souhaitez comparer le fichier source.
Pour spécifier une version du fichier cible autre que la plus récente, exécutez l'une des tâches suivantes :
Cliquez sur Ensemble de modifications, puis spécifiez le numéro de l'ensemble de modifications ou cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher un ensemble de modifications.
Cliquez sur Date, puis spécifiez une date en la tapant ou en ouvrant le menu et en cliquant sur une date dans le calendrier.
Cliquez sur Étiquette, puis spécifiez une étiquette en la tapant ou en cliquant sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher l'étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Cliquez sur Version de l'espace de travail, puis spécifiez l'espace de travail dont vous souhaitez comparer la version.
Cliquez sur OK pour comparer les fichiers spécifiés.
Pour comparer des dossiers à partir de l'Explorateur du contrôle de code source
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur un des dossiers à comparer, puis cliquez sur Comparer.
La boîte de dialogue Sélectionner les éléments à comparer s'affiche. Par défaut, le dossier spécifié sur le serveur est comparé avec le dossier correspondant sur votre ordinateur local.
Pour spécifier une version du dossier serveur autre que la plus récente, exécutez l'une des tâches suivantes :
Cliquez sur Ensemble de modifications, puis spécifiez le numéro de l'ensemble de modifications ou cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher un ensemble de modifications.
Cliquez sur Date, puis spécifiez une date en la tapant ou en ouvrant le menu et en cliquant sur une date dans le calendrier.
Cliquez sur Étiquette, puis spécifiez une étiquette en la tapant ou en cliquant sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher l'étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Cliquez sur Version de l'espace de travail, puis spécifiez l'espace de travail dont vous souhaitez comparer la version.
Cliquez sur OK pour commencer la comparaison.
Une boîte de dialogue de progression s'affiche pendant que les fichiers sont comparés. La fenêtre Comparaison de texte s'affiche lorsque la comparaison est terminée.
(Facultatif) Dans la fenêtre Comparaison de texte, utilisez les boutons de barre d'outils pour rechercher les différences entre les fichiers.
Pour comparer des dossiers à partir d'une invite de commandes
Ouvrez une fenêtre d'invite de commandes.
Tapez /recursive FirstFolder SecondFolder tf diff , puis appuyez sur Entrée.
Remplacez FirstFolder et SecondFolder par les chemins d'accès des dossiers que vous souhaitez comparer. Pour plus d'informations, consultez Difference, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Avant de commencer cette procédure, vous devez suivre les instructions de Configure an External Tool to Compare Items at a Command Prompt.
Les fichiers dans les dossiers spécifiés sont comparés.
Comparer deux versions sur l'ordinateur local
Dans Team Explorer Everywhere, vous pouvez comparer deux fichiers ou dossiers locaux uniquement à l'aide de l'Explorateur de projets ou de l'Explorateur de package. Vous ne pouvez pas exécuter ce type de comparaison à partir de l'Explorateur du contrôle de code source ou à partir d'une invite de commandes.
Pour comparer des fichiers ou des dossiers à l'aide d'Explorateur de projets ou de l'Explorateur de package
Dans l'Explorateur de package ou l'Explorateur de projets, mettez en surbrillance les deux fichiers ou dossiers que vous souhaitez comparer.
Cliquez avec le bouton droit sur fichier ou dossier, pointez sur Équipe, pointez sur Comparer avec, puis cliquez sur L'un à l'autre.
Comparer deux versions sur le serveur de contrôle de version
Vous pouvez comparer deux versions d'un fichier ou dossier sur le serveur de contrôle de version si, par exemple, vous souhaitez identifier des modifications apportées dans le cadre d'un archivage. De plus, vous pouvez identifier des modifications apportées entre les versions finales de votre application.
Vous pouvez comparer des versions du serveur à partir de l'Explorateur du contrôle de code source ou à partir d'une invite de commandes.
Pour comparer deux versions du serveur à partir de l'Explorateur du contrôle de code source
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur un des fichiers ou dossiers à comparer, puis cliquez sur Comparer.
La boîte de dialogue Sélectionner les éléments à comparer s'affiche. Par défaut, la source a pour valeur un élément sur votre ordinateur local, et la cible a pour valeur l'élément équivalent sur votre serveur de contrôle de version.
Dans la zone Élément sélectionné (source), cliquez sur la flèche Parcourir, cliquez sur Chemin d'accès au serveur, puis cliquez sur Parcourir.
Vous pouvez également spécifier l'élément source en tapant le chemin d'accès du fichier ou dossier source sur le serveur (par exemple, $/DefaultAgile/billing-service).
(Facultatif) Pour spécifier une version de l'élément autre que la plus récente, exécutez l'une des tâches suivantes :
Cliquez sur Ensemble de modifications, puis spécifiez le numéro de l'ensemble de modifications ou cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher un ensemble de modifications.
Cliquez sur Date, puis spécifiez une date en la tapant ou en ouvrant le menu et en cliquant sur une date dans le calendrier.
Cliquez sur Étiquette, puis spécifiez une étiquette en la tapant ou en cliquant sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher l'étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Cliquez sur Version de l'espace de travail, puis spécifiez l'espace de travail dont vous souhaitez comparer la version.
Dans la zone Comparer à (cible), répétez des étapes 2 et 3 pour spécifier l'autre élément que vous souhaitez comparer, puis cliquez sur OK pour démarrer la comparaison.
Une boîte de dialogue de progression s'affiche pendant que les fichiers sont comparés. La fenêtre Comparaison de texte s'affiche lorsque la comparaison est terminée.
(Facultatif) Dans la fenêtre Comparaison de texte, utilisez les boutons de barre d'outils pour rechercher les différences entre les fichiers ou dossiers.
Pour comparer des fichiers à partir d'une invite de commandes
Ouvrez une fenêtre d'invite de commandes.
Tapez tf diff FirstItem SecondItem, puis appuyez sur Entrée.
Remplacez FirstItem et SecondItem par les chemins d'accès des fichiers que vous souhaitez comparer. De plus, vous pouvez spécifier la version des fichiers que vous souhaitez comparer. Par exemple, pour comparer la version du fichier App.java qui était dans l'ensemble de modifications 3200 avec la version qui a l'étiquette « version finale », vous utiliseriez la syntaxe suivante : tf diff App.java;C3200 App.java;Lrelease.
Pour plus d'informations, consultez Difference, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Avant de commencer cette procédure, vous devez suivre les instructions de Configure an External Tool to Compare Items at a Command Prompt.
Les fichiers dans les dossiers spécifiés sont comparés.
Pour comparer des dossiers à partir d'une invite de commandes
Ouvrez une fenêtre d'invite de commandes.
Tapez tf diff FirstItem SecondItem /recursive, puis appuyez sur Entrée.
Remplacez FirstItem et SecondItem par les chemins d'accès des dossiers que vous souhaitez comparer. De plus, vous pouvez spécifier la version des dossiers que vous souhaitez comparer. Par exemple, pour comparer la version du dossier billing-service qui était dans l'ensemble de modifications 3200 avec la version qui a l'étiquette « version finale », vous utiliseriez la syntaxe suivante : tf diff billing-service;C3200 billing-service;Lrelease.
Pour plus d'informations, consultez Difference, commande (contrôle de version Team Foundation) (page éventuellement en anglais).
Important
Avant de commencer cette procédure, vous devez suivre les instructions de Configure an External Tool to Compare Items at a Command Prompt.
Les fichiers dans les dossiers spécifiés sont comparés.
Configurer un outil externe pour comparer des types de fichiers supplémentaires
Pour comparer des fichiers qui ne sont pas des fichiers texte ou XML, vous devez configurer un outil externe compatible avec le Plug-in Team Foundation Server pour Eclipse. Vous pouvez également configurer un outil externe si vous le préférez à l'outil intégré. Vous pouvez utiliser n'importe quel outil de comparaison qui prend en charge, comme arguments de ligne de commande, les chemins complets des deux fichiers que vous souhaitez comparer. Lorsque vous configurez un outil de comparaison, vous spécifiez un ou plusieurs types de fichiers à comparer, le chemin d'accès à l'outil, et la syntaxe de l'outil. Vous spécifiez la syntaxe de l'outil en utilisant des arguments tels que les jetons répertoriés dans le tableau figurant plus loin dans cette rubrique.
Lorsque vous démarrez une comparaison, vous fournissez des valeurs spécifiques, telles que les chemins d'accès des fichiers, pour ces jetons. Le Plug-in Team Foundation Server pour Eclipse appelle ensuite l'outil externe et lui transmet les arguments appropriés pour la syntaxe de l'outil, en remplaçant les jetons par les valeurs que vous avez fournies. L'outil externe effectue ensuite la comparaison réelle, et les résultats s'affichent dans le plug-in.
Lorsque vous spécifiez la syntaxe pour l'outil, vous utilisez un espace blanc pour délimiter les arguments, tels que les jetons. Si un argument inclut un ou plusieurs espaces, vous devez le placer entre guillemets (“”). Si un argument contient un ou plusieurs guillemets, vous devez ajouter un autre guillemet immédiatement après tout guillemet dans l'argument. Par exemple, vous pouvez spécifier l'argument suivant :
"This "" embeds a double quote"
Vous n'avez pas à placer entre guillemets un jeton %, même si sa valeur peut contenir des espaces.
Jetons
Le tableau suivant décrit les jetons que vous utilisez lorsque vous spécifiez la syntaxe d'un outil externe :
Jetons |
Obligatoire ou facultatif |
Description |
|---|---|---|
%1 |
Obligatoire |
Chemin d'accès du fichier source |
%2 |
Obligatoire |
Chemin d'accès du fichier cible |
%5 |
Inutilisé, mais conservé pour la compatibilité avec le client Visual Studio de Visual Studio Team Foundation Server. |
Options de ligne de commande Diff (non utilisées) |
%6 |
Facultatif |
Étiquette du fichier source |
%7 |
Facultatif |
Étiqueter du fichier cible |
Pour configurer un outil de comparaison pour des types de fichiers supplémentaires
Dans le menu Fenêtre, cliquez sur Préférences.
La boîte de dialogue Préférences s'affiche.
Développez le nœud Équipe, développez le nœud Team Foundation Server, puis cliquez sur Outils de comparaison.
Dans le volet de résultats, une liste des outils de comparaison externes configurés s'affiche. Par défaut, aucun outil n'est configuré.
Pour associer un ou plusieurs types de fichiers à un outil de comparaison, procédez comme suit :
Cliquez sur Ajouter.
La boîte de dialogue Ajouter un outil de comparaison externe s'affiche.
Dans la zone Types de fichiers, spécifiez les extensions de nom de fichier pour lesquelles vous souhaitez utiliser cet outil de comparaison.
Vous pouvez spécifier plusieurs extensions, séparées par les virgules, ou utiliser le caractère générique (*) pour spécifier tous les types de fichiers.
Pour associer tous les dossiers à un outil de comparaison, procédez comme suit :
Dans la zone Commande de répertoire, cliquer sur Ajouter.
La boîte de dialogue Ajouter un outil de comparaison externe s'affiche.
Dans la zone Commande, spécifiez la syntaxe de l'outil de comparaison que vous souhaitez utiliser.
Cette syntaxe inclut le chemin d'accès de l'outil de comparaison et les arguments qu'il accepte. Vous pouvez cliquer sur Parcourir pour spécifier le chemin d'accès de l'outil de comparaison.
Cliquez sur OK pour terminer la configuration.
Cliquez sur OK pour fermer la boîte de dialogue Préférences.
Exemple
Par exemple, vous pouvez entrer la syntaxe suivante afin de spécifier l'outil OtherDiff pour les fichiers Java :
C:\Program Files\OtherDiff\otherdiff.exe %1 %2
Vous pouvez également spécifier des étiquettes pour chaque fichier. Si vous ne spécifiez pas ces étiquettes, l'outil affichera les noms des fichiers temporaires, qui peuvent être difficiles à lire.
Pour fournir des étiquettes, vous pouvez spécifier la syntaxe suivante :
C:\Program Files\MyDiff\mydiff.exe %1 –title1=%6 %2 /title2=%7
Si vous spécifiez cette syntaxe, %7 indique l'étiquette pour le fichier %2, et %6 indique l'étiquette pour le fichier %1.
Configurer un outil externe pour comparer des éléments à partir d'une invite de commandes
Si vous souhaitez comparer des fichiers ou des dossiers à partir d'une invite de commandes, vous devez configurer au préalable un outil externe qui comparera les éléments. Par défaut, le Client de ligne de commande interplateforme pour Team Foundation Server n'a aucun outil de comparaison. Lorsque vous configurez un outil, vous spécifiez sa syntaxe en utilisant les jetons répertoriés dans le tableau figurant plus loin dans cette rubrique. Pour obtenir les informations les plus récentes sur la spécification de cette syntaxe, ouvrez une invite de commandes et tapez tf help diff. Lorsque vous utilisez la commande tf diff, vous spécifiez les valeurs passées à l'outil externe à la place des jetons, et l'outil externe compare ensuite les fichiers ou dossiers.
Notes
Vous pouvez abréger tf difference en tf diff.
Lorsque vous configurez un outil externe pour la commande tf diff, vous devez utiliser les jetons %1 et %2 pour représenter les chemins d'accès des fichiers sources et cibles.
Vous pouvez utiliser les jetons %6 et %7 pour spécifier une étiquette explicite pour les fichiers sources et cibles. Si les valeurs de ces jetons peuvent contenir des espaces, vous devez mettre les valeurs entre guillemets.
Exemples
Outil de comparaison |
Valeur de la variable d'environnement TF_DIFF_COMMAND |
|---|---|
GNU diff |
|
GNU diff avec étiquettes |
|
SourceGear DiffMerge |
|
Identifier les modifications de fichier en consultant les annotations
Vous pouvez afficher les annotations d'un fichier sous contrôle de version afin de déterminer qui a effectué des modifications et quelles lignes ont été modifiées dans toutes les versions antérieures du fichier. Lorsque vous consultez des annotations, le fichier s'affiche uniquement dans son état actuel. Vous n'affichez pas une comparaison côte à côte de deux versions du fichier.
Pour exécuter ces procédures, vous devez disposer de l'autorisation Lire avec la valeur Autoriser. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Important
Dans le Plug-in Team Foundation Server pour Eclipse, vous pouvez utiliser la commande Annoter uniquement à partir de l'Explorateur de projets ou de l'Explorateur de package. Vous ne pouvez pas utiliser la commande Annoter à partir de l'Explorateur du contrôle de code source.
Pour consulter des annotations de fichier
Dans l'Explorateur de projets ou l'Explorateur de package, cliquez avec le bouton droit sur le fichier pour lequel vous voulez afficher les annotations, pointez sur Équipe, puis cliquez sur Annoter.
Une fenêtre d'annotation apparaît et affiche le contenu du fichier que vous avez spécifié. Le long du bord gauche de la fenêtre, un canal coloré indique quelles lignes ont été modifiées.
Si vous pointez sur une section du canal coloré, les informations sur l'ensemble de modifications s'affichent dans une info-bulle. Vous pouvez appuyer sur F2 pour ouvrir une fenêtre et parcourir les informations sur l'ensemble de modifications.
Vous pouvez personnaliser l'affichage des informations de révision si vous cliquez avec le bouton droit sur ce dernier, pointez sur Révision, puis cliquez sur une option.
Voir aussi
Autres ressources
Utilisation du contrôle de version (Team Explorer Everywhere)
Résoudre les conflits entre deux fichiers (Team Explorer Everywhere)