p2-Repositorys und -Produkte builden

PDE/Build verfügt über integrierte Unterstützung für das Publizieren von p2-Metadaten mit dem neuen p2-Publisher. Die Integration im Stil von 3.4 mit dem alten Metadatengenerator funktioniert zwar noch, unterstützt jedoch neuere Funktionen wie etwa zur Anpassung von Metadaten nicht.

Die neue Publisher-Integration erfasst Ihre Funktionen und Pakete aus der Quelle und publiziert sie direkt in ein p2-Repository. Zur Verwendung der neuen Funktionalität sollte der Builder folgende Eigenschaft definieren:

p2.gathering = true

Die Angabe dieser Eigenschaft bewirkt eine grundlegende Änderung des Builds:

Detaillierte Informationen zu diesen Arten von Builds enthalten die einzelnen Hilfetextseiten für Feature- und Produktbuilds.

Übersicht über die Änderungen

Lokales Repository des Builds

Während des Buildvorgangs werden alle Metadaten und Artefakte in einem durch die Eigenschaft p2.build.repo definierten Build-Repository publiziert. Diese Eigenschaft sollte eine URI angeben; der Standardwert hierfür ist file:${buildDirectory}/buildRepo.

Nachdem alle Metadaten und Artefakte in diesem Repository publiziert worden sind, nehmen die Scripts für die Endassemblierung und -paketierung die Spiegelung und/oder Installation aus diesem Repository an diejenigen Positionen vor, die zu den vom Build erzeugten Archiven werden. Die abschließende Spiegelung und Installation unter Verwendung der Eigenschaften skipMirroring und skipDirector übersprungen werden. In diesem Falls würden sich die Buildergebnisse lediglich alle im Build-Repository befinden.

Generierte Datei 'build.xml': Erfassung versus Publizierung

In der generierten Datei 'build.xml' für Features und Plug-ins befindet sich das Ziel gather.bin.parts, das für das Erfassen des Inhalts des Features/Plug-ins und das Kopieren des Inhalts in ein endgültiges Verzeichnis zuständig war, das (wahlweise) zu JAR-Format verarbeitet und in die Buildergebnisse eingeschlossen werden sollte. Wenn p2.gathering=true verwendet wird, wird stattdessen die Feature/Plug-in direkt in einem p2-Repository veröffentlicht. Dies bedeutet im Einzelnen, dass p2 verwendet wird, um die Binärartefakte direkt aus der Quelle zu erfassen (woraus sich der Name der Eigenschaft ergibt).

Dies erfolgt, indem ein neues Ziel namens publish.bin.parts verwendet das, das eine neue durch PDE/Build beigesteuerte Ant-Task verwendet. In Builds des alten Stils erfolgte der Aufruf von gather.bin.parts anhand einer Delegation durch die Featurestruktur. Stattdessen erfolgt der Aufruf von publish.bin.parts direkt von einem neuen Assemblierungs-p2-Script, das generiert wird.

Durch Features beigesteuerte Stammverzeichnisdateien

Die Integrationen des alten Stils fassten die durch alle Features im Build beigesteuerten Stammdateien in einer einzelnen Stammdatei-IU (IU: Installable Unit, installierbare Einheit) und einem Artefakt zusammen (die bzw. das unter Umständen für ein Produkt benannt worden sein könnte). Mit der neuen Publizierungsunterstützung werden Stammdateien stattdessen demjenigen Feature zugeordnet, das sie beigesteuert hat. Weitere Informationen hierzu finden Sie auf der Seite Layout von Metadaten für Features.

Die Assemblierungsscripts

Die Integration des alten Stils erfolgte durch den Aufruf des Metadatengenerators für die Binärergebnisse während der Assemblierung und Paketierung. Die Verwendung von p2.gathering=true bezieht ein neues Script assemble.<feature>.p2.xml ein.

Dieses Script ruft 'publish.bin.parts' für alle Features und Pakete auf, die gebuildet werden. Es publiziert auch Metadaten aller vorher vorhandenen Binärfeatures und Plug-ins und publiziert außerdem Metadaten für Produkte.

Zum Abschluss des p2-Assemblierungsscripts ist, bevor die übrigen Scripts für die Assemblierung und Paketierung aufgerufen werden, ein komplettes Repository mit den vollständigen Ergebnissen des Builds vorhanden. Die übrigen Scripts für die Assemblierung und Paketierung bewirken lediglich eine Unterteilung ('Slicing') des Repositorys und/oder die Ausführung von Installationen mit p2-Director zum Erzeugen der endgültigen Archive, die die Ergebnisse des Builds sind.