Plug-in-Export

Die PDE stellt den Assistenten Plug-in-Export bereit, mit 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 Plug-ins öffnen Datei > Exportieren... > Plug-in-Entwicklung > Implementierbare Plug-ins und Fragmente verfügbar.

Plug-in-Auswahl

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

Plug-ins

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

Ziel

Sie können die Plug-ins in ein Verzeichnis oder in ein komprimiertes Archiv exportieren. Wahlweise können Sie auch die Plug-ins 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 Plug-ins in das Unterverzeichnis plugins/ des ausgewählten Verzeichnisses gestellt.

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

Wenn Sie sich für das Exportieren und Installieren entscheiden, werden die Plug-ins in ausführbarem Format exportiert und es wird ein p2-Repository generiert. Nach dem Export wird eine Installationsoperation zum Installieren der Plug-ins ausgeführt. Sie werden aufgefordert, Eclipse neu zu starten, nachdem der Installationsvorgang abgeschlossen worden ist. Zum Deinstallieren der Plug-ins 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 Plug-in 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 Plug-ins als einzelne JAR-Archive packen packt jedes Plug-in als eine JAR-Datei. Diese Option wird für Plug-ins empfohlen, deren Code im Stammverzeichnis gespeichert ist (also Plug-ins, die nicht über den Header 'MANIFEST.MF Bundle-ClassPath' oder über einen Header im Format Bundle-ClassPath: . verfügen).. Es wird dringend empfohlen, keine verschachtelten JAR-Dateien zu verwenden, da sie die Leistung beeinträchtigen, weil die Laufzeit diese JAR-Dateien zur Laufzeit extrahieren muss. Wenn der Code eines Plug-ins in einer JAR-Datei gepackt wird, wird deshalb empfohlen, das implementierte Plug-in als unstrukturiertes Verzeichnis beizubehalten.

Mit der Option Ersetzung von Qualifikationsmerkmalen können Sie einen Wert für das Qualifikationsmerkmalelement in einer Plug-in-Version ersetzen. Die Plug-in-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 ist nur verfügbar, 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.

Zugehörige Referenzinformationen

Exportassistenten
Assistent 'Feature-Export'

Zugehörige Tasks

Exportieren und in aktivem Host installieren