Chemin de génération Java

Les options de cette page définissent les paramètres du chemin de génération pour un projet Java. L'accès à cette page s'effectue via les propriétés de projet (Projet > Propriétés > Chemin de compilation Java) à partir du menu contextuel sur un projet créé ou du menu Fichier du plan de travail.

Le chemin des classes de génération représente la liste des chemins dont dispose le compilateur lors de la génération du projet.

Onglet Source

Dans la hiérarchie du projet, les dossiers source sont des dossiers de niveau supérieur. Ils représentent la racine des packages contenant des fichiers .java. Le compilateur convertit les fichiers en fichier .class qui seront copiés dans le dossier de sortie.

Les dossiers source permettent de structurer le projet, par exemple en séparant le test et l'application en deux dossiers source. Au sein d'un dossier source, il est possible d'obtenir une structure plus détaillée à l'aide des packages.

Chaque dossier source peut définir un filtre d'exclusion permettant de spécifier les ressources du dossier ne devant pas être visibles pour le compilateur.

Les ressources contenues dans les dossiers source sont copiées dans le dossier de sortie, sauf si le paramètre de la page des préférences Java > Compilateur > Génération indique que la ressource est filtrée. Ce dossier est défini par projet, sauf si un dossier source spécifie un dossier de sortie propre.

Options du dossier source :
Option Description
Ajouter un dossier Permet de créer un dossier pour stocker le code source.
Lier à la source Crée un dossier contenant un lien vers un emplacement situé en dehors de l'espace de travail.
Modifier Permet de modifier le dossier source sélectionné ou l'attribut du dossier source.
Supprimer Supprime les dossiers sélectionnés du chemin d'accès aux classes. Cette opération ne supprime pas les dossiers ni leurs contenus.
Permettre des dossiers de sortie par dossier source Affiche/Masque l'attribut 'dossier de sortie' des dossiers source.

Attributs du dossier source :
Attribut Description
Filtre d'exclusion Sélectionne les ressources qui sont invisibles pour le compilateur. Pour des détails, voir Modèles d'exclusion et d'inclusion.
Dossier de sortie Disponible uniquement si la case Permettre des dossiers de sortie par dossier source est cochée. Définit un dossier source spécifique à l'emplacement de sortie. S'il n'est pas défini, le dossier de sortie par défaut est utilisé.
Emplacement de la bibliothèque native Définit le dossier contenant les bibliothèques natives (par exemple des fichiers 'dll' ou 'o') requises au moment de l'exécution par les sources dans le dossier source.

Dans la partie inférieure de la page, la zone Dossier de sortie par défaut permet d'entrer le chemin d'un dossier où les données de sortie de la génération seront stockées. La sortie par défaut est utilisée pour les dossiers source qui ne spécifient pas de dossier de sortie propre. Utilisez le bouton Parcourir pour sélectionner un emplacement dans le projet en cours.

Onglet Projets

Dans la liste Projets requis dans le chemin de génération, vous pouvez ajouter les dépendances du projet en sélectionnant d'autres projets dans le plan de travail pour les ajouter au chemin de génération pour le nouveau projet.

Si vous ajoutez indirectement un projet requis, toutes les entrées du chemin d'accès aux classes sont considérées comme exportées. Pour indiquer qu'une entrée de chemin d'accès aux classes est exportée, utilisez l'onglet Ordre et Exportation.

Les projets sélectionnés ici sont automatiquement ajoutés à la liste des projets référencés. La liste des projets référencés permet de déterminer l'ordre de génération. Un projet est toujours généré après la génération de ses projets référencés.

Action Description
Ajouter Ajoute un projet de l'espace de travail au chemin de génération de ce projet.
Modifier Modifie l'attribut Chemin de classes d'un projet requis.
Supprimer Supprime les projets requis sélectionnés de la liste.
Attributs d'entrée de projet :
Attribut Description
Emplacement de la bibliothèque native Spécifie l'emplacement de la bibliothèque native nécessaire au fonctionnement du projet.
Règles d'accès Spécifie les règles d'accès au projet contenu dans la bibliothèque. Cette option permet de masquer le contenu d'un projet.

