Schritte zur Anpassung von Feature- und Plug-in-Builds

In Version 3.2 haben Sie erstmals die Möglichkeit, einem Feature oder Plug-in angepasste Ant-Ziele zu seinem eigenen Build hinzuzufügen. Diese angepassten Schritte können zum Beispiel zur Instrumentierung von Bytecode nach der Kompilierung, zur Indexierung von Hilfedateien für die Dokumentation oder zum Kopieren von zusätzlichen Dateien in das Produktpaket verwendet werden. 

Für die Verwendung von Standardzielen muss für ein Feature oder Plug-in die Eigenschaft customBuildCallbacks in der zugehörigen Datei 'build.properties' definiert sein; der Wert für diese Eigenschaft ist die Speicherposition einer XML-Datei, in Bezug auf das Stammverzeichnis des Features bzw. Plug-ins, in dem die angepassten Ziele enthalten sind. Wenn die XML-Datei sich an einem anderen Ort befindet, verwenden Sie die Eigenschaft customBuildCallbacks.buildpath, um das zu verwendende Verzeichnis festzulegen.

Die Schablonen mit dem Namen customBuildCallbacks.xml, in denen die unterstützten angepassten Ziele enthalten sind, befinden sich in 'org.eclipse.pde.build/templates/plugins' bzw. in 'org.eclipse.pde.build/templates/features'. Diese Schablonen können in das Feature oder Plug-in kopiert und nach Bedarf verändert werden.

Die angepassten Ziele werden mit der Task 'subant' aufgerufen; failonerror ist standardmäßig auf 'false' gesetzt. Wenn Sie dies ändern möchten, setzen Sie die Eigenschaft customBuildCallbacks.failonerror auf 'true'. Analog dazu ist der Parameter inheritall standardmäßig auf 'false' gesetzt. Wenn Sie dies ändern möchten, setzen Sie die Eigenschaft customBuildCallbacks.inheritall auf einen entsprechenden Wert.

Plug-ins

Die generierte Datei 'build.xml', die ein Plug-in buildet, enthält mehrere Ziele, die bestimmte Tasks ausführen. PDE Build ermöglicht dem Plug-in die Bereitstellung von angepassten 'pre'- und 'post'-Zielen, die vor und nach bestimmten Tasks aufgerufen werden. Zusätzlich zu Ant-Eigenschaften, die unter Umständen bereits definiert sind, kann auch an jedes angepasste Ziel eine Reihe bestimmter Eigenschaften übergegeben werden. Die folgenden Ziele unterstützen angepasste Callbacks:

Features

Die generierte Datei 'build.xml' für die Features unterstützt nur angepasste Build-Callbacks für das Ziel 'gather.bin.parts'. Dieses Ziel ruft das Ziel 'gather.bin.parts' aller eingeschlossenen Features und Plug-ins auf. Es unterstützt 'pre.gather.bin.parts' und 'post.gather.bin.parts'. Diese beiden Ziele verfügen jeweils über die folgenden Eigenschaften: