Werken met versiekwalificaties

Eclipse-bundels en -features hebben versienummers in de vorm groot.klein.micro.kwalificatie.Het kwalificatiesegment van de versie wordt vaak gebruikt om een specifieke build aan te geven.  Als u de feature- of pluginversiekwalificatie instelt op "kwalificatie" (dit is een versie van 1.0.0.qualifier), vervangt PDE Build het woord "kwalificatie" automatisch door een gegenereerde kwalificatie.

De gegenereerde kwalificatie beheren

Een feature of plugin kan de kwalificatie controleren door de eigenschap "kwalificatie" in te stellen in het bestand build.properties. Er zijn een aantal verschillende gevallen voor de waarde van deze eigenschap:

qualifier = noneHiermee wordt de kwalificatie ingesteld als leeg. (bijv. "1.2.3.qualifier" wordt "1.2.3")
qualifier = contextHiermee wordt de kwalificatie ingesteld op de context. Hieronder staat de waarde van de contextkwalificatie.
niet ingesteldAls de eigenschap "qualifier" niet is ingesteld, is dit equivalent aan het instellen van qualifier = context.
qualifier = v12345Met een andere waarde wordt de kwalificatie ingesteld op die waarde.

De contextkwalificatie

De waarde van de gegenereerde contextkwalificatie wordt bepaald door de eerste van de volgende items die van toepassing is:
  1. Als de eigenschap forceContextQualifier is ingesteld in het bestand build.properties van de configuratie van uw builder,  wordt de waarde van deze eigenschap gebruikt als kwalificatie.Deze eigenschap kan ook in de opdrachtregel worden ingesteld met -D wanneer Ant wordt aangeroepen.
  2. Als u toewijzingsbestanden gebruikt om uw bundels uit een repository op te halen, wordt de code die is gebruikt om de bundel op te halen als de kwalificatie gebruikt.
  3. Als forceContextQualifier en toewijzingsbestanden beide niet worden gebruikt, wordt de kwalificatie een tijdsaanduiding in de vorm JJJMMDDUUMM (200605121600).

Suffixen van featureversies

U kunt de functie voor het genereren van kwalificatiesuffixen voor features inschakelen door de eigenschap generateFeatureVersionSuffix=true in te stellen in het buildconfiguratiebestand build.properties.

Het idee van een versie is dat deze elke keer dat iets wijzigt, omhoog moet gaan. De versiekwalificatie gaat omhoog en legt wijzigingen van build tot build vast.Features veranderen zelden. Ze bevatten echter wel plugins die vaak kunnen veranderen.Wanneer versiesuffixen zijn ingeschakeld, heeft een featureversie de vorm groot.klein.micro.kwalificatie-suffix.Het suffix is in feite de som van de versiekwalificaties van alle features en plugins die in de feature zijn opgenomen.Dit houdt in dat wanneer de versie van een van de opgenomen plugins omhoog gaat, de versie van de feature automatisch ook omhoog gaat.Dit is met name handig wanneer de feature wordt geïnstalleerd via een updatesite.

Definitieve versies

Voor sommige aangepaste builds zijn er stappen waarbij de actuele definitieve versie moet worden gebruikt in de build.  Wanneer de eigenschap generateVersionsLists wordt ingesteld, genereert PDE Build eigenschappenbestanden met de versies van de features en plugins die zijn gebouwd. Deze eigenschappenbestanden kunnen worden geladen met behulp van de Ant-eigenschappentaak.

De bestanden hebben de volgende namen: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties en  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties en finalFeaturesVersions.properties bevatten de versies voor alle plugins en features die zijn gebouwd. De <config>-eigenschappenbestanden bevatten de versies van plugins en features voor specifieke buildconfiguraties.

De eigenschappen in deze bestanden hebben de volgende vorm:

    <bundleSymbolicName> = <versie>
    <bundleSymbolicName>_<eerste 3 segmenten van versie> = <versie>
Als er meerdere versies van een plugin of feature bestaan, verwijst <bundleSymbolicName>=<versie> naar de plugin of feature met het hoogste versienummer. Voorbeeld:
    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