Verzió minősítők használata

Az Eclipse kötegek és szolgáltatások verziószámának formátuma főverzió.alverzió.módosítás.minősítő.  A verziószám minősítő része gyakran egy adott összeépítést jelöl. Ha a szolgáltatás vagy bedolgozó verzió minősítőjét "qualifier" értékre állítja (vagyis a verziószám 1.0.0.qualifier lesz), akkor a PDE összeépítés automatikusan lecseréli a "qualifier" szót egy előállított minősítőre.

Az előállított minősítő szabályozása

Egy szolgáltatás vagy bedolgozó a minősítőjét a build.properties fájljában található "qualifier" tulajdonságon keresztül tudja szabályozni. A tulajdonság értékével kapcsolatban különböző esetek lehetségesek:

qualifier = noneÜresre állítja be a minősítőt. (Vagyis "1.2.3.qualifier" "1.2.3" lesz)
qualifier = contextBeállítja a minősítőt úgy, hogy kontextus minősítő legyen. A kontextus minősítő értékét lásd alább.
nincs beállítvaha a "qualifier" tulajdonság nincs beállítva, akkor ez egyenértékű a qualifier = context beállítással.
qualifier = v12345Bármely más érték az adott értékre állítja be a minősítőt.

Kontextus minősítő

Az előállított kontextus minősítő értékét a következők közül az első megfelelő határozza meg:
  1. Ha a forceContextQualifier be van állítva az összeépítő konfigurációjának build.properties fájljában,  akkor ennek a tulajdonságnak az értéke lesz a minősítő.  Ez a tulajdonság a parancssorban is beállítható a -D kapcsolóval az Ant meghívásakor.
  2. Ha leképezési fájlokat használ a kötegek lehívásához egy lerakatból, akkor a köteg lehívásához használt címke lesz a minősítő.
  3. Ha sem forceContextQualifier, sem leképezési fájlok nem kerülnek felhasználásra, akkor a minősítő az időpecsét lesz, ÉÉÉÉHHNNÓÓPP (vagyis 200605121600) formában.

Szolgáltatás verzió utótagok

A minősító utótag előállítását a szolgáltatásokhoz a generateFeatureVersionSuffix=true tulajdonság beállításával kapcsolhatja be az összeépítési konfiguráció build.properties fájljában.

A verziószám lényege, hogy minden módosításkor növekszik, így az összeépítések közötti változások követhetők.  A szolgáltatások ritkán változnak meg, azonban bedolgozókat tartalmazhatnak, amelyek gyakran változhatnak.  Ha a verzió utótagok be vannak kapcsolva, akkor a szolgáltatás verziószáma főverzió.alverzió.módosítás.minősítő-utótag lesz.   Az utótag lényegében a szolgáltatásban lévő összes szolgáltatás és bedolgozó verzió minősítőjének összege.  Ez azt jelenti, hogy ha az egyik tartalmazott bedolgozó verziószáma növekszik, akkor a szolgáltatás verziószáma is automatikusan növekedni fog.  Ez különösen akkor hasznos, ha a szolgáltatás frissítési webhelyen keresztül kerül telepítésre.

Végleges verziók

Esetenként előfordulhatnak olyan egyéni összeépítési lépések, amelyek a tényleges végleges verziószám használatát követelik meg az összeépítésben. Ha be van állítva a generateVersionsLists tulajdonság, akkor a PDE összeépítés előállítja az összeépített szolgáltatások és bedolgozók verziószámait tartalmazó tulajdonságfájlokat. Ezek a tulajdonságfájlok az ant property feladat segítségével tölthetők be.

A fájlok neve a következő: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, és  finalFeaturesVersions.<config>.properties.  A finalPluginsVersions.properties és a finalFeaturesVersions.properties az összes összeépített szolgáltatás és bedolgozó verziószámát tartalmazza.  A <config> tulajdonságfájlok bizonyos összeépítési konfigurációkhoz tartozó bedolgozók és szolgáltatások verzióit tartalmazzák.

Az ezen fájlokban található tulajdonságok formátuma a következő:

    <bundleSymbolicName> = <verzió>
    <bundleSymbolicName>_<a verzió első három szegmense> = <verzió>
Ha egy bedolgozóból vagy szolgáltatásból több verzió is létezik, akkor a <bundleSymbolicName>=<verzió> a legmagasabb verziószámú bedolgozóra vagy szolgáltatásra utal. Például:
    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