Produktbuilds mit p2

Die Definition der neuen Eigenschaft

p2.gathering = true

bewirkt einige Änderungen bei Produktbuilds. Insbesondere erzeugt der Build korrekt installierte und vollständig p2-fähige Produkte.

Die folgende Liste enthält eine Gegenüberstellung der zusammengehörigen (alten und neuen) Eigenschaften.

p2.gatheringDie Angabe von true bewirkt, dass auf p2-Publisher basierende Builds aktiviert werden.
p2.build.repoEine URI für das lokale p2-Repository zur Buildzeit. Der Standardwert lautet file:${buildDirectory}/buildRepo. Die Ergebnisse werden von hier in die endgültige Archivposition gespiegelt.
generate.p2.metadataDies ist eine Eigenschaft für die alte Integration des Metadatengenerators. Keine Wirkung, wenn p2.gathering=true angegeben ist.
p2.metadata.repo
p2.artifact.repo
Diese Eigenschaften sind URIs. Bei Produktbuilds sind standardmäßig die endgültigen Archive die installierten Produkte, während Metadaten und Artefakte in ${p2.build.repo} verbleiben. Wenn p2.metadata.repo und p2.artifact.repo definiert sind, werden die Artefakte und Metadaten für das Produkt aus dem Build-Repository gespiegelt.
p2.metadata.repo.name
p2.artifact.repo.name
Diese optionalen Eigenschaften werden zum Benennen des endgültigen Repositorys verwendet, wenn p2.metadata.repo und p2.artifact.repo verwendet werden.
p2.compressDie Angabe von true bewirkt, dass die XML-Datei des endgültigen Repositorys in einer JAR-Datei komprimiert wird.
p2.flavorDie Version des Produkts, die als Qualifikationsmerkmal bei den Konfigurationsmetadaten für das Produkt verwendet wird. Näheres hierzu finden Sie unten unter Produktversion.
p2.product.qualifierDas Qualifikationsmerkmal, das verwendet wird, wenn "1.0.0.qualifikationsmerkmal" in einer Produktversion ersetzt wird. Wird nichts angegeben, basiert das Qualifikationsmerkmal auf forceContextQualifier oder der Zeitmarke.
p2.publish.artifactsKeine Wirkung, wenn p2.gathering=true angegeben ist (alte Eigenschaft).
p2.root.name
p2.root.version
Keine Wirkung, wenn p2.gathering=true angegeben ist (alte Eigenschaft).
p2.context.reposDefiniert Kontextrepositorys. Siehe Metadaten wiederverwenden.
repoBaseLocationEin Ordner mit Repositorys, die mit <p2.repo2runnable> umgesetzt werden sollen. Siehe auch Metadaten wiederverwenden.
transformedRepoLocationDer Ordner mit der Ausgabe von <p2.repo2runnable>. Siehe auch Metadaten wiederverwenden.
p2.category.siteEine URL zu einer Datei 'site.xml' zum Definieren von Kategorien.
p2.category.definitionEine URL zu einer Datei 'category.xml' zum Definieren von Kategorien.
p2.category.prefixDefiniert einen Präfix, um eindeutige IDs für installierbare Einheiten für Kategorien sicherzustellen, die von Site-/Kategoriedateien generiert wurden, die keine eindeutigen Namen verwenden.
skipMirroringÜberspringt die endgültige Spiegelung von ${p2.build.repo} zu ${p2.metadata.repo}.
skipDirectorÜberspringt den Aufruf von Director. Es werden keine installierten Produkte erzeugt. Wenn p2.metadata.repo und p2.artifact.repo definiert sind, werden diese Repositorys die Produktmetadaten und -artefakte enthalten. Andernfalls enthält ${p2.build.repo} die Ergebnisse.
p2.director.logPosition einer Protokolldatei zum Protokollieren der Ergebnisse des Aufrufs von Director.
p2.director.profileDer Name, der für das vom Director erstellte p2-Profil verwendet werden soll. In der Regel ist es sinnvoll, einen Namen auszuwählen, der in gewisser Beziehung zu dem Produkt steht. Der Standardwert ist "profile".
p2.director.extraArgsZusätzliche Argumente, die dem Verzeichnis übergeben werden. Der Standardwert lautet "-profileProperties org.eclipse.update.install.features=true".
SpiegelungseigenschaftenBeim Builden von Produkten oder Features spiegelt PDE/Build Abhängigkeiten aus Kontextrepositorys, die in den Build einzuschließen sind. Diese Eigenschaften steuern, welche Abhängigkeiten in diese Operation eingeschlossen werden. Weitere Informationen finden Sie in der Ant-Task 'p2.mirror'.
p2.mirror.rawStandardwert: 'false'. Mit der Angabe 'true' können Artefaktdeskriptoren aus den Quellenrepositorys wiederverwendet werden.
p2.mirror.slicing.filterStandardeinstellung ist kein Filter. Sie können zusätzliche Filtereigenschaften festlegen, die installierbare Einheiten erfüllen müssen, um eingeschlossen zu werden.
p2.mirror.slicing.followOnlyFilteredRequirementsStandardwert: 'false'. Durch Angabe von 'true' können die Filter umgekehrt werden, sodass nur die installierbaren Einheiten eingeschlossen werden, die ihnen nicht entsprechen.
p2.mirror.slicing.followStrictStandardwert: 'false'. Durch Angabe von 'true' können nur die Abhängigkeiten eingeschlossen werden, deren Versionen genau angegeben sind.
p2.mirror.slicing.includeFeaturesStandardwert: 'true'. Gibt an, ob Features eingeschlossen werden sollen.
p2.mirror.slicing.includeNonGreedyStandardwert: 'false'. Gibt an, ob Non-Greedy-Abhängigkeiten eingeschlossen werden sollen.
p2.mirror.slicing.includeOptionalStandardwert: 'true'. Gibt an, ob optionale Abhängigkeiten eingeschlossen werden sollen.
p2.mirror.slicing.latestVersionOnlyStandardwert: 'false'. Gibt an, ob nur die letzte Version einer Abhängigkeit eingeschlossen werden soll, wenn die Anforderung einen Bereich darstellt und mehrere Versionen verfügbar sind.
p2.mirror.slicing.platformFilterStandardeinstellung ist kein Filter. Durch das Triplet 'os,ws,arch' wird die Plattform festgelegt, mit der LDAP-Filter installierbarer Einheiten abgeglichen werden. Installierbare Einheiten, die nicht mit dem Filter übereinstimmen, werden nicht gespiegelt.

