Ignorer les ressources de la publication

Lors de la synchronisation des ressources, il est possible que vous ne vouliez pas publier toutes les ressources vers le flux.  Deux fonctions permettant d'ignorer des éléments sont disponibles, ainsi l'utilisateur peut indiquer les ressources à exclure des opérations d'intégration des modifications et de publication.

Vous disposez d'une fonction permettant d'ignorer de manière globale, fournie par le plan de travail ainsi que d'une fonction CVS qui lit le contenu d'un fichier spécial .cvsignore afin de déterminer les éléments à ignorer.

Pourquoi ignorer les fichiers lors de la synchronisation ?

Il existe plusieurs fichiers que l'utilisateur qu'un utilisateur peut ne pas pouvoir publier dans le référentiel. Par exemple, des éditeurs externes peuvent créer des fichiers temporaires dans votre projet. La compilation de fichiers .java créé des fichiers .class et de la même façon
un grand nombre d'opérations de compilation génèrenet des fichiers binaires. Ces fichiers lorsqu'ils sont regroupés peuvent être de taille assez importante. De plus, ils peuvent être régénérés lors des compilations, ce qui provoque un grand nombre de modifications sortantes. Généralement, il ne s'agit pas de fichiers qui sont partagés avec d'autres membres d'une équipe ou stockés dans un référentiel.  

Fonction Ignorer globale

Le plan de travail dispose d'une fonction Ignorer globale se trouvant sur la page des préférences de la vue Equipe. Avant d'effectuer une proposition pour l'attribution d'un numéro de version, les noms de fichier des ressources sont mis en parallèle avec une liste de masques de fichier.  Ces masques peuvent contenir les caractères génériques "*" et "?".  Le caractère "*" représente toute série de zéro caractère ou plus  et le caractère "?" représente n'importe quel caractère.  Par exemple, vous pouvez spécifier le masque "*~" pour désigner tout fichier temporaire se terminant par "~".   Les fichiers ou répertoires correspondant à l'un des masques spécifiés sont ignorés lors  des opérations d'intégration des modifications ou de publication. Vous pouvez provisoirement désactiver un masque de fichier à ignorer en le désélectionnant dans la liste ; vous n'êtes pas obligé de le supprimer de la liste.

Les masques de la fonction Ignorer globale sont comparés aux noms de ressources lors de la synchronisation. Il est important de noter que le chemin d'accès au nom de la ressource n'est pas pris en compte dans la comparaison. Par exemple, pour le fichier "/path/to/file.txt", seule la chaîne "file.txt" est mise en correspondance avec les masques.  Cette fonction n'est pas conçue pour définir des chemins d'accès complets mais pour définir des masques globalement applicables.

Fonction Ignorer CVS

Dans chaque répertoire de projet, les clients CVS Eclipse trouvent un fichier nommé ".cvsignore".  Il s'agit d'une norme CVS et beaucoup de projets CVS existants contiennent ce fichier.

Ce fichier texte est constitué d'une liste de fichiers, de répertoires ou de masques. Comme pour la fonction Ignorer globale, les caractères génériques "*" et "?" sont admis dans toute entrée du fichier .cvsignore. Tous les fichiers ou sous-répertoires du répertoire en cours qui correspondent à l'un des masques sont ignorés. Il est important de noter que ce fichier n'a pas la même portée que la fonction Ignorer globale puisqu'il ne s'applique qu'aux fichiers et sous-répertoires du répertoire dans lequel se trouve le fichier .cvsignore. Un projet peut contenir un fichier .cvsignore dans chaque répertoire. Pour plus d'informations, consultez le site  http:\\www.cvshome.org. 

Quand une ressource est-elle ignorée ?

Dès qu'une ressource est sous contrôle de version, il est difficile de l'ignorer. Une ressource passe sous contrôle de version pour la première fois lorsqu'elle ou l'un de ses dossiers parent fait l'objet d'une synchronisation. Avant d'effectuer une synchronisation, vous devez déterminer les fichiers et répertoires à ignorer et les ajouter à la liste appropriée de la fonction Ignorer. Prenons, par exemple, le scénario suivant :

  1. Créez le fichier "fichier.txt".
  2. Synchronisez "fichier.txt" avec le serveur.
  3. Ajoutez "fichier.txt" ou un masque de correspondance dans .cvsignore ou dans la liste de la fonction Ignorer globale.
  4. Modifiez fichier.txt.
  5. Synchronisez "fichier.txt" avec le serveur.
  6. Notez que fichier.txt est répertorié en tant que modification sortante.

Ignorer les ressources qui s'affichent dans la vue Synchronisation

Si vous avez sélectionné l'opération Equipe > Synchroniser avec le flux, mais que vous n'avez pas encore effectué la publication, vous pouvez encore ignorer des ressources. Et ce, en dépit du fait que le plan de travail considère déjà ces fichiers comme étant sous contrôle de version. Vous devez commencer par supprimer les fichiers à ignorer. Cette opération n'est généralement pas problématique car les fichiers ignorés sont, soit des fichiers ignorés, soit des résultats de la compilation des fichiers importants, c'est-à-dire la source. Ajoutez ensuite le masque des fichiers à ignorer via la liste de la fonction Ignorer globale ou CVS. A ce stade, vous pouvez recompiler votre projet de façon à réintégrer les fichiers ignorés, puis synchroniser votre projet avec le flux. Les fichiers seront désormais ignorés.