Diese Seite beschreibt eine veraltete Methode der Integration mit p2. Informationen zu den empfohlenen Methoden für den Build mit p2 finden Sie auf der Seite "p2-Repositorys und -Produkte builden". Die nachfolgend beschriebenen Eigenschaften funktionieren mit einer Abwärtskompatibilitätsschicht und unterstützen keine neuen Features, die dem p2-Publisher vielleicht hinzugefügt wurden.
Weitere Informationen über die p2-Metadatenerstellungen finden Sie auf der Seite p2-Metadaten generieren im Handbuch für Plattform-Plug-in-Entwickler. Das Erstellen von Metadaten allein ist nicht ausreichend, um ein p2-fähiges Produkt zu erstellen. Dazu müssen Sie eine tatsächliche p2-Installation von den generierten Metadaten durchführen. Weitere Informationen über die Durchführung dieser Installation aus einem Script ohne GUI finden Sie in der Dokumentation zu p2 director.html.
Es ist möglich, p2-Metadaten mit manuellen Aufrufen des p2-Metadatengenerators in jeder der angepassten PDE/Build-Tasks zu generieren (siehe Build ohne GUI anpassen). PDE/Build bietet allerdings eine Integration mit p2 über die folgenden Eigenschaften:
generate.p2.metadata |
(VERALTET, verwenden Sie stattdessen p2.gathering) Setzen Sie diese Eigenschaft auf 'true', um die p2-Metadatengeneration zu aktivieren. Die Ant-Scripts basieren auf dem Vorhandensein dieser Eigenschaft und nicht auf ihrem Wert. Um die Generierung von Metadaten auszuschalten, muss die Eigenschaft selbst entfernt und nicht einfach nur auf 'false' gesetzt werden. In den Build-Scripts werden Aufrufe von p2-Zielen generiert, wenn das p2-Paket org.eclipse.equinox.p2.metadata.generator und seine Abhängigkeiten in der Eclipe-Installation vorhanden sind, die den Build ausführt. Diese p2-Ziele sind durch die Eigenschaft generate.p2.metadata bedingt. |
p2.metadata.repo |
Geben Sie eine URI vom Typ file: an, die die Position der zu publizierenden p2-Metadaten- und p2-Artefakt-Repositorys angibt. Es ist üblich, aber nicht erforderlich, dass das Artefakt-Repository dieselbe Position wie das Metadaten-Repository verwendet. Beispiel:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Optional. Geben sie einen Namen für den Generator der p2-Repositorys an. Bei der Verwendung eines bereits vorhandenen Repository wird der Name des Repository nicht geändert. Ohne eine Angabe vergibt p2 den Namen der Repositorys nach ihrer Position. |
p2.flavor |
Legt die Version für die p2-Metadaten fest. Bei der Generation von Metadaten für Eclipse SDK wird eine Version der 'Tools' verwendet. |
p2.publish.artifacts |
Wird auf 'true' gesetzt, um JARs in dem Artefakt-Repository zu publizieren. Wird der Wert auf 'false' gesetzt, werden Artefakt-Metadaten generiert, aber die JARs werden nicht in das Artefakt-Repository kopiert. WARNUNG: Wird der Wert auf 'true' gesetzt, müssen Sie darauf achten, dass p2.artifact.repo sich nicht an derselben Position wie die von PDE/Build verwendeten Assemblierungsverzeichnisse befindet, sonst werden die JARs möglicherweise gelöscht! |
p2.root.name |
Gibt den Namen und die Version für die Informationseinheit des Stammverzeichnisses an, das alle Erstellungen enthält. Wird im Build eine .product-Datei angegeben, werden diese Eigenschaften ignoriert. Wenn eine .product-Datei verfügbar ist, wird stattdessen als Stammname und Version die Produkt-ID und Version aus der .product-Datei verwendet. Nachstehend finden Sie weitere Informationen. |
Wenn ein Build mit einer Produktdatenreihe in der Buildkonfigurationsdatei 'build.properties' der obersten Ebene ausgeführt wird (bei Builds, die 'productBuild.xml' und die normale 'build.xml' verwenden), generiert PDE/Build automatisch Metadaten für das Produkt.
Zusätzlich zur Erstellung installierbarer Einheiten für alle Features und Produktpakete werden dabei auch die folgenden installierbaren Produkteinheiten erstellt:
Mit sämtlichen dieser generierten installierbaren Einheiten ist es möglich, p2 für die Installation des kompletten Produkts aus dem Repository zu verwenden.
PDE/Build ruft im Wesentlichen die Task zur Metaddatengeneration auf, die von p2 zu bestimmten Punkten während des Builds bereitgestellt wird. Es ist wahrscheinlich, dass während eines Builds zu keinem Zeitpunkt alle Artefakte auf dem Datenträger an derselben Position vorliegen. Daher ist es erforderlich, entweder den p2-Metadatengenerator für die endgültigen Archive oder als Optimierung mehrere Male während des Buildvorgangs aufzurufen.
Die Metadatengeneration erfolgt während der Assemblierungs- und Paketierungsphasen. Dies gilt für normale Builds und für Paketbuilds. Zur Verdeutlichung: Für einen Produktbuild, der productBuild.xml verwendet, werden die folgenden Scripts generiert (unter der Voraussetzung, dass configs=win32,win32,x86 & linux,gtk,ppc zutrifft):
Assemblierungsscripts erfassen Features und Plug-ins, die zusammen mit den zugeordneten Stammdateien erstellt wurden. Paketscripts erfassen vordefinierte binäre Features und Plug-ins. Die plattformspezifischen Scripts erfassen die Teile für diese besonderen Konfigurationen und die Script-Delegierten 'alle' für alle plattformspezifischen Scripts.
Die Aufrufe für die p2-Generation erfolgt folgendermaßen:
Die p2-Metadatengenerator-Task unterstützt eine schrittweise Generation, jede Aufruf der generierten p2-Metadaten erfolgt mit mode=incremental, der letzte Aufruf zur Generierung der installierbaren Einheit des Stammverzeichnisses wird mit mode="final" ausgeführt.