Die Definition der neuen Eigenschaft
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.gathering | Die Angabe von true bewirkt, dass auf p2-Publisher basierende Builds aktiviert werden. | ||||||||||||||||||
| p2.build.repo | Eine 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.metadata | Dies 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.compress | Die Angabe von true bewirkt, dass die XML-Datei des endgültigen Repositorys in einer JAR-Datei komprimiert wird. | ||||||||||||||||||
| p2.flavor | Die 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.qualifier | Das 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.artifacts | Keine 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.repos | Definiert Kontextrepositorys. Siehe Metadaten wiederverwenden. | ||||||||||||||||||
| repoBaseLocation | Ein Ordner mit Repositorys, die mit <p2.repo2runnable> umgesetzt werden sollen. Siehe auch Metadaten wiederverwenden. | ||||||||||||||||||
| transformedRepoLocation | Der Ordner mit der Ausgabe von <p2.repo2runnable>. Siehe auch Metadaten wiederverwenden. | ||||||||||||||||||
| p2.category.site | Eine URL zu einer Datei 'site.xml' zum Definieren von Kategorien. | ||||||||||||||||||
| p2.category.definition | Eine URL zu einer Datei 'category.xml' zum Definieren von Kategorien. | ||||||||||||||||||
| p2.category.prefix | Definiert 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.log | Position einer Protokolldatei zum Protokollieren der Ergebnisse des Aufrufs von Director. | ||||||||||||||||||
| p2.director.profile | Der 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.extraArgs | Zusätzliche Argumente, die dem Verzeichnis übergeben werden. Der Standardwert lautet "-profileProperties org.eclipse.update.install.features=true". | ||||||||||||||||||
| Spiegelungseigenschaften | Beim 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'.
|
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.
<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>