Metagegevens p2 opnieuw gebruiken

Metagegevens voor een gegeven feature of bundel kunnen verschillen, afhankelijk van hoe ze zijn gegenereerd. Dit is vooral zo bij metagegevens aanpassen, of wanneer features hoofdbestanden bijdragen.

Daarom is het altijd een goed idee om metagegevens opnieuw te gebruiken, indien mogelijk, in plaags van deze opnieuw te genereren op basis van binaire features en bundels die mogelijk niet van u zijn.

De taak repo2runnable

Er is een Ant-taak <p2.repo2runnable> die feature- en bundelartefacten omzet in de geïnstalleerde vorm. In het algemeen is dit de vorm die de plugins moeten hebben als er met deze plugins moet worden gecompileerd. Met deze taak kunnen repository's gemakkelijk opnieuw geconsumeerd worden vanuit andere projecten in onze eigen build. PDE/Build heeft ingebouwde integratie met deze taak via de volgende eigenschappen:

repoBaseLocationEen map met repository's om te converteren. Deze map kan repository's in een zip-bestand bevatten, en ook submappen die repository's zijn.
transformedRepoLocationDe map waar de omgezette artefacten worden geplaatst. Deze map wordt dan zelf een p2-repository.

Nieuw in 3.5 zijn aangepaste doelen preProcessRepos en postProcessRepos die voorkomen voor en na de aanroep van <p2.repo2runnable> van PDE/Build. Hiermee kan automatisch worden gespiegeld en kunnen repository's in zip-bestanden worden gedownload:
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
</target>
(Tijdens het schrijven was de locatie van de uiteindelijke zip-bestanden in 3.5 nog niet bekend. De URL's hier dienen alleen als voorbeeld en kunnen op een latere datum mogelijk niet bestaan.)

PDE/Build roept eerst het aangepaste doel preProcessRepos aan, en vervolgens wordt de Ant-taak repo2runnable aangeroepen om deze gedownloade repository's om te zetten in een vorm die opnieuw kan worden gebruikt door de build.

De eigenschap transformedRepoLocation waarin de locatie voor de uitvoer van deze transformatie wordt gedefinieerd dient ook als contextrepository.

Contextrepository's

De eigenschap p2.context.repos is een door komma's gescheiden lijst met repository's die dienen als context voor de build.

Bij het genereren van metagegegens raadpleegt de build eerst de contextrepository's om te zien of er al bestaande metagegevenss zijn voor de feature of plugin. Als metagegevens al bestaan, worden deze gekopieerd naar de lokale repository van de build (${p2.build.repo}) in plaats van dat er nieuwe metagegevens worden gegenereerd.

Bovendien, als functies, bundels of producten de metagegevens hebben aangepast zodat ze afhankelijk zijn van iets dat niet is opgenomen in de build, voert PDE/Build een spiegeling uit op de contextrepository's. Deze spiegelbewerking bevat alle IU's die zijn toegevoegd aan metagegevens van een feature of plugin.