Utilisation de qualificateurs de versions

Les regroupements et les dispositifs Eclipse portent des numéros de version de type majeur.mineur.micro.qualificateur.  Le segment qualificateur de la version est souvent utilisé pour indiquer une génération spécifique.  Si vous affectez au qualificateur de version du dispositif ou du plug-in la valeur "qualifier" (à savoir une version 1.0.0.qualifier), la compilation PDE remplace automatiquement le mot "qualifier" par un qualificateur généré.

Contrôle du qualificateur généré

Un dispositif ou un plug-in peut contrôler son qualificateur en définissant la propriété "qualifier" dans son fichier build.properties. Il existe différents cas où la valeur de cette propriété change :

qualifier = noneIndique que le qualificateur est vide. (i.e. "1.2.3.qualifier" devient "1.2.3")
qualifier = contextDéfinit le qualificateur comme qualificateur de contexte. Voir ci-dessous pour la valeur du qualificateur de contexte.
not setSi la propriété "qualifier" n'est pas définie, cela est équivalent à qualifier = context.
qualifier = v12345Toute autre valeur définit le qualificateur comme tel.

Le qualificateur de contexte

La valeur du qualificateur de contexte généré est déterminée par le premier des éléments suivants qui s'appliquent :
  1. Si la propriété forceContextQualifier est définie dans le fichier build.properties de configuration du générateur,  la valeur de cette propriété est utilisée comme qualificateur.  Cette propriété peut être également définie dans la ligne de commande avec l'option -D lors de l'appel d'Ant.
  2. Si vous utilisez des fichiers de mappe pour extraire les regroupements d'un référentiel, la balise utilisée pour extraire le regroupement est utilisée comme qualificateur.
  3. Si aucune propriété forceContextQualifier ou aucun fichier de mappe n'est utilisé, le qualificateur est un horodatage de la forme YYYYMMDDHHMM (i.e. 200605121600)

Suffixes de version de dispositif

Vous pouvez activer la génération des suffixes de qualificateur des dispositifs en définissant la propriété generateFeatureVersionSuffix="true" dans le fichier build.properties de configuration de la génération.

Une version a pour vocation d'être incrémentée chaque fois que quelque chose change ; le qualificateur de version est incrémentée et capture les modifications entre les générations.  Si les dispositifs changent rarement, ils contiennent des plug-ins qui peuvent changer souvent.  Lorsque les suffixes de version sont actifs, une version de dispositif a le format major.minor.micro.qualifier-suffix.   Le suffixe correspond en fait à la somme des qualificateurs de version de tous les dispositifs et plug-ins inclus par le dispositif.  Cela implique que, lorsque l'un des plug-ins inclus incrémente sa version, la version du dispositif est également incrémentée automatiquement,  ce qui s'avère particulièrement utile lorsque le dispositif est déployé via un site de mise à jour.

Versions finales

A l'occasion, il peut y avoir des étapes de construction personnalisées qui peuvent exiger l'utilisation de la version finale réelle utilisée dans la construction. Lorsque la propriété generateVersionsLists est définie, la génération PDE génère des fichiers de propriétés contenant les versions des dispositifs et des plug-ins générés.  Ces fichiers de propriétés peuvent être chargés à l'aide de la tâche de propriété Ant.

Les fichiers sont nommés : finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties and finalFeaturesVersions.properties contiennent les versions de tous les plug-ins et fonctions qui ont été générés.  Les fichiers de propriété <config> contiennent les versions des plug-ins et des fonctions pour les configurations de génération spécifique.

Les propriétés de ces fichiers ont la forme suivante :

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
Si plus d'une version d'un plug-in ou d'une fonction existe, alors <bundleSymbolicName>=<version> fait référence au plug-in ou à la fonction ayant la version la plus élevée. Exemple :
    org.eclipse.pde.build = 3.3.0.v20070524
    org.eclipse.pde.build_3.3.0=3.3.0.v20070524
    org.eclipse.pde.build_3.2.1=3.2.1.r321_v20060823