Onglet Bibliothèques

Cette page vous permet d'ajouter des bibliothèques au chemin de génération.

Par défaut, la liste des bibliothèques contient une entrée représentant la bibliothèque d'exécution Java. Elle pointe vers l'environnement JRE sélectionné par défaut. Ce dernier est configuré dans la page des préférences Java > Débogage > JRE installés

Options de l'onglet Bibliothèques :
Option Description
Ajouter des fichiers JAR Permet d'explorer la hiérarchie du plan de travail et de sélectionner les fichiers JAR que vous voulez ajouter au chemin de génération.
Ajouter des fichiers JAR externes Permet d'explorer le système de fichiers (hors du plan de travail) et de sélectionner les fichiers JAR que vous voulez ajouter au chemin de génération.
Ajouter une variable Permet d'ajouter des variables de chemin d'accès aux classes au chemin de génération. Les variables de chemin d'accès aux classes désignent des fichiers JAR et permettent de ne pas indiquer les chemins du système de fichiers local dans un chemin d'accès aux classes. Cela est nécessaire lorsque les projets sont partagés au sein d'une équipe.
Les variables peuvent être créées et modifiées dans la page des préférences Java > Chemin de génération > Variables de chemin d'accès aux classes.
Ajouter une bibliothèque Permet d'ajouter des bibliothèques prédéfinies, telle que la bibliothèque système JRE. De telles bibliothèques peuvent représenter un nombre d'entrées arbitraire (visible en tant que noeud enfant du noeud de la bibliothèque).
Ajouter un dossier de classes Permet d'explorer la hiérarchie du plan de travail et de sélectionner un dossier de classes pour le chemin de génération. La boîte de dialogue de sélection permet également de créer un dossier.
Ajouter un dossier de classes externe Permet d'explorer le système de fichiers (hors du plan de travail) et de sélectionner un dossier de classes pour le chemin de génération. La boîte de dialogue de sélection permet également de créer un dossier.
Modifier Permet de modifier l'entrée de la bibliothèque sélectionnée ou l'attribut de l'entrée.
Supprimer Permet de supprimer l'élément sélectionné du chemin de génération. Cette opération ne supprime pas la ressource.
Migrer le fichier JAR Migre un fichier JAR figurant dans le chemin de génération vers une version plus récente. Si la version plus récente contient des scripts de propagation de modification, les propagations stockées dans le script seront exécutées.

Les bibliothèques présentent les attributs suivants (présentés comme des noeuds enfant des entrées de bibliothèque) :

Attributs d'entrée de bibliothèque :
Attribut Description
Emplacement de la documentation Javadoc Spécifie où la documentation Javadoc de la bibliothèque peut être trouvée. Si cet emplacement est spécifié, enfoncez les touches Maj+F2 sur un élément de la bibliothèque pour ouvrir sa documentation.
Connexion de la source Spécifie l'emplacement où se trouve la source de la bibliothèque.
Emplacement de la bibliothèque native Spécifie l'emplacement de la bibliothèque native nécessaire au fonctionnement de la bibliothèque.
Règles d'accès Spécifie les règles d'accès aux ressources contenues dans la bibliothèque. Cette option permet de masquer le contenu d'une bibliothèque.

Onglet Ordre et exportation

Dans la liste Ordre des chemins de classes de génération, cliquez sur les boutons Haut et Bas pour déplacer l'entrée du chemin sélectionnée vers le haut ou le bas de la liste des chemins de génération de ce projet.

Les entrées cochées sont considérées comme exportées. Les entrées exportées sont disponibles pour les projets requérant le projet. Utilisez les options Sélectionner tout et Désélectionner tout pour modifier l'état de toutes les entrées. Les dossiers source sont toujours exportés et ne peuvent pas être désélectionnés.

Concepts connexes

Chemin des classes de génération
Variables de chemin d'accès aux classes
Modèles d'exclusion et d'inclusion

Référence connexe

Foire aux questions sur JDT
Préférences des variables du chemin d'accès aux classes
Préférences du chemin de génération
Préférences de compilateurs