Qualifikationsmerkmale für die Version verwenden

Eclipse-Produktpakete und -Features verfügen über Versionsnummern im Format major.minor.micro.qualifier.  Das Segment 'qualifier' der Version wird oft für die Angabe eines bestimmten Builds verwendet. Wenn Sie für das Qualifikationsmerkmal für die Version Ihres Features oder Plug-ins "qualifier" (also eine Version von 1.0.0.qualifier) angeben, wird beim PDE-Build automatisch das Wort "qualifier" durch ein generiertes Qualifikationsmerkmal ersetzt.

Steuerung des generierten Qualifikationsmerkmals

Ein Feature oder ein Plug-in kann sein Qualifikationsmerkmal durch Festlegung der Eigenschaft "qualifier" in seiner Eigenschaftendatei "build.properties" steuern. Diese Eigenschaft kann eine Reihe von unterschiedlichen Werten haben:

qualifier = noneGibt an, dass der Wert für das Qualifikationsmerkmal leer ist (d. h. aus "1.2.3.qualifier" wird "1.2.3").
qualifier = contextGibt an, dass als Wert für das Qualifikationsmerkmal das Qualifikationsmerkmal context verwendet wird. Der Wert des Qualifikationsmerkmals "context" wird weiter unten angegeben.
Nicht angegebenWenn die Eigenschaft "qualifier" nicht angegeben ist, so ist das gleichbedeutend mit der Angabe qualifier = context.
qualifier = v12345Die Angabe aller anderen Werte bewirkt, dass für das Qualifikationsmerkmal jeweils genau angegebene Wert verwendet wird.

Qualifikationsmerkmal

Der Wert für das generierte Kontextqualifikationsmerkmal ergibt sich aus dem ersten der folgenden Elemente, das zutrifft:
  1. Wenn die Eigenschaft forceContextQualifier in der Konfigurationsdatei 'build.properties' Ihres Builders angegeben sit, wird der Wert dieser Eigenschaft als Qualifikationsmerkmal verwendet.Diese Eigenschaft kann auch in der Befehlszeile mit '-D' beim Aufrufen von Ant angegeben werden.
  2. Wenn Sie Zuordnungsdateien zum Abrufen der Produktpakete aus einem Repository verwenden, wird das Tag, das zum Abrufen des Produktpakets verwendet wurde, als Qualifikationsmerkmal verwendet.
  3. Wenn weder "forceContextQualifier" noch Zuordnungsdateien verwendet werden, wird eine Zeitmarke im Format JJJJMMTTHHMM (also zum Beispiel "200605121600") als Wert für das Qualifikationsmerkmal verwendet.

Suffixe der Featureversion

Wenn Sie die Generierung von Qualifikationsmerkmalsuffixen für Features aktivieren möchten, legen Sie die Eigenschaft 'generateFeatureVersionSuffix=true' in der Datei 'build.properties' für die Buildkonfiguration fest.

Dabei wird schrittweise eine höhere Versionsnummer vergeben, sobald sich etwas ändert. Das Qualifikationsmerkmal für die Version steigt schrittweise an und erfasst so die Änderungen von Build zu Build. Features ändern sich zwar selten, enthalten aber Plug-ins, die sich oft ändern können.  Wenn die Versionssuffixe aktiviert sind, besitzt die Featureversion das Format major.minor.micro.qualifier-suffix. Das Suffix ist somit die Summe der Qualifikationsmerkmale der Version von allen Features und Plug-ins, die im Feature enthalten sind. Dies bedeutet, dass bei einer Änderung der Version eines Plug-ins anschließend auch automatisch die Versionsnummer des Features erhöht wird. Dies ist besonders dann sinnvoll, wenn das Feature über eine Update-Site implementiert wird.

Endversionen

Gelegentlich kann es sein, dass angepasste Buildschritte die Verwendung der eigentlichen Endversion im Build erforderlich machen. Wenn die Eigenschaft generateVersionsLists angegeben ist, generiert PDE Build Eigenschaftendateien, die Versionen der gebuildeten Features und Plug-ins enthalten. Diese Eigenschaftendateien können mit der Task für Ant-Eigenschaften geladen werden.

Die Dateien heißen wie folgt: 'finalPluginsVersions.properties', 'finalPluginsVersions.<config>.properties', 'finalFeaturesVersions.properties' und  'finalFeaturesVersions.<config>.properties'.  Die Dateien 'finalPluginsVersions.properties' und 'finalFeaturesVersions.properties' enthalten die Versionen für alle Plug-ins und Features, die erstellt wurden. Die <config>/Eigenschaftendateien enthalten die Versionen von Plug-ins und Features für spezifische Buildkonfigurationen.

Die Eigenschaften in diesen Dateien haben folgendes Format:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<erste 3 segmente der version> = <version>
Wenn mehrere Versionen eines Plug-ins oder eines Features vorhanden sind, bezieht sich <bundleSymbolicName>=<version> auf das Plug-in oder das Feature mit der höchsten Versionsnummer. Beispiel:
    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