Java-Buildpfad

Die Optionen auf dieser Seite geben die Einstellungen für den Buildpfad eines Java-Projekts an. Sie finden diese Seite über die Projekteigenschaften (Projekt > Eigenschaften > Java-Buildpfad) aus dem Kontextmenü eines erstellten Projekts oder im Menü Datei der Workbench.

Der Buildklassenpfad besteht aus einer Liste von Pfaden, die für den Compiler während des Buildvorgangs für das Projekt sichtbar ist.

Registerkarte 'Quelle'

Quellenordner sind Ordner in der obersten Ebene der Projekthierarchie. Sie stellen das Stammverzeichnis von Paketen dar, die .java-Dateien enthalten. Der Compiler setzt diese Dateien in .class-Dateien um, die dann in den Ausgabeordner geschrieben werden.

Quellenordner ermöglichen die Strukturierung des Projekts, z. B. die Trennung der Tests von der Anwendung in zwei Quellenordner. Innerhalb eines Quellenordners kann mithilfe von Paketen eine detailliertere Strukturierung erreicht werden.

Jeder Quellenordner kann einen Ausschlussfilter definieren und auf diese Weise angeben, welche Ressourcen innerhalb des Ordners für den Compiler nicht sichtbar sein sollen.

In Quellenordnern vorhandene Ressourcen werden in den Ausgabeordner kopiert, es sei denn, die Einstellung auf der Benutzervorgabenseite unter Java > Compiler > Build gibt an, dass die Ressource gefiltert wird. Der Ausgabeordner ist für jedes Projekt definiert. Hiervon ausgenommen sind die Fälle, in denen ein Quellenordner einen eigenen Ausgabeordner angibt.

Optionen für Quellenordner:
Option Beschreibung
Ordner hinzufügen Erstellt einen neuen Ordner für Quellen.
Quelle verlinken Erstellt einen neuen Ordner, der mit einer Position außerhalb des Arbeitsbereiches verlinkt.
Bearbeiten Ermöglicht die Änderung des gegenwärtig ausgewählten Quellenordners oder seiner Attribute.
Entfernen Entfernt die ausgewählten Ordner aus dem Klassenpfad. Hiermit werden weder die Ordner noch deren Inhalt gelöscht.
Ausgabeordner für Quellenordner zulassen Blendet das Attribut 'Ausgabeordner' der Quellenordner ein bzw. aus.

Attribute für Quellenordner:
Attribut Beschreibung
Ausschlussfilter Wählt aus, welche Ressourcen für den Compiler nicht sichtbar sein sollen. Details hierzu siehe Einschluss- und Ausschlussmuster.
Ausgabeordner Ist nur verfügbar, wenn die Option Ausgabeordner für Quellenordner zulassen aktiviert ist. Definiert eine spezifische Ausgabeposition für den Quellenordner. Wenn dieses Attribut nicht festgelegt ist, wird der Standardausgabeordner verwendet.
Position für native Bibliothek Definiert den Ordner, der die nativen Bibliotheken enthält (beispielsweise 'dll'- oder 'o'-Dateien), die während der Laufzeit von den Quellen im Quellenordner benötigt werden.

Unten auf dieser Seite können Sie im Feld Standardausgabeordner einen Pfad zu einem Ordnerpfad eingeben, in dem sich die Kompilierungsausgabe für dieses Projekt befinden soll. Die Standardausgabe wird für Quellenordner verwendet, die keinen eigene Ausgabeordner angeben. Wählen Sie mit Durchsuchen eine vorhandene Position im aktuellen Projekt aus.

Registerkarte 'Projekte'

In der Liste Erforderliche Projekte im Buildpfad können Sie Projektabhängigkeiten hinzufügen, indem Sie andere Workbench-Projekte auswählen und zum Buildpfad für dieses neue Projekt hinzufügen.

Wird ein erforderliches Projekt indirekt hinzugefügt, werden alle Klassenpfadeinträge dieses Projekts als 'exportiert' markiert hinzugefügt. Ein Klassenpfadeintrag kann auf den Registerkarten 'Reihenfolge' und 'Exportieren' als exportiert festgelegt werden.

Die hier ausgewählten Projekte werden automatisch in die Liste der Projekte aufgenommen, auf die verwiesen wird. Mit dieser Projektliste wird die Buildreihenfolge festgelegt. Ein Projekt wird stets erst dann gebuildet, nachdem seine referenzierten Projekte gebuildet worden sind.

Aktion Beschreibung
Hinzufügen Fügt ein weiteres Projekt in den Arbeitsbereich zum Buildpfad dieses Projektes hinzu.
Bearbeiten Bearbeitet das Klassenpfadattribut eines erforderlichen Projekts.
Entfernen Entfernt die ausgewählten erforderlichen Projekte aus der Liste.
Attribute für Projekteinträge:
Attribut Beschreibung
Position für native Bibliothek Gibt an, wo sich die native Bibliothek befindet, die für das zu betreibende Projekt erforderlich ist.
Zugriffsregeln Gibt Zugriffsregeln für Projekte an, die in der Bibliothek enthalten sind. Dadurch kann der Inhalt eines Projektes verborgen werden.

