Es gibt mehrere Methoden, um einen Build ohne GUI anzupassen:
Das genaue Format des Inhalts dieser Dateien hängt jeweils voneinander ab. Wenn Sie Anpassungen mithilfe von customTargets, allElements oder customAssembly vornehmen, wird daher empfohlen, sicherzustellen, dass die für diese Dateien verwendeten Schablonen alle auf derselben PDE/Build-Version beruhen. Neue Versionen von PDE/Build sind abwärtskompatibel mit älteren Versionen dieser Anpassungsscripts.
Schablonenversionen dieser Scripts sind verfügbar im Plug-in org.eclipse.pde.build im Ordner templates/headless-build. Um die Anpassung zu verwenden, kopieren Sie einfach die Schablone in Ihr Buildkonfigurationsverzeichnis und bearbeiten die entsprechenden Ziele.
Das Script customTargets.xml ist für die Anpassung auf der obersten Ebene des Buildprozesses vorgesehen. Es stellt ant-Ziele bereit, die zwischen den wichtigsten Buildphasen aufgerufen werden. Im Umfeld der folgenden Buildschritte sind pre- und post-Ziele verfügbar:
Um das Script 'customTargets.xml' zu verwenden, kopieren Sie es einfach aus dem PDE/Build-Schablonenverzeichnis in Ihre Buildkonfigurationsdatei und bearbeiten die entsprechenden ant-Ziele. Das Script wird automatisch festgestellt und von dem Build ohne GUI verwendet.
Auch das Script 'customTargets.xml' enthält für jede der Buildphasen eine Delegierung an das Script 'allElements.xml'.
Das Script 'allElements.xml' ist eine Art Delegierungsscript, das verwendet wird, um die verschiedenen Buildschritte für ein bestimmtes Element (üblicherweise ein Feature) auszuführen. Wie beim Script 'customTargets.xml' kopieren Sie für die Verwendung dieser Anpassungsschritte die Schablone aus PDE/Build in Ihr Buildkonfigurationsverzeichnis. In Eclipse 3.4 kann das Zielelement, das gebuildet wird, in der Buildkonfigurationsdatei der obersten Ebene 'build.properties' mithilfe der Eigenschaften topLevelElementType und topLevelElementId angegeben werden. Der 'elementType' ist auf Feature einzustellen und für die'elementId' ist die Feature-ID anzugeben, die Sie builden möchten.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
Die Datei 'allElements.xml' enthält außerdem Ziele, die während der Assemblierungs- und Paketierungsphase des Builds verwendet werden. Das Ziel defaultAssemble wird aufgerufen, um die Archive für alle Plattformen zu assemblieren. Gegebenenfalls können benutzerdefinierte Ziele für einzelne Plattformen definiert werden.
Um ein benutzerdefiniertes Ziel für eine bestimmte Plattform zu verwenden, definieren Sie eine Eigenschaft "assemble.<element-id>[.<config>] und ein entsprechendes Ziel. Die Eigenschaft übermittelt PDE/Build den Befehl, dieses benutzerdefinierte Ziel statt des Standardziels zu verwenden. Anschließend kann dieses benutzerdefinierte Ziel verwendet werden, um dem Archiv einen angepassten Namen zu geben oder eine pre- oder post-Bearbeitung des Archivs durchzuführen.
Beispiel:
<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
<target name="assemble.org.foo.feature.id.linux.gtk.x86">
<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
<-- custom pre assemble steps for linux.gtk.x86-->
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
<-- custom post assemble steps for linux.gtk.x86-->
</target>
Das Script 'customAssembly.xml' ist neu in 3.4. Es enthält Anpassungspunkte, die während der Assemblierungs- und Paketierungsphasen des Builds aufgerufen werden. Wie bei den Scripten 'customTargets.xml' und 'allElements.xml' kopieren Sie für die Verwendung dieser Anpassung die Schablone aus PDE/Build in Ihr Buildkonfigurationsverzeichnis.
Die von PDE/Build generierten Assemblierungs- und Paketierungsscripts führen die folgenden Aktionen durch:
Die Assemblierungsscripts übernehmen die Erfassung der Features und Plug-ins, die während des Buildvorgangs kompiliert wurden, und die Paketierungsscripts übernehmen die Erfassung von zuvor kompilierten binären Features und Plug-ins. Das Script 'customAssembly.xml' enthält die folgenden Ziele vor oder nach den vorstehenden Schritten: