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