PDE Build-Integration mit p2

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
p2.artifact.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
p2.artifact.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
p2.root.version
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.

Metadatengeneration für Produkte

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.

Details

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:

  1. assemble win32.win32.x86 : Generiert Metadaten für erfasste Features und Plug-ins für Windows.
  2. assemble win32.win32.x86 : Zweiter Aufruf für generierte Metadaten für erfasste Stammdateien für Windows.
  3. assemble linux.gtk.ppc : Generiert Metadaten für erfasste Features und Plug-ins für Linux.
  4. assemble linux.gtk.ppc : Zweiter Aufruf für generierte Metadaten für erfasste Stammdateien für Linux.
  5. assemble all : Wird das Packprogramm nicht ausgeführt: Generiert Metadaten für eine installierbare Einheit des Stammverzeichnisses, die alles Vorstehende umfassen.
  6. package win32.win32.x86 : Generiert Metadaten für paketierte Features und Plug-ins für Windows.
  7. package win32.win32.x86 : Zweiter Aufruf für generierte Metadaten von Stammdateien aus Paketierungen in Windows.
  8. package linux.gtk.ppc : Generiert Metadaten für paketierte Features und Plug-ins für Linux.
  9. package linux.gtk.ppc : Zweiter Aufruf für generierte Metadaten von Stammdateien aus Paketierungen für Linux.
  10. package all : Generiert Metadaten für eine installierbare Einheit des Stammverzeichnisses, die alles Vorstehende umfasst.

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.