Používání kvalifikátorů verzí

Balíky a funkce platformy Eclipse mají číslo verze ve tvaru major.minor.micro.qualifier.  Segment qualifier verze se často používá k označení specifického sestavení.  Pokud nastavíte kvalifikátor vaší verze funkce nebo modulu plug-in na "qualifier" (neboli na verzi 1.0.0.qualifier), sestavení PDE automaticky nahradí slovo "qualifier" vygenerovaným kvalifikátorem.

Ovládání generovaného kvalifikátoru

Funkce nebo modul plug-in může ovládat svůj kvalifikátor nastavením vlastnosti "qualifier" ve svém souboru build.properties. Existuje více různých případů pro hodnotu této vlastnosti:

qualifier = noneNastavuje prázdný kvalifikátor. (Např. "1.2.3.qualifier" bude "1.2.3".)
qualifier = contextNastavuje kvalifikátor context. Viz níže k hodnotě kvalifikátoru kontextu.
nenastavenoNení-li vlastnost "qualifier" nastavena, jde o ekvivalent nastavení qualifier = context.
qualifier = v12345Libovolná jiná hodnota nastavuje kvalifikátor na tuto hodnotu.

Kvalifikátor kontextu

Hodnota generovaného kvalifikátoru kontextu je určena první ze dvou následujících položek, která se uplatní:
  1. Pokud je ve vašem souboru konfigurace nástroje pro sestavení build.properties nastavena vlastnost forceContextQualifier,  bude jako kvalifikátor použita hodnota této vlastnosti.  Tato vlastnost může být také nastavena z příkazového řádku při vyvolání nástroje Ant pomocí -D.
  2. Pokud k načtení balíků z úložiště používáte mapovací soubory, bude jako kvalifikátor použita značka, která byla použita k načtení balíku.
  3. Pokud není použita vlastnost forceContextQualifier ani mapovací soubor, bude jako kvalifikátor použito časové razítko ve tvaru RRRRMMDDHHMM (tj. 200605121600).

Přípony verze funkce

Nastavením vlastnosti generateFeatureVersionSuffix=true v souboru konfigurace sestavení build.properties můžete zapnout generování přípon kvalifikátoru funkcí.

Myšlenkou označování verzí je, že by se verze měla zvýšit pokaždé, když se něco změní. Kvalifikátor verze se zvyšuje, a tak zachycuje změny od jednoho sestavení k dalšímu.  Funkce se mění zřídka, ale obsahují moduly plug-in, které se mohou měnit často.  Pokud jsou přípony verzí zapnuty, bude mít verze funkce tvar major.minor.micro.qualifier-přípona.   Přípona je v podstatě součet kvalifikátorů verzí všech funkcí a modulů plug-in obsažených ve funkci.  To znamená, že když se zvýší verze jednoho z obsažených modulů plug-in, zvýší se automaticky také verze funkce.  To je užitečné zejména při implementaci funkce přes web s aktualizacemi.

Konečné verze

Občas mohou existovat kroky vlastního sestavení, které mohou vyžadovat skutečnou konečnou verzi použitou v sestavení.  Je-li nastavena vlastnost generateVersionsLists, sestavení PDE vygeneruje soubory vlastností obsahující verze funkcí a modulů plug-in, které byly sestaveny.  Tyto soubory vlastností lze načíst pomocí úlohy vlastnosti ant.

Soubory mají názvy: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties a  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties a finalFeaturesVersions.properties obsahují verze pro všechny moduly plug-in a funkce, které byly sestaveny.  Soubory vlastností <config> obsahují verze modulů plug-in a funkcí pro specifické konfigurace sestavení.

Vlastnosti v těchto souborech mají formát:

    <bundleSymbolicName> = <verze>
    <bundleSymbolicName>_<první tři segmenty verze> = <version>
Pokud existuje více verzí modulu plug-in či funkce, pak <bundleSymbolicName>=<version> odkazuje na modul plug-in či funkci s nejvyšší verzí. Příklad:
    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