Bruke versjonskvalifikatorer

Eclipse-bunter og -funksjoner har versonsnumre på formen hoved.underordnet.mikro.kvalifikator. Versjonens kvalifikatorelement blir ofte brukt til å oppgi en bestemt bygging. Hvis du definerer funksjonens eller plugin-modulens versjonskvalifikator til qualifier" (det vil si versjonen 1.0.0.qualifier), erstatter PDE Build automatisk ordet "qualifier" med en generert kvalifikator.

Kontrollere den genererte kvalifikatoren

En funksjon eller plugin-modul kan kontrollere sin egen kvalifikator ved å definere egenskapen "qualifier" i den tilhørende build.properties-filen. Det finnes et par forskjellige tilfeller for verdien til denne egenskapen:

qualifier = noneSetter kvalifikatoren til å være tom. (f.eks. blir "1.2.3.qualifier" til "1.2.3")
qualifier = contextSetter kvalifikatoren til å være context (kontekst)-kvalifikatoren. Nedenfor finner du verdien til kontekstkvalifikatoren.
not set (ikke definert)Hvis egenskapen "qualifier" ikke er definert, er dette det samme som å sette qualifier = context.
qualifier = v12345Alle andre verdier setter kvalifikatoren til å være den verdien.

Kontekstkvalifikatoren

Verdien til den genererte kontekstkvalifikatoren blir fastsatt av den første av de følgende elementene som gjelder:
  1. Hvis egenskapen forceContextQualifier er definert i konfigurasjonsfilen build.properties til byggeren,  blir også verdien av denne egenskapen brukt som kvalifikatoren. Denne egenskapen kan også defineres på kommandolinjen med -D når Ant aktiveres.
  2. Hvis du bruker tilordningsfiler til å hente buntene fra et datalager, så vil koden som ble brukt til å hente bunten, bli brukt som kvalifikator.
  3. Hvis verken forceContextQualifier eller tilordningsfiler brukes, så vil kvalifikatoren være en tidsangivelse i formatet ÅÅÅÅMMDDTTMM (for eksempel 200605121600)

Funksjonsversjonssuffiks

Du kan slå på genereringen av kvalifikatorsuffiks ved å definere egenskapen generateFeatureVersionSuffix=true i byggekonfigurasjonens build.properties-fil.

Meningen med en versjon er at den skal øke hver gang noe endres, og versjonskvalifikatoren øker og registrerer endringer fra bygging til bygging. Funksjoner endres sjelden. De inneholder imidlertid plugin-moduler som kan bli endret ofte. Når versjonssuffiks blir slått på, får en funksjonsversjon formen hoved.underordnet.mikro.kvalifikator-suffiks.Suffikset er faktisk summen av versjonskvalifikatorene for alle funksjonene og plugin-modulene som hovedfunksjonen inkluderer. Det betyr at når en av de inkluderte plugin-modulene øker sin versjon, så øker funksjonens versjon også. Dette er spesielt nyttig når funksjonen distribueres via et oppdateringssted.

Endelige versjoner

Av og til kan det være tilpassede byggetrinn som kan kreve at den faktiske endelige versjonen brukes i byggingen.  Når egenskapen generateVersionsLists er definert, vil PDE Build generere egenskapsfiler som inneholder versjonene av funksjonene og plugin-modulene som er bygd.  Disse egenskapsfilene kan lastes inn med Ant-egenskapsoppgaven.

Filene heter: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties and finalFeaturesVersions.properties inneholder versjoner for alle plugin-moduler og funksjoner som er bygd.  <config>-egenskapsfilene inneholder versjoner av plugin-moduler og funksjoner for oppgitte byggekonfigurasjoner.

Egenskapene i disse filene har følgende form:

    <bundleSymbolicName> = <versjon>
    <bundleSymbolicName>_<første 3 segmenter av versjon> = <versjon>
Hvis det finnes flere enn en versjon av en plugin-modul eller funksjon, refererer <bundleSymbolicName>=<versjon> til den plugin-modulen eller funksjonen som er av høyeste versjon. Eksempel:
    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