Registerkarte 'Bibliotheken'

Auf dieser Seite können Sie Bibliotheken zum Buildpfad hinzufügen.

Die Bibliotheksliste enthält standardmäßig einen Eintrag, der die Java-Laufzeitbibliothek darstellt. Dieser Eintrag verweist auf die JRE, die als Standard-JRE ausgewählt wurde. Die Standard-JRE wird auf der Benutzervorgabenseite unter Java > Debug > Installierte JREs konfiguriert.

Optionen für Registerkarte 'Bibliotheken'
Option Beschreibung
JARs hinzufügen Hiermit können Sie in der Workbench-Hierarchie navigieren und JAR-Dateien auswählen, die zum Buildpfad hinzugefügt werden sollen.
Externe JARs hinzufügen Hiermit können Sie im Dateisystem (außerhalb der Workbench) navigieren und JAR-Dateien auswählen, die zum Buildpfad hinzugefügt werden sollen.
Variable hinzufügen Hiermit können Sie Klassenpfadvariablen zum Buildpfad hinzufügen. Klassenpfadvariablen verweisen indirekt auf JAR-Dateien. Das hat den Vorteil, dass lokale Dateisystempfade in einem Klassenpfad vermieden werden. Dies ist erforderlich, wenn in einem Team auf Projekte gemeinsam zugegriffen wird.
Variablen können auf der Benutzervorgabenseite unter Java > Buildpfad > Klassenpfadvariablen erstellt und bearbeitet werden.
Bibliothek hinzufügen Hiermit können Sie vordefinierte Bibliotheken wie die JRE-Systembibliothek hinzufügen. Solche Bibliotheken können für eine willkürliche Anzahl von Einträgen stehen (diese sind als Kindknoten des Bibliothekknotens sichtbar).
Klassenordner hinzufügen Hiermit können Sie in der Workbenchhierarchie navigieren und einen Klassenordner für den Buildpfad auswählen. Im Auswahldialog können Sie auch einen neuen Ordner erstellen.
Externen Klassenordner hinzufügen Hiermit können Sie im Dateisystem (außerhalb der Workbench) navigieren und einen Klassenpfad für den Buildpfad auswählen. Im Auswahldialog können Sie auch einen neuen Ordner erstellen.
Bearbeiten Hiermit können Sie den gegenwärtig ausgewählten Bibliothekseintrag oder das Eintragsattribut ändern.
Entfernen Entfernt das ausgewählte Element aus dem Buildpfad. Hiermit wird die Ressource nicht gelöscht.
JAR-Datei migrieren Migriert eine JAR-Datei im Buildpfad auf eine neuere Version. Wenn die neuere Version Refactoring-Scripts enthält, wird das im Script gespeicherte Refactoring ausgeführt.

 Für Bibliotheken können die folgenden Attribute definiert sein (die als Kindknoten eines Bibliothekseintrags dargestellt werden):

Attribute für Bibliothekseinträge:
Attribut Beschreibung
Javadoc-Position Gibt an, wo sich die Javadoc-Dokumentation der Bibliothek befindet. Falls dieses Attribut angegeben ist, können Sie die Dokumentation für ein Element dieser Bibliothek durch Drücken der Tasten Umschalt+F2 öffnen.
Quellenzuordnung Gibt an, wo sich die Quelle der Bibliothek befindet.
Position für native Bibliothek Gibt an, wo sich die native Bibliothek befindet, die für die zu betreibende Bibliothek erforderlich ist.
Zugriffsregeln Gibt Zugriffsregeln für Ressourcen an, die in der Bibliothek enthalten sind. Dadurch können Sie den Inhalt einer Bibliothek ausblenden.

Registerkarte 'Sortieren und Exportieren'

In der Liste mit der Reihenfolge für den Buildpfad können Sie auch die Schaltflächen Nach oben und Nach unten klicken, um einen ausgewählten Pfadeintrag in der Reihenfolge des Buildpfads für dieses neue Projekt nach oben oder nach unten zu versetzen.

Markierte Listeneinträge sind als exportiert gekennzeichnet. Exportierte Einträge sind für andere Projekte, die dieses Projekt erfordern, sichtbar. Verwenden Sie die Optionen Alles auswählen und Alles abwählen, um den markierten Status aller Einträge zu ändern. Quellenordner werden stets exportiert und können nicht abgewählt werden.

Zugehörige Konzepte

Buildklassenpfad
Klassenpfadvariablen
Einschluss- und Ausschlussmuster

Zugehörige Referenzinformationen

Häufig gestellte Fragen zu JDT
Benutzervorgaben für Klassenpfadvariablen
Benutzervorgaben für Buildpfad
Benutzervorgaben für Compiler