Intégration de PDE/Build avec p2

Cette page décrit une méthode obsolète d'intégration avec p2. Pour connaître les méthodes recommandées pour la génération avec p2, voir la page "Génération des référentiels et produits p2". Les propriétés décrites ci-dessous fonctionnent par le biais d'une couche de compatibilité aval et ne prennent pas en charge les nouvelles fonctions ajoutées à p2 publisher.

Pour plus d'informations sur la génération de métadonnées p2, voir Génération de métadonnées p2 dans le Guide du développeur de plug-in de plateforme. La génération de métadonnées seule ne suffit pas pour créer un produit compatible avec p2. Pour ce faire, vous devez exécuter une véritable installation de p2 à partir des métadonnées générées. Pour plus d'informations concernant la façon d'exécuter cette installation à partir d'un script sans interface graphique, consultez la documentation relative à l'application p2 director.

Il est possible de générer des métadonnées p2 à l'aide d'appels manuels au générateur de métadonnées p2 dans l'une des tâches personnalisées de PDE/Build (voir Personnalisation d'une génération sans interface graphique). Toutefois, PDE/Build permet l'intégration avec p2 par le biais des propriétés suivantes :

generate.p2.metadata
(DECONSEILLE, utiliser plutôt p2.gathering) Définissez ce paramètre sur true pour activer la génération des métadonnées p2. Les script ant reposent sur l'existence de cette propriété et non pas sur la valeur. Pour désactiver la génération des métadonnées, vous devez supprimer la propriété et ne pas lui affecter simplement la valeur false.
Dans les scripts de génération, des appels aux cibles p2 sont générés lorsque le regroupement p2 org.eclipse.equinox.p2.metadata.generator et ses dépendances sont présents dans l'application Eclipse qui exécute la génération. Ces cibles p2 dépendent de la propriété generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Spécifiez un fichier : URI indiquant l'emplacement des référentiels d'artefacts et de métadonnées p2 dans lesquels procéder à la publication. Souvent, le référentiel d'artefacts utilise le même emplacement que le référentiel de métadonnées, mais ce n'est pas obligatoire.
Exemple :
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Facultatif. Spécifiez un nom pour les référentiels p2 du générateur.
Lorsqu'un référentiel existant est utilisé, son nom n'est pas modifié. Si aucun nom n'est spécifié, p2 affecte un nom aux référentiels en fonction de leur emplacement.
p2.flavor
Définissez l'apparence des métadonnées p2. Lorsqu'elles sont générées pour Eclipse SDK, une apparence d'"utilitaire" est adoptée.
p2.publish.artifacts
Affectez la valeur true pour publier des fichiers JAR dans le référentiel d'artefacts. Si la valeur false est définie, les métadonnées d'artefact sont générées, mais les fichiers JAR ne sont pas copiés dans le référentiel d'artefacts. AVERTISSEMENT : Lorsque la valeur est true, assurez-vous que p2.artifact.repo n'a pas situé au même emplacement que les répertoires d'assemblage utilisés par PDE/Build, car les fichiers JAR risqueraient d'être supprimés.
p2.root.name
p2.root.version
Spécifiez le nom et la version de l'IU racine qui contiendra tous les éléments générés.
Si un fichier .product est spécifié dans la génération, ces propriétés seront ignorées. Lorsqu'un fichier .product est disponible, le nom et la version de la racine correspondront à l'identificateur et à la version du produit provenant du fichier .product. Pour plus d'informations, voir plus bas.

Génération de métadonnées pour les produits

Lors de l'exécution d'une génération avec un fichier produit défini dans le fichier de configuration de génération de niveau supérieur build.properties (dans les générations utilisant le fichier productBuild.xml et le fichier build.xml normal), PDE/Build génère automatiquement des métadonnées pour ce produit.

En plus des unités installables créées pour tous les dispositifs et tous les regroupements seront également générées les unités de produit suivantes :

A l'aide de toutes ces unités installables générées, il est possible d'utiliser p2 pour installer le produit complet à partir du référentiel.

Les détails

PDE/Build appelle essentiellement la tâche de génération de métadonnées fournie par p2 à certains stades de la génération. Il est probable qu'au cours d'une génération, tous les artefacts de génération ne se retrouvent jamais sur le disque au même endroit à un moment donné. Par conséquent, il serait nécessaire soit d'appeler le générateur de métadonnées p2 sur les archives finales, soit, dans un but d'optimisation, de l'appeler plusieurs fois au cours du processus de génération.

La génération des métadonnées se produit au cours des phases d'assemblage et de mise en forme. Cela s'applique à la fois aux générations normales et aux générations de l'outil de mise en forme. Par exemple, pour une génération de produit à l'aide du fichier productBuild.xml, les scripts suivants seront générés (en supposant que configs=win32,win32,x86 & linux,gtk,ppc) :

Les scripts d'assemblage collectent les dispositifs et les plug-ins générés en même temps que les fichiers racine associés. Les scripts de mise en forme collectent les dispositifs et les plug-ins binaires pré-générés. Les scripts spécifiques à la plateforme collectent les éléments pour ces configurations particulières et les scripts "all" délèguent à chacun des scripts spécifiques à la plateforme.

Les appels de génération p2 se produisent comme suit :

  1. assemble win32.win32.x86 : Génération de métadonnées pour les dispositifs et les plug-ins collectés pour Windows.
  2. assemble win32.win32.x86 : Deuxième appel des métadonnées générées pour les fichiers racine collectés pour Windows.
  3. assemble linux.gtk.ppc : Génération de métadonnées pour les dispositifs et les plug-ins collectés pour Linux.
  4. assemble linux.gtk.ppc : Deuxième appel des métadonnées générées pour les fichiers racine collectés pour Linux.
  5. assemble all : Si l'outil de mise en forme n'est pas exécuté, génération de métadonnées pour une unité installable racine qui contient tout ce qui est mentionné ci-dessus.
  6. package win32.win32.x86 : Génération de métadonnées pour les dispositifs et les plug-ins mis en forme pour Windows.
  7. package win32.win32.x86 : Deuxième appel des métadonnées générées sur les fichiers racine à partir de la mise en forme pour Windows.
  8. package linux.gtk.ppc : Génération de métadonnées pour les dispositifs et les plug-ins mis en forme pour Linux.
  9. package linux.gtk.ppc : Deuxième appel des métadonnées générées sur les fichiers racine à partir de la mise en forme pour Linux.
  10. package all : Génération de métadonnées pour une unité installable racine qui contient tout ce qui est mentionné ci-dessus.

La tâche du générateur de métadonnées p2 prend en charge la génération incrémentielle : chaque appel des métadonnées p2 générées est effectué à l'aide de mode=incremental, l'appel final pour générer l'unité installable racine s'exécutant avec mode="final".