Extensies van PDE Build voor de p2 Publisher

PDE Build biedt verschillende Ant-taken waarmee de p2-publisher kan worden uitgebreid. Met deze taken kan PDE Build metagegevens en artefacten direct publiceren in een p2-repository.

De gegenereerde buildscripts gebruiken deze taken in de context van een volledige build waar dingen als het compileren van klassenbestanden en het vervangen van versies worden gedaan. Sommige taken kunnen echter nuttig zijn in speciale gevallen om metagegevens direct te publiceren zonder een volledige build uit te voeren.

eclipse.publish.featuresAndBundles

Deze taak lijkt veel op de taak p2.publish.featuresAndBundles die wordt bijgedragen door de p2-publisher. Deze taak publiceert metagegevens voor bestaande binaire features en plugins die niet worden gebouwd vanuit de bron. De taak publiceert ook categorieën op basis van een gegeven bestand site.xml of category.xml.

Deze taak ondersteunt de volgende kenmerken:

metadataRepository Een URI waarin de repository met metagegevens om naar te publiceren wordt opgegeven.
artifactRepository Een URI waarin de repository met artefacten om naar te publiceren wordt opgegeven.
repository Hiermee worden zowel metadataRepository als artifactRepository ingesteld.
site Een URL naar een bestand site.xml waarin categorie-informatie wordt opgegeven.
category Een URL naar een category.xml waarin categorie-informatie is opgegeven.
siteQualifier Een kwalificatie die wordt gebruikt om ervoor te zorgen dat resulterende IU's van categorieën unieke namen hebben.
<features> Een genest element van een bestandsgroep waarin de locaties worden opgegeven van binaire features die moeten worden gepubliceerd.
<bundles> Een genest element van een bestandsgroep waarin de locaties worden opgegeven van binaire plugins die moeten worden gepubliceerd.
Voorbeeld:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

Publiceer een plugin direct uit de bron. Wanneer de .class-bestanden voor een bundel worden gecompileerd, verzamelt deze alle bestanden die het binaire resultaat vormen en deze publiceren als een p2-artefact met metagegevens. Deze taak wordt gebruikt in de taak publish.bin.parts in de gegenereerde build.xml van de plugin. Deze taak vervangt de taak gather.bin.parts wanneer u met de p2-publisher bouwt.

Deze taak ondersteunt de volgende kenmerken:

metadataRepository Een URI om de repository met metagegevens naar te publiceren.
artifactRepository Een URI om de repository met artefacten om naar te publiceren.
buildResultFolder Map met gebouwde .class-bestanden, het Manifest en mogelijk .api_description-bestanden.
targetFolder Content bij uitvoeren met customBuildCallbacks.
baseDirectory Projectlocatie om content te verzamelen van wanneer customBuildCallbacks niet wordt gebruikt
unpack Of de plugin wel of niet moet worden uitgepakt in de map bij het installeren.
gatheredSource Voor bronbundels, de locatie van de verzamelbron.
<outputFolder> Geneste elementen die alternatieve locaties opgeven om .class-bestanden uit op te halen, wordt gebruikt wanneer .class-bestanden van het werkgebied opnieuw worden gebruikt. Dit is een Ant-bestandsgroep met een aanvullend kenmerk "library" waarin wordt opgegeven bij welke bibliotheek de klassenbestanden horen
Voorbeeld:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

Publiceer een feature direct uit de bron. Deze taak verzamelt alle bestanden die de jar-feature vormen en deze publiceren als een p2-artefact met metagegevens. Deze taak publiceert ook artefacten met hoofdmapbestanden die worden bijgedragen door deze feature. Als in de feature geen eigenschap bin.includes is opgegeven, wordt de jar van de feature niet gegenereerd, maar zijn er alsnog artefacten van hoofdmapbestanden en metagegevens van functiegroepen.

Deze taak ondersteunt de volgende kenmerken:

metadataRepository Een URI om de repository met metagegevens naar te publiceren.
artifactRepository Een URI om de repository met artefacten om naar te publiceren.
buildResultFolder Map met een aangepaste feature.xml waarin versies zijn vervangen.
targetFolder Content bij uitvoeren met customBuildCallbacks.
baseDirectory De locatie van het featureproject
Voorbeeld:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

Markeer artefacten voor het startprogramma van een product en publiceer deze met een nieuwe naam om te worden opgenomen in het opgegeven product.

Deze taak ondersteunt de volgende kenmerken:

metadataRepository Een URI om de repository met metagegevens naar te publiceren.
artifactRepository Een URI om de repository met artefacten om naar te publiceren.
config De configuratie waarvoor de startprogramma's worden gebruikt. (bijv "gtk.linux.x86")
iconsList Locaties om de pictogrammen te vinden waarmee het uitvoerbaar bestand kan worden gemarkeerd.
tempDirectory De locatie van een tijdelijke directory die kan worden gebruikt.
productId Het ID van het product waarvoor we publiceren.
productVersion De versie van het product waarvoor we publiceren.
launcherName De naam die aan het nieuwe startprogramma moet worden gegeven.
launcherProvider De naam van de IU die de oorspronkelijke artefacten van het startprogramma biedt. Standaard is dit "org.eclipse.equinox.executable". De taak zoekt naar artefacten met de naam <launcherProvider>_root.<config>