RCP-Anwendung aus Produktkonfigurationsdatei builden

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

Basiskonfiguration

Der erste Schritt beim Konfigurieren eines Builds besteht aus der Erstellung des Verzeichnisses, in dem der Build durchgeführt wird. Dieses Verzeichnis wird als Buildverzeichnis bezeichnet und enthält die zu buildenden 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 zum Buildkonfigurationsverzeichnis 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
...

Build ausführen

Zum Ausführen des Builds verwenden Sie die Anwendung 'org.eclipse.ant.core.antRunner'. Wenn Sie Eclipse mit dieser Anwendung zur Durchführung eines Builds aufrufen, müssen Sie in der Befehlszeile zwei Argumente angeben:
Führen Sie die Anwendung 'antRunner' mithilfe des folgenden Befehls aus:
java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/productBuild/productBuild.xml> -Dbuilder=<pfad zum buildkonfigurationsordner>

Erweiterte Szenarios

Im Hintergrund wird durch diese Konfiguration ein Feature generiert, in dem die Plug-ins oder Features enthalten sind, die in der Produktkonfigurationsdatei angegeben sind. Dieses generierte Feature wird später zum Steuern eines Builds ohne GUI mit normalen Features verwendet. Wenn Sie weitere Anpassungen für den Build benötigen (wie zum Beispiel das Abrufen von Daten aus einem Repository), finden Sie in den Themen für erweiterte PDE-Builds weiterführende Informationen hierzu.