Brug versionskvalifikatorer

Eclipse-bundter og -funktioner har versionsnumre i formatet overordnet.underordnet.mikro.kvalifikator.Kvalifikatorsegmentet i versionsnummeret bruges ofte til at angive en bestemt bygning.Hvis du indstiller funktions- eller plugin-versionskvalifikatoren til "qualifier" (dvs. en version i formatet 1.0.0.qualifier), erstatter PDE Build automatisk ordet "qualifier" med en genereret kvalifikator.

Kontrollér den genererede kvalifikator

En funktion eller plugin kan styre kvalifikatoren ved at angive egenskaben qualifier" i filen build.properties. Egenskaben kan have et par forskellige værdier:

qualifier = noneAngiver, at kvalifikatoren er tom (dvs. "1.2.3.qualifier" bliver "1.2.3")
qualifier = contextAngiver, at kvalifikatoren skal være af typen context. Nedenfor kan finder du oplysninger om værdien af kontekstkvalifikatoren.
ikke angivetHvis egenskaben "qualifier" ikke er angivet, svarer det til at angive qualifier = context.
qualifier = v12345Alle andre værdier angiver, at kvalifikatoren skal have den pågældende værdi.

Kontekstkvalifikatoren

Værdien af den genererede kontekstkvalifikator bestemmes af det første gældende af følgende elementer:
  1. Hvis egenskaben forceContextQualifier er angivet i byggeprogrammets build.properties-konfigurationsfil,  bruges værdien af denne egenskab som kvalifikator.Denne egenskab kan også angives på kommandolinjen med -D, når ant startes.
  2. Hvis du benytter mapping-filer til at hente bundter fra et opbevaringssted, benyttes den kode, der blev anvendt til at hente bundtet, som kvalifikator.
  3. Hvis du hverken benytter forceContextQualifier eller mapping-filer, er kvalifikatoren et tidsstempel i formatet ÅÅÅÅMMDDTTMM (f.eks. 200605121600)

Suffikser til funktionsversioner

Du kan aktivere genereringen af kvalifikatorsuffikser til funktioner ved at indstille egenskaben generateFeatureVersionSuffix=true i byggekonfigurationsfilen build.properties.

Formålet med en version er, at den skal forøges, hver gang der ændres noget. Versionskvalifikatoren forøges og angiver ændringer fra bygning til bygning.Funktioner ændres sjældent, men de indeholder plugins, som kan ændres ofte.Hvis versionssuffikser er aktiveret, er formatet for funktionsversioner overordnet.underordnet.mikro.kvalifikator-suffiks.Suffikset er i realiteten summen af versionskvalifikatorerne for alle de funktioner og plugins, der er inkluderet i funktionen.Det betyder, at når versonen af en af de inkluderede plugins forøges, bliver funktionens version også forøget automatisk.Det er især nyttigt, hvis funktionen distribueres vha. et opdateringswebsted.

Endelige versioner

Der kan sommetider være tilpassede byggetrin, som kræver den egentlige endelige version, der benyttes i bygget.Når generateVersionsLists er angivet, genererer PDE Build egenskabsfiler, der indeholder versionerne af de funktioner og plugins, der er blevet bygget.Disse egenskabsfiler kan indlæses vha. ant-egenskabsopgaven.

Filerne hedder: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties og finalFeaturesVersions.<config>.properties.Filerne finalPluginsVersions.properties og finalFeaturesVersions.properties indeholder versionerne for alle plugins og funktioner, som er blevet bygget.<config>-egenskabsfilerne indeholder de versionerne af plugins og funktioner, der er til særlige byggekonfigurationer.

Egenskaberne i disse filer har syntaksen:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<første tre segmenter af version> = <version>
Hvis der findes mere end én plugin- eller funktionsversion, refererer <bundleSymbolicName>=<version> til den nyeste version af plugin'en eller funktionen. 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