Feature-Export

Die PDE stellt den Assistenten Feature-Export bereit, mit dem die Features und ihre zugehörigen Plug-ins und Fragmente in ein Format exportiert werden können, das für die Implementierung geeignet ist. Der Assistent verhindert, dass Ant-Scripts angezeigt werden und der Arbeitsbereich durch Ressourcen belegt wird, die während der Buildoperation generiert werden. Der Assistent ist unter Exportassistenten für Features öffnen Datei > Exportieren... > Plug-in-Entwicklung > Implementierbare Features verfügbar.

Featureauswahl

Der Assistent zeigt alle nicht binären Features an, die sich im Arbeitsbereich befinden.

Featureauswahl

Wählen Sie die Features aus, die Sie exportieren wollen. Wenn Sie immer wieder dieselben Features exportieren müssen, können Sie auf die Schaltfläche Arbeitsset auswählen... klicken, um ein Arbeitsset zu definieren.

Features werden rekursiv erstellt; wenn in einem Feature ein anderes Feature enthalten ist, brauchen Sie deshalb nur das Feature der obersten Ebene auswählen, um beide Features zu exportieren.

Ziel

Sie können die Features und ihre zugehörigen Plug-ins in ein Verzeichnis oder in ein komprimiertes Archiv exportieren. Wahlweise können Sie auch die Features in einem ausführbaren Format exportieren und diese in Ihrem gegenwärtig aktiven Eclipse-Host installieren lassen.

Ziel

Wenn Sie einen Export in ein Verzeichnis (die Standardeinstellung) ausführen möchten, werden die Features in das Unterverzeichnis features/ und die Plug-ins in das Unterverzeichnis plugins/ des ausgewählten Verzeichnisses gestellt.

Wenn Sie einen Export in eine Archivdatei ausführen möchten, werden alle Features und Plug-ins in ein einziges komprimiertes Archiv gepackt. Die Stammverzeichnisstruktur in der komprimierten Datei beginnt mit features/ und plugins/.

Wenn Sie sich für das Exportieren und Installieren entscheiden, werden die Features in ausführbarem Format exportiert und es wird ein p2-Repository generiert. Nach dem Export wird eine Installationsoperation zum Installieren der Features ausgeführt. Sie werden aufgefordert, Eclipse neu zu starten, nachdem der Installationsvorgang abgeschlossen worden ist. Zum Deinstallieren der Features müssen Sie die Schaltfläche Installationsdetails im Dialogfenster mit den Produktinformationen (Optionen 'Hilfe > Info über Eclipse SDK') verwenden. Weitere Details hierzu enthält Exportieren und im Host installieren.

Optionen

Optionen

Die Verwendung der Option Quelle exportieren bewirkt, dass sowohl der Quellcode als auch die Binärdateien exportiert werden. Es gibt zwei Möglichkeiten, um die Quelle mit Ihrem exportierten Feature zu packen. Durch die Option Quellenproduktpakete generieren werden die Ant-Befehle zu dem Export hinzugefügt, damit für jedes exportierte Plug-in getrennte Quellenproduktpakete erstellt werden. Weitere Informationen zu Quellenproduktpaketen finden Sie unter dem PDE Build-Eintrag in Einzelne Quellenproduktpakete. Die zweite Option lautet Quelle in exportierte Plug-ins einschließen. Die Auswahl dieser Option bewirkt, dass die Quellendateien in einem Ordner src/ ins Stammverzeichnis der JAR-Datei gepackt werden (wenn der Export in JAR-Format erfolgt). Wenn das Plug-in als unstrukturiertes Verzeichnis gepackt wird, wird der Quellcode in eine komprimierte Quellendatei in das Plug-in-Verzeichnis als gleichgeordnetes Element zur Bibliotheks-JAR-Datei gestellt.

