PDE Build bietet eine Infrastruktur zum Automatisieren von Feature-Builds. Der größte Teil der für einen solchen Build erforderlichen Konfiguration kann durch einige wenige Änderungen an der Schablone 'build.properties' durchgeführt werden, die von PDE Build bereitgestellt wird. Im folgenden Abschnitt liegt der Schwerpunkt auf der Konfiguration eines einfachen Builds. Dabei wird vorausgesetzt, dass alle Plug-ins und Features (sowohl für den Build als auch vor dem Build), auf die vom erstellten Feature verwiesen wird, bereits lokal auf der Festplatte verfügbar sind.
Der erste Schritt beim Konfigurieren eines Builds ist das Erstellen des Buildkonfigurationsverzeichnisses. In diesem Verzeichnis werden die Dateien gespeichert, die den Build ohne GUI steuern und anpassen.
Die Hauptdatei für die Steuerung des Builds ist die Buildkonfigurationsdatei der obersten Ebene 'build.properties'. Bei einer Konfiguration eines neuen Builds kopieren Sie die Schablonendatei aus dem Produktpaket 'org.eclipse.pde.build' in Ihrer Eclipse-Installation, die für die Buildausführung verwendet wird. Die Schablonendatei befindet sich unter org.eclipse.pde.build/templates/headless-build/build.properties.
Auf das Verzeichnis wird durch die Builder-Eigenschaften verwiesen, die normalerweise in der ant-Befehlszeile festgelegt sind.
Die Eigenschaft buildDirectory gibt das Verzeichnis an, in dem PDE/Build die Scripts generiert und den tatsächlichen Build durchführt. Plug-ins und Features, die gebuildet werden, sind in die Unterverzeichnisse ${buildDirectory}/plugins und ${buildDirectory}/features zu stellen. Wenn Produktpakete und Features von einem Repository abgerufen werden (weitere Informationen finden Sie im Abschnitt Aus Repositorys abrufen), werden sie ebenfalls hierher gestellt.
Dieses Verzeichnis kann mit dem Buildkonfigurationsverzeichnis übereinstimmen oder es kann sich um ein anderes Verzeichnis handeln. Möglicherweise ist es wünschenswert, ein getrenntes Verzeichnis zu verwenden, insbesondere wenn die Buildkonfiguration in CVS gespeichert wird und Sie diese nicht mit generierten Buildartefakten belasten möchten.
Um einen Basis-Feature-Build zu konfigurieren, müssen Sie die Buildkonfigurationsdatei 'build.properties' bearbeiten und die folgenden Eigenschaften konfigurieren:
Frühere PDE/Build-Versionen benötigten außerdem die Datei 'allElements.xml', die in 3.4 nicht mehr erforderlich ist. Die Datei 'allElements.xml' kann weiterhin verwendet werden, ist allerdings nur erforderlich, wenn Sie bestimmte Aspekte Ihres Builds anpassen möchten. Weitere Informationen finden Sie im Abschnitt Build ohne GUI anpassen.
Zum Ausführen des Builds verwenden Sie die Anwendung 'org.elipse.ant.core.antRunner'. Wenn Sie Eclipse mit dieser Anwendung zur Durchführung eines Builds aufrufen, müssen Sie in der Befehlszeile zwei Argumente angeben:
-buildfile=</path/to/build.xml>: Der Pfad zur Datei 'build.xml', die von PDE Build bereitgestellt wird. Sie befindet sich im Verzeichnis 'org.eclipse.pde.build/scripts'. Hierbei handelt es sich um das Buildscript, das den gesamten Buildprozess steuert.-Dbuilder=</path/to/configuration folder>: Der Pfad zum Konfigurationsordner des Builds.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/build.xml>
-Dbuilder=<path to the build configuration folder>Sobald der Build abgeschlossen ist, können Sie das Ergebnis im Buildverzeichnis im Ordner 'I.TestBuild' abrufen (dieser Name kann durch Einstellen der Eigenschaft 'buildLabel' konfiguriert werden).
Wenn Sie weitere Anpassungen für den Build wie zum Beispiel das Abrufen von Daten aus einem Repository benötigen, finden Sie in den Themen für erweiterte PDE-Builds weiterführende Informationen hierzu.