Använda versionskvalificerare

Eclipse-paket och -funktioner har versionsnummer i följande format överordnad.underordnad.mikro.namnled. Versionskvalificerarsegmentet används ofta för att ange ett specifikt bygge. Om du anger funktionens eller insticksprogrammets versionskvalificerare till qualifier (dvs. en version av 1.0.0.qualifier), ersätter PDE-byggfunktionen automatiskt ordet qualifier med den genererade versionsinformationen.

Kontrollera den genererade kvalificeraren

En funktion eller ett insticksprogram kan styra kvalificeraren genom att ange egenskapen qualifier i byggegenskapsfilen. Det finns ett par skillnader när det gäller värdet för den här egenskapen:

qualifier = noneAnger att kvalificeraren inte ska ha något värde (dvs. "1.2.3.qualifier" blir "1.2.3")
qualifier = contextAnger att kvalificeraren ska vara kontextkvalificeraren. Värden för kontextkvalificerare finns nedan.
not setOm egenskapen qualifier inte anges är det detsamma som qualifier = context.
qualifier = v12345Alla andra värden anger kvalificeraren till det värdet.

Kontextkvalificeraren

Värdet för den genererade kontextkvalificeraren avgörs av det första av följande objekt som gäller:
  1. Om egenskapen forceContextQualifierangetts i filen build.properties för byggkonfigurationen används värdet för den egenskapen som kvalificerare. Egenskapen kan också anges på kommandoraden med -D när Ant anropas.
  2. Om du använder avbildningsfiler för att hämta paketen från ett lager kommer det märkord som användes för att hämta paketet att användas som kvalificerare.
  3. Om varken forceContextQualifier eller avbildningsfiler används blir kvalificeraren en tidsstämpel i formatet YYYYMMDDHHMM (dvs. 200605121600)

Funktionsversionssuffix

Du kan aktivera genereringen av kvalificerarsuffix för funktioner genom att ange egenskapen generateFeatureVersionSuffix=true i filen build.properties för byggkonfigurationen.

Idén med en version är att den ska ökas varje gång något ändras, versionskvalificeraren ökar och fångar ändringar från bygge till bygge. Funktioner ändras sällan, men de innehåller insticksprogram som ofta kan ändras. När versionssuffix är aktiverade har en funktionsversion formatet överordnad.underordnad.mikro.namnledssuffix.  Suffixet är summan av versionskvalificerarna för alla funktioner och insticksprogram som funktionen inkluderar. Det betyder att när ett anv de inkluderade insticksprogrammen ökar sin version, kommer funktionsversion automatiskt att ökas även den. Det är särskilt användbart när funktionen utplaceras via en uppdateringsplats.

Slutgiltiga versioner

Någon gång kan det finnas anpassade byggsteg som kan kräva att den slutgiltiga versionen används i bygget. När egenskapen generateVersionsLists anges genereras egenskapsfiler som innehåller versionerna för de funktioner och insticksprogram som byggdes. Dessa egenskapsfiler kan läsas in med Ant-egenskapsuppgiften.

Filernas namn: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties och  finalFeaturesVersions.<config>.properties. finalPluginsVersions.properties och finalFeaturesVersions.properties innehåller versionerna för alla de insticksprogram och funktioner som byggdes. <config>-egenskapsfilerna innehåller versionerna för insticksprogram och funktioner för särskilda byggkonfigurationer.

Egenskaperna i filerna har formen:

   <bundleSymbolicName> = <version>
   <bundleSymbolicName>_<first 3 segments of version> = <version>
Om det finns mer än en version av ett insticksprogram eller en funktion, refererar <bundleSymbolicName>=<version> till den version av insticksprogrammet eller funktionen som är högst. Exempel:
   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