Produktversion

Als Teil eines Produktbuilds generiert PDE/Build automatisch Standardkonfigurationsmetadaten, um Startstufen und die Eigenschaft "config.ini" anzugeben. Diese Metadaten werden häufig als Konfigurationseinheiten (CUs - Configuration Units) bezeichnet. Im Einzelnen werden Startstufen mit CU-Fragmenten an der installierbaren Einheit (IU) für das Produktpaket festgelegt, das gestartet wird. Die Version wird als Qualifikationsmerkmal verwendet, wenn der Name der Konfigurationseinheit auf der Grundlage der installierbaren Einheit generiert wird.

Bei "p2.flavor = tooling" ist zum Beispiel 'toolingwin32.win32.x86org.eclipse.core.runtime' der Name der Konfigurationseinheit, die das Paket "org.eclipse.core.runtime" auf Windows konfiguriert. Es kann sinnvoll sein, eine Version auf der Grundlage der Produkt-ID zu verwenden, um Konflikte mit anderen Metadaten zu vermeiden, insbesondere, wenn das Produkt besondere Anforderungen in Bezug auf Startstufen stellt.

Informationen hierzu finden Sie auch auf der Seite Produkte konfigurieren.

Aufruf von Director

PDE/Build enthält ein runDirector-Ziel, das aufgerufen wird, um Installationen während eines Produktbuilds auszuführen. Gegenwärtig handelt es sich hierbei um eine Verzweigung der Director-Anwendung in einem neuen Prozess. In stärker erweiterten Szenarien zu "releng" ist es möglich, diese Task zum Ausführen zusätzlicher Installationen wiederzuverwenden. Die Task erfordert, dass die Position des Equinox-Startprogramms für den Builder definiert ist. Ein Aufruf würde aussehen wie im folgenden Beispiel:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>