Återanvända p2-metadata

Metadata för en given funktion eller givet samlingspaket kan vara olika beroende på hur de genererades. Det gäller speciellt vid anpassning av metadata eller när funktioner tillhandahåller rotfiler.

På grund av detta är det alltid en bra idé att återanvända metadata när det går i stället för att generera dem baserat på binära funktioner och samlingspaket.

Uppgiften repo2runnable

Med Ant-uppgiften <p2.repo2runnable> omvandlas funktions- och samlingspaketartefakter till det installerade formatet. Det är det format som insticksprogrammen måste ha om vi ska kunna kompilera mot dem. Med den här uppgiften är det enkelt att återanvända lager från andra projekt i bygget. PDE/Build har inbyggd integrering med den här uppgiften via följande egenskaper:

repoBaseLocationEn mapp som innehåller de lager som ska omvandlas. Mappen kan innehålla komprimerade lager och undermappar som är lager.
transformedRepoLocationDen mapp där de omvandlade artefakterna placeras. Den här mappen blir ett p2-lager.

Nytt i 3.5 är de anpassade målen preProcessRepos och postProcessRepos som inträffar före och efter PDE/Build-anropet till <p2.repo2runnable>. Det tillåter automatisk spegling eller hämtning av komprimerade lager:
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>
(När det här dokumentet skapades var inte platsen för de slutliga 3.5-zip-filerna känd. URL-adresserna är endast exempel och kanske inte finns i framtiden.)

PDE/Build anropar först det anpassade målet preProcessRepos och sedan Ant-uppgiften repo2runnable för att omvandla de hämtade lagren till ett format som kan återanvändas av byggfunktionen.

Egenskapen transformedRepoLocation som definierar platsen för utdata från omvandlingen fungerar även som ett kontextlager.

Kontextlager

Egenskapen p2.context.repos är en kommaseparerad lista över lager som fungerar som kontext för bygget.

När metadata genereras kontrolleras kontextlagren först för att se om det redan finns metadata för funktionen eller insticksprogrammet. Om det gör det kopieras alla metadata till det lokala bygglagret (${p2.build.repo}) i stället för att nya metadata genereras.

Om funktioner, samlingspaket eller produkter har anpassade metadata som är beroende av något som inte inkluderades i bygget görs en spegling av kontextlagren. På det sättet inkluderas alla IU-enheter som lagts till metadata för en funktion eller ett insticksprogram.