Versiotarkenteiden käyttö

Eclipse-resurssijoukkojen ja -tuoteominaisuuksien versionumeroiden muoto on seuraavanlainen: major.minor.micro.qualifier.  Versionumeron qualifier-segmenttiä käytetään usein osoittamaan tiettyä koontiversiota.  Jos määrität tuoteominaisuuden tai lisäosan versiotarkenteeksi qualifier (eli versioksi 1.0.0.qualifier), PDE-koonti korvaa sanan qualifier automaattisesti muodostetulla tarkenteella.

Muodostetun tarkenteen ohjaus

Tuoteominaisuuden tai lisäosan tarkennetta voidaan ohjata määrittämällä ominaisuus qualifier tuoteominaisuuden tai lisäosan build.properties-tiedostoon. Ominaisuuden arvo vaihtelee tapauskohtaisesti:

qualifier = noneMäärittää, että tarkenne on tyhjä. ("1.2.3.tarkenne" muuttuu muotoon "1.2.3".)
qualifier = contextMäärittää, että tarkenne on kontekstin tarkenne. Lisätietoja kontekstin tarkenteen arvosta on jäljempänä.
ei määritettyJos ominaisuutta qualifier ei ole määritetty, järjestelmä tulkitsee, että määritys on qualifier = context.
qualifier = v12345Mikä tahansa muu arvo määrittää tarkenteeksi kyseisen arvon.

Kontekstin tarkenne

Muodostetun kontekstin tarkenteen arvo määräytyy seuraavista kohdista sen mukaan, joka kuhunkin tapaukseen (ensimmäiseksi) liittyy:
  1. Jos koontitoiminnon kokoonpanon build.properties-tiedostossa on määritetty ominaisuus forceContextQualifier,  tarkenteena käytetään kyseisen ominaisuuden arvoa.   Tämän ominaisuuden voi myös määrittää ant-koontia kutsuttaessa komentorivillä vaihtoehdolla -D.
  2. Jos käytät vastaavuustiedostoja resurssijoukkojen noutoon tietovarastosta, tarkenteena käytetään tunnistetta, jota käytettiin resurssijoukon noutoon.
  3. Jos forceContextQualifier-ominaisuutta tai vastaavuustiedostoja ei käytetä, tarkenteena käytetään seuraavanmuotoista aikaleimaa: YYYYMMDDHHMM (esim.200605121600)

Tuoteominaisuuden versioloppuliitteet

Tuoteominaisuuksien tarkenneloppuliitteiden muodostuksen voi määrittää käytössä olevaksi määrittämällä ominaisuuden generateFeatureVersionSuffix=true koontikokoonpanon build.properties-tiedostossa.

Uusissa versioissa tulisi olla joka kerta jokin lisäys. Versiotarkenteen numero kasvaa ja sieppaa muutoksia koonnista toiseen.  Vaikka itse tuoteominaisuudet muuttuvat harvoin, ne sisältävät lisäosia, jotka voivat muuttua usein.  Kun versioloppuliitteet on määritetty käytössä oleviksi, tuoteominaisuuden version muoto on seuraava: major.minor.micro.qualifier-suffix.   Loppuliite on kaikkien tuoteominaisuuden sisältämien tuoteominaisuuksien ja lisäosien versiotarkenteiden summa.  Tämä merkitsee, että jos jonkin sisältyvän lisäosan versionumero kasvaa, myös tuoteominaisuuden versionumero kasvaa automaattisesti.  Tämä on erityisen hyödyllinen ominaisuus, kun tuoteominaisuus otetaan käyttöön päivityssivuston kautta.

Lopulliset versiot

Toisinaan mukautetun koonnin vaiheet voivat edellyttää todellisen lopullisen version käyttöä koonnissa.  Kun ominaisuus generateVersionsLists on määritetty, PDE-koonti muodostaa ominaisuustiedostot, jotka sisältävät koottujen tuoteominaisuuksien ja lisäosien versiot.   Nämä ominaisuustiedostot voidaan ladata ant-ominaisuustehtävän avulla.

Tiedostojen nimet ovat: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  Tiedostot finalPluginsVersions.properties ja finalFeaturesVersions.properties sisältävät kaikkien koottujen lisäosien ja tuoteominaisuuksien versiot.  <Config>-ominaisuustiedostot sisältävät tiettyjen koontikokoonpanojen lisäosien ja tuoteominaisuuksien versiot.

Kyseisissä tiedostoissa olevien ominaisuuksien muoto on seuraavanlainen:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<version kolme ensimmäistä segmenttiä> = <version>
Jos lisäosasta tai tuoteominaisuudesta on olemassa useita versioita, <bundleSymbolicName>=<version> viittaa lisäosaan tai tuoteominaisuuteen, jonka versionumero on suurin. Esimerkki:
    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