Exclusion des ressources du projet Eclipse du contrôle de version
Si vous avez installé le Plug-in Team Foundation Server pour Eclipse sur votre ordinateur local, Eclipse détectera automatiquement les ressources nouvelles ou modifiées dans les projets, et le Plug-in Team Foundation Server pour Eclipse ajoute ces ressources à sa liste de modifications en attente. Les ressources dérivées d'une autre ressource, telle que les fichiers de sortie du processus de génération, ne sont généralement pas ajoutées à la liste de modifications en attente. Toutefois, certaines configurations de build, telles que celles qui exécutent des étapes de génération externes, peuvent créer des ressources qui sont dérivées sans qu'Eclipse en ait connaissance. Pour empêcher ces ressources de devenir des ajouts en attente dans le contrôle de version, vous pouvez spécifier deux ensembles de filtres pour déterminer quelles ressources doivent être exclues du contrôle de version :
Ressources ignorées - une page dans la boîte de dialogue Préférences
Fichier .tpignore – un fichier à la racine d'un projet Eclipse
Ressources ignorées
Dans Eclipse 3.0, vous pouvez spécifier des ressources à ignorer à l'aide de la page Ressources ignorées sous la catégorie de préférence Équipe. Cette page contient une liste des caractères génériques qui s'appliquent aux ressources du projet, et les ressources correspondantes ne sont pas ajoutées à la liste de modifications en attente. Le Plug-in Team Foundation Server pour Eclipse effectue tout d'abord un test sur cette liste afin que vous puissiez l'utiliser à la place du fichier .tpignore dans de nombreuses circonstances. Toutefois, ces préférences ne peuvent pas être partagées facilement avec d'autres membres de l'équipe. Chaque membre de l'équipe doit configurer des Préférences ignorées pour chaque espace de travail Eclipse sur son ordinateur local. De plus, ces préférences correspondent uniquement au dernier segment d'un chemin d'accès aux ressources, à savoir le nom de fichier ou de répertoire à la fin. Par conséquent, vous pouvez préférer utiliser le fichier .tpignore.
Pour modifier les Ressources ignorées
Dans le menu Fenêtre, cliquez sur Préférences.
La boîte de dialogue Préférences s'affiche.
Dans la liste de catégories, développez le nœud Équipe et cliquez sur Ressources ignorées.
Effectuez une ou plusieurs des tâches suivantes :
Pour ignorer un modèle qui s'affiche dans la liste Modèles ignorer, activez la case à cocher qui correspond au modèle.
Pour cesser d'ignorer un modèle qui s'affiche dans la liste Modèles ignorer, désactivez la case à cocher qui correspond au modèle.
Pour ajouter un modèle à la liste Modèles ignorer, cliquez sur Ajouter un modèle, puis spécifiez le modèle que vous souhaitez ajouter.
Les cases à cocher de tous les nouveaux modèles sont activées par défaut.
Cliquez sur OK pour enregistrer les modifications apportées.
Fichier .tpignore
Vous pouvez spécifier un fichier nommé .tpignore à la racine du répertoire d'un projet Eclipse. Le Plug-in Team Foundation Server pour Eclipse est vérifié chaque fois qu'il examine une ressource Eclipse. Si la nouvelle ressource correspond à un modèle du fichier, elle n'est pas ajoutée à la liste de modifications en attente. Si la ressource ne correspond pas à l'un de ces modèles, elle est ajoutée à la liste de modifications en attente. Vous pouvez ajouter manuellement des fichiers qui correspondent aux modèles d'exclusion à l'aide du Client de ligne de commande interplateforme pour Team Foundation Server.
Vous n'avez pas besoin de redémarrer Eclipse lorsque vous modifiez le fichier .tpignore. Vos modifications sont prises en compte lorsque l'événement de ressource suivant se produit. Le plug-in charge également automatiquement les modifications apportées à ce fichier si une nouvelle version de ce fichier est récupérée du contrôle de version.
Par défaut, les noms de fichiers qui commencent par un point ne s'affichent pas dans l'Explorateur de package ; par conséquent, vous devrez peut-être utiliser un outil autre qu'Eclipse pour créer, modifier ou supprimer le fichier .tpignore. Vous pouvez également modifier vos filtres d'Explorateur de package pour afficher les noms de fichiers qui commencent par un point. Une fois que vous avez créé un fichier .tpignore, vous pouvez l'ajouter au contrôle de version afin que les autres développeurs qui utilisent le plug-in puissent utiliser vos modèles. Il n'est pas nécessaire d'ajouter le fichier .tpignore au contrôle de version pour l'utiliser sur votre ordinateur local. Pour plus d'informations sur le format du fichier .tpignore, consultez Format du fichier .tpignore.
Pour que le Plug-in Team Foundation Server pour Eclipse commence à ajouter automatiquement les ressources découvertes à la liste de modifications en attente, supprimez ou transformez en commentaire la ou les lignes du fichier .tpignore qui correspondent aux ressources que vous souhaitez ajouter.
Fonctionnement des recherches de correspondances
Les modèles dans le fichier .tpignore sont des expressions régulières Java. Les correspondances ne respectent pas la casse sur les systèmes d'exploitation dont le système de fichiers ne respecte pas la casse et respectent la casse sur les systèmes d'exploitation dont le système de fichiers respecte la casse.
Lorsque le plug-in teste un chemin d'accès aux ressources Eclipse pour un répertoire par rapport à une expression régulière dans le fichier .tpignore, le plug-in vérifie que le chemin d'accès se termine toujours par une barre oblique (/) avant que le test ne soit exécuté. Cela permet de simplifier vos expressions régulières lorsque vous souhaitez faire correspondre un répertoire. Les chemins d'accès aux ressources de fichier ne se terminent jamais par une barre oblique. Tous les chemins d'accès aux ressources commencent par une barre oblique, et il est important de s'en souvenir lorsque vous écrivez vos modèles.
Format du fichier .tpignore
Le fichier .tpignore est un fichier texte. Chaque ligne est une ligne de commentaire ou une ligne de modèle. Chaque ligne de modèle contient une seule expression régulière Java. Le chemin d'accès d'une ressource Eclipse découverte récemment qui correspond à un modèle dans le fichier .tpignore n'est pas ajouté à la liste de modifications en attente. Les espaces blancs de début et de fin sur chaque ligne sont ignorés lorsque les expressions sont lues à partir du fichier .tpignore.
Notation BNF (Backus-Naur Form)
<.tpignore> ::= { <line> }
<line> ::= <comment-line> | <pattern-line> <EOL>
<comment-line> ::= "#" <ignored-text>
<pattern-line> ::= <java-regular-expression>
Exemple
Vous pouvez utiliser le fichier .tpignore suivant :
# Lines that begin with #, like this one, are ignored.
.*/core
.*\.class
.*/[^/]+\.class
/some/path/README
/output/.*
/bin/
Chaque ligne est décrite comme suit :
La première ligne affiche un commentaire qui sera ignoré. Un fichier .tpignore peut contenir zéro, une ou plusieurs lignes de commentaire.
La deuxième ligne affiche une expression régulière qui correspondra à tout chemin d'accès de ressource Eclipse pour un fichier qui se termine par les caractères « /core », notamment /core, /bin/core et /some/long/path/core. La syntaxe d'expression régulière « .* » signifie « faire correspondre à zéro, une ou plusieurs occurrences d'un caractère ». Le reste de la ligne spécifie les caractères littéraux à faire correspondre. L'expression Resource /bin/core/main.c ne correspondrait à rien, car il existe des caractères supplémentaires dans le chemin d'accès de la ressource après la partie littérale de l'expression /core. Elle ne correspondra pas aux répertoires, car tous les répertoires se terminent par une barre oblique.
La troisième ligne affiche une expression régulière qui correspondra à un chemin d'accès aux ressources Eclipse pour un fichier qui se termine par les caractères « .class ». Le point dans l'extension doit faire l'objet d'une séquence d'échappement car il a une signification spéciale dans la syntaxe d'expression régulière Java (il correspond à n'importe quel caractère). Cette expression correspondrait aux fichiers nommés /Program.class ou /some/long/path/Program.class. Elle ne correspondra pas aux répertoires, car tous les répertoires se terminent par une barre oblique.
La quatrième ligne affiche une expression régulière qui correspondra à un chemin d'accès aux ressources Eclipse pour un fichier qui se termine par les caractères « .class » et qui comprend au moins un caractère avant le point dans le dernier segment du chemin d'accès. Comme dans la troisième ligne, le point dans l'extension doit faire l'objet d'une séquence d'échappement. La syntaxe d'expression [^/] signifie « faire correspondre à tous les caractères dans ce groupe, et ce groupe contient tous les caractères à l'exception de la barre oblique ». Cela permet à l'expression de correspondre à /some/long/path/File.class mais pas à /some/long/path/.class. Elle ne correspondra pas aux répertoires, car tous les répertoires se terminent par une barre oblique.
La cinquième ligne affiche une expression régulière qui n'utilise aucune syntaxe spéciale mais est encore évaluée en tant qu'expression régulière. Elle correspond simplement à un fichier nommé exactement « /some/path/README ». Elle ne correspondrait pas à la ressource de répertoire « /some/path/README/ », car les chemins d'accès aux ressources de répertoire se terminent toujours par une barre oblique.
La sixième ligne affiche une expression régulière qui correspond à la ressource de répertoire « /output/ » et un de ses enfants, qu'il s'agisse de fichiers ou répertoires. Elle ne correspondra pas à un fichier « /output », car le modèle requiert une barre oblique finale, que les chemins d'accès de fichier n'ont pas.
La septième ligne affiche une expression régulière qui correspond uniquement à la ressource de répertoire « /bin/ » et pas à ses enfants. Elle ne correspond pas à un fichier « /bin », car elle spécifie une barre oblique finale qui est uniquement présente dans les chemins d'accès de répertoire.
Voir aussi
Autres ressources
Copie de fichiers sous contrôle de version (Team Explorer Everywhere)
Archiver des modifications en attente (Team Explorer Everywhere)
Application d'attributs FileSystem d'Unix aux fichiers sous contrôle de version