Générations de produits avec p2

Définition de la nouvelle propriété :

p2.gathering = true

génère des modifications pour les générations de produits. La génération produit, notamment, des produits p2 correctement installés.

Voici la liste des propriétés (anciennes et nouvelles) associées :

p2.gatheringDéfinissez true pour activer les générations basées sur le publieur p2.
p2.build.repoURI au référentiel p2 de génération locale ; la valeur par défaut est file:${buildDirectory}/buildRepo. Les résultats sont mis en miroir depuis cet emplacement dans l'emplacement d'archivage final.
generate.p2.metadataIl s'agit de la propriété de l'ancienne intégration du générateur de métadonnées. Elle n'a aucun impact lorsque p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Ces propriétés doivent spécifier des URI. Pour les générations de produits, par défaut, les archives finales sont les produits et les métadonnées installés et les artefacts restent dans ${p2.build.repo}. Si p2.metadata.repo et p2.artifact.repo sont définis, les artefacts et les métadonnées du produit sont mis en miroir depuis le référentiel de génération.
p2.metadata.repo.name
p2.artifact.repo.name
Ces propriétés facultatives sont utilisées pour nommer le référentiel final lorsque p2.metadata.repo et p2.artifact.repo sont utilisés.
p2.compressDéfinissez true pour compresser le fichier xml de référentiel final dans un fichier JAR.
p2.flavorApparence du produit utilisée comme qualificateur dans les métadonnées de configuration du produit. Voir ci-dessous.
p2.product.qualifierQualificateur à utiliser pour remplacer le "qualificateur 1.0.0." dans la version d'un produit. Si cette propriété n'est pas définie, le qualificateur repose sur forceContextQualifier ou l'horodatage.
p2.publish.artifactsAucun impact lorsque p2.gathering=true (ancienne propriété)
p2.root.name
p2.root.version
Aucun impact lorsque p2.gathering=true (ancienne propriété)
p2.context.reposDéfinit les référentiels de contexte. Voir Réutilisation des métadonnées.
repoBaseLocationDossier contenant les référentiels à transformer en utilisant <p2.repo2runnable>. Voir également Réutilisation des métadonnées.
transformedRepoLocationDossier contenant la sortie de <p2.repo2runnable>. Voir également Réutilisation des métadonnées.
p2.category.siteURL d'accès à un fichier site.xml utilisé pour définir des catégories.
p2.category.definitionURL d'accès à un fichier category.xml utilisé pour définir des catégories.
p2.category.prefixDéfinit un préfixe pour utiliser des ID uniques pour les IU de catégorie générées depuis les fichiers de site/catégorie qui n'utilisent pas des noms uniques.
skipMirroringIgnore la mise en miroir finale de ${p2.build.repo} vers${p2.metadata.repo}.
skipDirectorIgnore l'appel au directeur. Aucun produit installé n'est produit. Si p2.metadata.repo et p2.artifact.repo sont définis, ces référentiels contiennent les artefacts et les métadonnées du produit, autrement ${p2.build.repo} contient les résultats.
p2.director.logEmplacement d'un fichier journal pour consigner les résultats de l'appel au directeur.
p2.director.profileNom à utiliser pour le profil p2 créé par le directeur. Il est généralement préférable d'affecter un nom en relation avec le produit. La valeur par défaut est "profile".
p2.director.extraArgsArguments supplémentaires à transmettre au répertoire. La valeur par défaut est "-profileProperties org.eclipse.update.install.features=true".
Propriétés de mise en miroirLors de la génération de produits ou de fonctions, PDE/Build met en miroir les dépendances depuis les référentiels de contexte à inclure dans la génération. Ces propriétés contrôlent les dépendances incluses dans cette opération. Pour plus de détails, voir la tâche ant p2.mirror.
p2.mirror.rawValeur par défaut : false. Définissez cette option sur true pour réutiliser des descripteurs d'artefact à partir des référentiels source.
p2.mirror.slicing.filterValeur par défaut : sans filtre. Les unités installables (IU) des propriétés de filtre supplémentaires définies doivent être conformes pour être incluses.
p2.mirror.slicing.followOnlyFilteredRequirementsLa valeur par défaut est false. Définissez cette option sur true pour inverser les filtres et inclure uniquement les unités installables qui ne correspondent pas.
p2.mirror.slicing.followStrictLa valeur par défaut est false. Définissez cette option sur true pour inclure uniquement les dépendances dont les versions correspondent exactement.
p2.mirror.slicing.includeFeaturesLa valeur par défaut est true. Indique s'il convient d'inclure les fonctions.
p2.mirror.slicing.includeNonGreedyLa valeur par défaut est false. Indique si les dépendances absolues (greedy) ou non absolues (non-greedy) doivent être incluses.
p2.mirror.slicing.includeOptionalLa valeur par défaut est true. Indique si les dépendances facultatives doivent être incluses.
p2.mirror.slicing.latestVersionOnlyLa valeur par défaut est false. Indique si la version la plus récente d'une dépendance doit être ou non incluse lorsqu'une plage est requise et que plusieurs versions sont disponibles.
p2.mirror.slicing.platformFilterValeur par défaut : sans filtre. Un triplet "os,ws,arch" devant être défini comme étant la plateforme par rapport à laquelle des filtres LDAP sont appliqués aux unités installables. Les unités installables ne correspondant pas aux critères de filtre ne sont pas mises en miroir.

Apparence du produit

Dans le cadre de la génération d'un produit, PDE/la génération génère automatiquement les métadonnées de configuration par défaut pour définir les niveaux de démarrage et la propriété config.ini. Ces métadonnées s'appellent généralement des unités de configuration (UC). En particulier, les niveaux de démarrage sont définis en utilisant des fragments d'UC dans l'IU pour le regroupement à démarrer. L'apparence est utilisée comme qualificateur lors de la génération du nom de l'UC en fonction de l'UI.

Par exemple, avec "p2.flavor = tooling", 'toolingwin32.win32.x86org.eclipse.core.runtime' est le nom de l'UC qui configure le regroupement org.eclipse.core.runtime dans Windows. Il est conseillé d'utiliser une apparence en fonction de l'ID du produit pour éviter les conflits avec d'autres métadonnées, notamment si le produit a des besoins particuliers en matière de niveaux de démarrage.

Voir aussi la page relative à la configuration des produits.

Appel au directeur

PDE/la génération inclut une cible runDirector appelée pour exécuter des installations au cours de la génération d'un produit. Actuellement, il s'agit d'un processus parallèle de l'application directeur dans un nouveau processus. Dans des scénarios releng plus avancés, vous pouvez réutiliser cette tâche pour exécuter des installations supplémentaires. La tâche impose de définir l'emplacement du lanceur equinox du générateur. Voici un exemple d'appel :
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>