Opětovné použití metadat p2

Metadata pro určitou funkci či balík se mohou odlišovat v závislosti na způsobu jejich vygenerování. Toto platí zejména v situacích, kdy došlo k přizpůsobení metadat nebo pokud funkce přispívají kořenové soubory.

Z tohoto důvodu je užitečné vždy, kdy je to možné, opětovné využití metadat místo jejich nového vygenerování z binárních funkcí a balíků, které nemusíte mít k dispozici.

Úloha repo2runnable

K dispozici je úloha Ant <p2.repo2runnable>, která převádí artefakty funkce a balíku do jejich instalovaného tvaru. Obecně řečeno jde o formu, ve které mají být moduly plug-in, chceme-li provádět kompilaci s jejich účastí. Tato úloha nám umožňuje snadné opětovné použití úložišť z jiných projektů v našem vlastním sestavení. Sestavení PDE má vestavěnou integraci s touto úlohou prostřednictvím následujících vlastností:

repoBaseLocationSložka obsahující úložiště k transformaci. Tato složka může obsahovat úložiště v souborech ZIP a podřízené složky představující úložiště.
transformedRepoLocationSložka, do které budou umístěny transformované artefakty. Tato složka se poté stane vlastním úložištěm p2.

Novinkou verze 3.5 jsou vlastní cíle preProcessRepos a postProcessRepos, jež se vyskytují před a po volání Sestavení PDE <p2.repo2runnable>. Toto umožňuje automatické zrcadlení či stahování úložišť v souborech ZIP:
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>
(V době publikace tohoto materiálu nebylo umístění konečných souborů ZIP verze 3.5 známo. Zde uvedené adresy URL jsou pouhým příkladem a nadále nemusejí existovat.)

Sestavení PDE nejprve zavolá vlastní cíl preProcessRepos, poté zavolá úlohu Ant repo2runnable pro převod těchto stažených úložišť do tvaru, který bude moci využít sestavení.

Vlastnost transformedRepoLocation definující umístění výstupu této transformace slouží rovněž jako úložiště kontextu.

Úložiště kontextu

Vlastnost p2.context.repos obsahuje čárkami oddělený seznam úložišť, které slouží sestavení jako kontext.

Při generování metadat sestavení nejprve pohlédne do úložišť kontextu a zjistí, zda zde existují metadat pro funkci či modul plug-in. Pokud zde metadata existují, budou zkopírována do lokálního úložiště sestavení (${p2.build.repo}) a nová metadata nebudou vygenerována.

Pokud dále funkce, balíky či produkty provedly úpravu svých metadat pro vytvoření závislosti na něčem, co nebylo zahrnuto do sestavení, pak Sestavení PDE provede zrcadlení z úložišť kontextu. Tato operace zrcadlení zahrne veškeré instalovatelné jednotky, které byly přidány do metadat funkce či modulu plug-in.