RCP-Anwendung aus Produktkonfigurationsdatei erstellen

Eine PDE-Erstellung verfügt über eine Infrastruktur zum Erstellen einer vollständigen RCP-Anwendung aus einer Produktkonfigurationsdatei. Der größte Teil der für eine solche Erstellung erforderlichen Konfiguration kann durch einige Änderungen an der Schablone 'build.properties' durchgeführt werden, die in der PDE-Erstellung bereitgestellt wird. Im folgenden Abschnitt liegt der Schwerpunkt auf der Konfiguration einer einfachen Produkterstellung. Dabei wird vorausgesetzt, dass alle Plug-ins und Features (sowohl für die Erstellung als auch vor der Erstellung), auf die von der Produktdatei verwiesen wird, bereits lokal auf der Festplatte verfügbar sind.

Basiskonfiguration

Der erste Schritt beim Konfigurieren einer Erstellung ist das Erstellen des Verzeichnisses, in dem die Erstellung durchgeführt wird. Dieses Verzeichnis wird als Erstellungsverzeichnis bezeichnet und enthält die zu erstellenden Plug-ins und Features sowie die generierten Artefakte. Danach kopieren Sie Ihre Plug-ins und Features jeweils in die Unterverzeichnisse 'plugins' und 'features'. Die Produktkonfigurationsdatei muss in einem dieser Plug-ins bzw. Features enthalten sein.

Im zweiten Schritt zur Konfiguration einer Erstellung wird die Schablone 'build.properties' aus 'org.eclipse.pde.build/templates/headless-build' in ein neues Verzeichnis kopiert, das das Konfigurationsverzeichnis der Erstellung wird (wird auch als Konfigurationsverzeichnis bezeichnet). Bearbeiten Sie die kopierte Datei 'build.properties', und stellen Sie die folgenden Eigenschaften ein:

Übersicht über die Verzeichnisstruktur

<buildDirectory>/
plugins/
pluginToBuildA
pluginToBuildB
myProduct.product
...
features/
featureToBuild
...

<buildConfiguration>/
build.properties

<baseLocation>
plugins/
org.eclipse.core.runtime
org.eclipse.ui
...
features/
org.eclipse.rcp
org.eclipse.platform.launchers
...

Erstellung ausführen

Zum Ausführen der Erstellung verwenden Sie die Anwendung 'org.elipse.ant.core.antRunner'. Wenn Sie Eclipse mit dieser Anwendung zur Durchführung der Erstellung aufrufen, müssen Sie in der Befehlszeile zwei Argumente einstellen:
Führen Sie die Anwendung 'antRunner' mit Hilfe des folgenden Befehls aus:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/productBuild/productBuild.xml> -Dbuilder=<path to the build configuration folder>

Erweiterte Szenarien

Im Hintergrund wird durch diese Konfiguration ein Feature erstellt, in dem die Plug-ins oder Features enthalten sind, die in der Produktkonfigurationsdatei angegeben sind.   Dieses generierte Feature wird später zum Steuern eines normalen Features auf der Grundlage einer automatischen Erstellung verwendet. Wenn Sie für die Erstellung weitere Anpassungen wie zum Beispiel das Abrufen von Daten aus einem Repository wünschen, finden Sie weitere Informationen hierzu unter Erweiterte Themen zur PDE-Erstellung.