Ignorer les ressources de la publication

Lors de la synchronisation de ressources, il vous arrivera fréquemment de ne pas souhaiter publier certaines de ces ressources dans le flux. Deux fonctions Ignorer vous permettent d'indiquer les ressources à exclure des opérations d'intégration et de publication des modifications.

La première est une fonction globale, fournie par le plan de travail. La seconde est la fonction Ignorer de CVS, qui lit le contenu du fichier .cvsignore pour déterminer les éléments à ignorer. Utilisez la fonction globale pour ignorer des fichiers localisés en tout endroit de la hiérarchie du projet. La fonction Ignorer de CVS, qui assure la compatibilité avec les fichiers Ignorer CVS existants, est le plus souvent utilisée pour ignorer des répertoires.

Option 1 : Ajout d'une fonction Ignorer globale

1.

Dans le plan de travail, sélectionnez Fenêtre > Préférences.

2.

Dans la sous-fenêtre de gauche de la boîte de dialogue des préférences, développez Equipe, puis sélectionnez Ressources ignorées. 

3.

Cliquez sur le bouton Ajouter... et tapez *.obj.  Cliquez sur OK dans la boîte de dialogue.  Le modèle à ignorer est activé par défaut. Tous les fichiers objet d'extension *.obj seront exclus des opérations de publication.

4.

Cliquez sur le bouton OK de la boîte de dialogue des préférences.

Option 2 : Ajout d'un fichier Ignorer CVS

Dans chaque répertoire de projet, le client CVS Eclipse trouvera un fichier nommé .cvsignore. Ce fichier est un standard CVS que beaucoup de projets CVS existants contiennent déjà. Il s'agit d'un fichier texte 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.

Par exemple, ajoutez un fichier .cvsignore pour ignorer la totalité du répertoire Project/bin :

1.

Sélectionnez dans la fenêtre Navigateur un projet contenant un répertoire /bin. Dans le menu contextuel, sélectionnez Nouveau > Fichier. Le répertoire bin contient généralement les résultats des compilations de projets, c'est-à-dire des fichiers générés à partir des fichiers source des projets, sans contrôle de version. 

2.

Entrez .cvsignore comme nom de fichier, puis cliquez sur Fin. Le fichier est créé dans le répertoire racine de votre projet. Il doit s'afficher dans la vue Navigateur.

3.

Dans la vue Navigateur, cliquez deux fois sur le fichier pour le modifier.

4.

Entrez bin dans le fichier .cvsignore, puis sauvegardez-le.

5.

Sélectionnez le projet.  Dans le menu contextuel, sélectionnez Equipe > Synchroniser avec le flux.  Vous remarquerez que le répertoire bin ne s'affiche pas en tant que modification sortante. Il est ignoré.

Option 3 : Ignorer les ressources qui s'affichent dans la vue Synchronisation

Imaginons que la première fois où vous avez synchronisé votre projet avec un flux sans définition préalable de masques d'éléments à ignorer, vous avez remarqué que  les fichiers bin/*.obj et *.ba~ s'affichaient en tant que modifications sortantes.  Or, vous ne voulez pas que ces fichiers soient synchronisés. Pour les ignorer alors qu'ils s'affichent déjà en tant que modifications sortantes, procédez comme suit :

1.

Dans la vue Navigateur, supprimez le répertoire /bin et tous les fichiers *.ba~.

2.

Créez un fichier .cvsignore (Fichier > Nouveau > Fichier) dans le répertoire parent de /bin et ajoutez 'bin' dans le fichier.  Sauvegardez le fichier .cvsignore.

3.

Créez l'entrée de fonction Ignorer globale (Fenêtre > Préférences > Equipe > Ressources ignorées) avec les masques *.ba~ suivants.

4.

Recompilez le projet.  Dans la fenêtre du plan de travail, sélectionnez Projet > Générer tout.

5.

Synchronisez avec le flux.  Dans le menu contextuel de la vue Navigateur, sélectionnez Equipe > Synchroniser avec le flux. Le répertoire /bin et les fichiers *.ba~ ne s'affichent pas en tant que modifications sortantes. Publiez le fichier .cvsignore dans le flux  de sorte que d'autres utilisateurs en profitent.

Si vous utilisez une fonction Ignorer globale pour /bin, toute ressource en concordance avec "bin" de tout répertoire du plan de travail est ignorée. En revanche, le fichier .cvsignore n'applique le masque qu'aux ressources situées dans le même répertoire que lui.