Erweiterungen von PDE Build für den p2-Publisher

PDE Build stellt Ergänzungen durch mehrere Ant-Tasks bereit, die den p2-Publisher erweitern. Durch diese Tasks ist PDE Build in der Lage, Metadaten und Artefakte direkt in einem p2-Repository zu publizieren.

Die generierten Build-Scripts verwenden diese Tasks in dem Kontext eines vollständigen Builds, bei dem Aktionen wie das Kompilieren von Klassendateien und das Ersetzen von Versionen erfolgen. In bestimmten Fällen können jedoch manche Tasks nützlich sein, um Metadaten direkt zu publizieren, ohne einen vollständigen Build auszuführen.

eclipse.publish.featuresAndBundles

Diese Task weist eine starke Ähnlichkeit zu der durch den p2-Publisher ergänzten Task p2.publish.featuresAndBundles auf. Sie bewirkt die Publizierung von Metadaten für zuvor vorhandene binäre Features und Plug-ins, die nicht von der Quelle gebuildet werden. Außerdem publiziert die Task Kategorien auf der Grundlage einer bereitgestellten Datei 'site.xml' oder 'category.xml'.

Diese Task unterstützt die folgenden Attribute:

metadataRepository Eine URI, die das Metadatenrepository angibt, in das publiziert werden soll.
artifactRepository Eine URI, die das Artefaktrepository angibt, in das publiziert werden soll.
repository Gibt 'metadataRepository' und auch 'artifactRepository' an.
site Eine URL zu einer Datei 'site.xml' mit Informationen zur Kategorie.
category Eine URL zu einer Datei 'category.xml' mit Informationen zur Kategorie.
siteQualifier Ein Qualifikationsmerkmal, mit dem sichergestellt wird, dass die resultierenden installierbaren Einheiten (IUs, Installable Units) jeweils eindeutige Namen besitzen.
<features> Ein verschachteltes Dateigruppenelement, das die Positionen der binären Features angibt, die publiziert werden sollen.
<bundles> Ein verschachteltes Dateigruppenelement, das die Positionen der binären Plug-ins angibt, die publiziert werden sollen.
Beispiel:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

Diese Task ermöglicht das Publizieren eines Plug-ins direkt aus der Quelle. Nachdem die Klassendateien (.class) für ein Produktpaket kompiliert worden sind, stellt diese Task alle Dateien zusammen, aus denen sich das binäre Ergebnis zusammensetzt, und publiziert diese als p2-Artefakt mit Metadaten. Diese Task wird in der Task publish.bin.parts in der generierten Datei 'build.xml' des Plug-ins verwendet. Sie ersetzt die Task gather.bin.parts, wenn Sie den Buildprozess mit dem p2-Publisher vornehmen.

Diese Task unterstützt die folgenden Attribute:

metadataRepository Eine URI für das Metadatenrepository, in das publiziert werden soll.
artifactRepository Eine URI für das Artefaktrepository, in das publiziert werden soll.
buildResultFolder Der Ordner, der die gebuildeten Klassendateien (.class), das Manifest und möglicherweise Dateien des Typs '.api_description' enthält.
targetFolder Inhalt bei Ausführung mit 'customBuildCallbacks'.
baseDirectory Projektposition, aus der Inhalt zusammengestellt wird, wenn 'customBuildCallbacks' nicht verwendet wird.
unpack Angabe, die festlegt, ob das Plug-in bei der Installation in Ordnerformat entpackt werden soll.
gatheredSource Bei Quellenproduktpaketen die Position der Quelle für die Zusammenstellung.
<outputFolder> Verschachtelte Elemente, die alternative Positionen zum Abrufen von Klassendateien (.class) angeben, wenn eine Wiederverwendung von Dateien des Typs '.class' aus dem Arbeitsbereich erfolgt. Hierbei handelt es sich um eine Dateigruppe mit einem zusätzlichen Attribut 'library', das angibt, zu welcher Bibliothek die Klassendateien gehören.
Beispiel:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

Diese Task ermöglicht das Publizieren eines Features direkt aus der Quelle. Diese Task stellt alle Dateien zusammen, aus denen sich die JAR-Datei des Features zusammensetzt, und publiziert diese als p2-Artefakt mit Metadaten. Diese Task publiziert auch Artefakte mit Stammdateien, die durch dieses Feature ergänzt wurden. Wenn das Feature keine Eigenschaft bin.includes angibt, wird die JAR-Datei des Features zwar nicht generiert, aber es sind trotzdem Stammdateiartefakte und Featuregruppenmetadaten vorhanden.

Diese Task unterstützt die folgenden Attribute:

metadataRepository Eine URI für das Metadatenrepository, in das publiziert werden soll.
artifactRepository Eine URI für das Artefaktrepository, in das publiziert werden soll.
buildResultFolder Der Ordner, der eine geänderte Datei 'feature.xml' mit ersetzten Versionen enthält.
targetFolder Inhalt bei Ausführung mit 'customBuildCallbacks'.
baseDirectory Die Position des Featureprojekts.
Beispiel:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

Diese Task ermöglicht das Branding von Startartefakten für ein Produkt und ihr erneutes Publizieren mit einem anderen Namen, um in das angegebene Produkt eingeschlossen zu werden.

Diese Task unterstützt die folgenden Attribute:

metadataRepository Eine URI für das Metadatenrepository, in das publiziert werden soll.
artifactRepository Eine URI für das Artefaktrepository, in das publiziert werden soll.
config Die Konfiguration, für die die Startprogramme verwendet werden sollen (Beispiel: 'gtk.linux.x86').
iconsList Die Positionen, an denen sich die Symbole (Icons) für das Branding der ausführbaren Datei befinden.
tempDirectory Die Position eines verwendbaren temporären Verzeichnisses.
productId Die ID des Produkts, für das die Publizierung erfolgt.
productVersion Die Version des Produkts, für das die Publizierung erfolgt.
launcherName Der Name, den das neue Startprogramm erhalten soll.
launcherProvider Der Name der installierbaren Einheit, die die ursprünglichen Startprogrammartefakte bereitstellt. Standardmäßig ist dies 'org.eclipse.equinox.executable'. Die Task sucht nach Artefakten mit dem Namen <launcherProvider>_root.<config>.