Die Option Als einzelne JAR-Archive packen packt Features und ihre zugehörigen Plug-ins als JAR-Dateien. Wenn die Option nicht ausgewählt ist, werden die Features als unstrukturierte Verzeichnisse exportiert, während ihre zugehörigen Plug-ins so gepackt werden, wie dies in der Markup-Datei feature.xml angegeben ist. Plug-in-Einträge, die mit unpack="false" in feature.xml markiert sind, werden als JAR-Dateien exportiert; andernfalls werden sie als Verzeichnisse exportiert.

Beim Packen als einzelne JAR-Dateien sind zwei zusätzliche Optionen verfügbar. Mit der Option Metadaten-Repository erstellen können Sie auch p2-Metadaten zusammen mit Ihrem exportierten Feature erstellen. Dies ermöglicht, dass das Verzeichnis oder Archiv, in das der Export erfolgt, auch als Repository verwendet werden kann, aus dem p2 Installationen und Aktualisierungen vornehmen kann. Diese Option muss beim Exportieren und Installieren in den aktiven Host aktiviert sein. Die Option Repository kategorisieren ermöglicht, dass das generierte Metadatenrepository nach Kategorien organisiert werden kann. Damit Kategorien erfolgreich erstellt werden können, muss eine gültige Kategorie-XML-Datei angegeben werden, die Daten für die Features enthält, die exportiert werden.

Die Option Ersetzung von Qualifikationsmerkmalen ersetzt einen Wert für das Qualifikationsmerkmalelement in der Version eines Plug-ins oder Features. Die Version muss folgendes Format aufweisen: '<major>.<minor>.<micro>.qualifier'. Beispiel: '3.3.0.qualifier'. Normalerweise stellt das Qualifikationsmerkmal ein Builddatum oder eine Kennung dar.

Mit der Option Als Ant-Script speichern können Sie die Einstellungen der Exportoperation speichern, sodass sie zu einem späteren Zeitpunkt erneut ausgeführt werden kann, ohne wieder den Assistenten verwenden zu müssen. Die Ant-Task wird wie die Exportoperation als asynchroner Job ausgeführt; deswegen kann es ungünstig sein, sie als Bestandteil eines größeren Ant-Scripts zu integrieren.

Binäre Zyklen in Zielplattform berücksichtigen ist eine Option, die steuert, wie die Exportoperation mit Zyklen im Abhängigkeitsdiagramm für ein Plug-in umgeht. PDE Build kann nicht kompilieren, wenn ein Zyklus festgestellt wird. Wenn ein Zyklus jedoch nur binäre Plug-ins der Zielplattform enthält, kann PDE Build die Verarbeitung fortsetzen, wenn diese Option aktiviert ist.

Wenn die Option Im Arbeitsbereich kompilierte Klassendateien verwenden aktiviert ist, werden die von Eclipse kompilierten Binärdateien im Arbeitsbereich verwendet, anstatt Dateien als Teil der Exportoperation zu kompilieren. Dies müsste das Leistungsverhalten verbessern, denn die Phase der Kompilierung wird übersprungen. Ihr Arbeitsbereich muss jedoch erfolgreich kompiliert worden sein.

JAR-Signierung

Die Registerkarte JAR-Signierung wird nur angezeigt, wenn die Option Als einzelne JAR-Dateien packen in der Registerkarte Optionen ausgewählt ist.

JAR-Signierung

Zum Signieren der JAR-Dateien müssen Sie Eclipse mit einem vollständigen Java Development Kit (JDK) anstatt einer Java Runtime Environment (JRE) ausführen.

Für die Signieroperation sind die Felder Position des Schlüsselspeichers, Kennwort für Schlüssel, Aliasname und Kennwort erforderlich.

Java Web Start

Die Registerkarte Java Web Start ist nur verfügbar, wenn die Option Verzeichnis in der Registerkarte Ziel und die Option Als einzelne JAR-Dateien packen in der Registerkarte Optionen ausgewählt sind.

Java Web Start .

Die Felder Site-URL und JRE-Version sind beide erforderlich.

Zugehörige Referenzinformationen

Exportassistenten
Assistent 'Plug-in-Export'

Zugehörige Tasks

Exportieren und in aktivem Host installieren