Réutilisation des métadonnées p2

Les métadonnées d'un dispositif ou d'un regroupement peuvent être différentes selon la manière dont elles ont été générées, notamment lors de leur personnalisation ou lorsque les dispositifs fournissent les fichiers racine.

De ce fait, il est préférable de réutiliser les métadonnées lorsque cela est possible au lieu de les régénérer en fonction des dispositifs et des regroupements binaires que vous pouvez ne pas détenir.

La tâche repo2runnable

Il existe une tâche Ant <p2.repo2runnable> qui transforme les artefacts de dispositif et de regroupement en formulaire installé. D'une manière générale, les plug-ins doivent avoir cette forme pour pouvoir compiler par rapport à eux. Cette tâche permet de réutiliser aisément les référentiels d'autres projets dans votre propre génération. PDE/la génération a une intégration intégrée à cette tâche via les propriétés suivantes :

repoBaseLocationDossier contenant les référentiels à transformer. Ce dossier peut contenir des référentiels zippés et des sous-dossiers qui sont des référentiels.
transformedRepoLocationDossier où sont placés les artefacts transformés. Ce dossier devient lui-même un référentiel p2.

La version 3.5 contient les nouvelles cibles personnalisées preProcessRepos et postProcessRepos qui interviennent avant et après l'appel de PDE/la génération à <p2.repo2runnable>. Cela permet d'effectuer automatiquement la mise en miroir ou de télécharger les référentiels zippés :
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>
(Au moment de la rédaction de ce document, l'emplacement des zips finaux 3.5 n'était pas connu. Les URL ici sont fournies uniquement comme exemple et peuvent ne pas exister ultérieurement.)

PDE/la génération appelle la cible personnalisée preProcessRepos, puis la tâche Ant repo2runnable pour transformer les référentiels téléchargés en formulaire pouvant être réutilisés par la génération.

La propriété transformedRepoLocation, qui définit l'emplacement de la sortie de la transformation, sert également de référentiel de contexte.

Référentiels de contexte

La propriété p2.context.repos est une liste de référentiels séparés par une virgule qui fait office de contexte pour la génération.

Lors de la génération des métadonnées, la génération consulte les référentiels de contexte pour déterminer s'il existe des métadonnées pour le dispositif ou le plug-in. S'il en existe, elles sont copiées vers le référentiel local de génération (${p2.build.repo}) et de nouvelles métadonnées ne sont donc pas générées.

En outre, si les dispositifs, les regroupements ou les produits ont personnalisé leur métadonnées pour dépendre d'un élément qui n'a pas été inclus dans la génération, PDE/la génération exécute une mise en miroir depuis les référentiels de contexte. Cette opération inclut toutes les IU ajoutées aux métadonnées des dispositifs ou des plug-ins.