Korzystanie z kwalifikatorów wersji

Pakunki i składniki Eclipse mają numery wersji w postaci główna.mniejsza.mikro.kwalifikator. Segment kwalifikatora wersji często służy do wskazywania konkretnej kompilacji. Jeśli kwalifikator składnika lub wtyczki zostanie ustawiony na wartość kwalifikator (tzn. wersja 1.0.0.kwalifikator), mechanizm budowania środowiska PDE automatycznie zastąpi słowo „kwalifikator” wygenerowanym kwalifikatorem.

Sterowanie wygenerowanym kwalifikatorem

Składnik lub wtyczka może sterować kwalifikatorem, ustawiając wartość właściwości qualifier w pliku build.properties. Istnieją różne możliwe przypadki wartości właściwości:

qualifier = noneSłuży do ustawiania pustego kwalifikatora. Na przykład wersja 1.2.3.kwalifikator zostanie określona jako 1.2.3.
qualifier = contextSłuży do ustawiania kwalifikatora jako kwalifikatora kontekstu. Informacje na temat wartości kwalifikatora kontekstu można znaleźć poniżej.
brak ustawieńJeśli wartość właściwości qualifier nie zostanie ustawiona, użyta zostanie wartość qualifier = context.
qualifier = v12345Wszystkie inne wartości spowodują ustawienie takiej wartości kwalifikatora.

Kwalifikator kontekstu

Wartość wygenerowanego kwalifikatora kontekstu zależy od pierwszego z następujących elementów, który ma zastosowanie:
  1. Jeśli w pliku konfiguracyjnym build.properties programu budującego ustawiona jest właściwość forceContextQualifier, wartość tej właściwości jest używana jako kwalifikator. Właściwość tę można także ustawić w wierszu komend, używając opcji -D podczas wywoływania programu ant.
  2. Jeśli do pobierania plików z repozytorium używane są pliki odwzorowania, to znacznik użyty do pobrania pakunku zostanie wykorzystany jako kwalifikator.
  3. Jeśli nie jest używana właściwość forceContextQualifier ani pliki odwzorowania, kwalifikatorem będzie znacznik czasu w formacie RRRRMMDDGGMM (np. 200605121600)

Przyrostki wersji składnika

Generowanie przyrostków kwalifikatora dla składników można włączyć, ustawiając właściwość generateFeatureVersionSuffix="true" w pliku konfiguracji budowania build.properties.

Założeniem wersji jest, aby przyrastała ona za każdym razem, gdy coś się zmieni. Kwalifikator wersji zwiększa się o jeden, odzwierciedlając zmiany między kolejnymi kompilacjami. Składniki zmieniają się rzadko, jednak zawierają one wtyczki, które mogą zmieniać się często. Po włączeniu przyrostków wersji wersja składnika będzie miała postać główna.mniejsza.mikro.przyrostek_kwalifikatora.   Przyrostek jest w istocie sumą kwalifikatorów wersji wszystkich składników i wtyczek zawartych w tym składniku. Oznacza to, że kiedy jedna z włączonych wtyczek zmienia wersję na wyższą o jeden, to wersja składnika zostanie zwiększona automatycznie. Jest to szczególnie przydatne podczas wdrażania składnika przez serwis aktualizacji.

Wersje ostateczne

Czasami mogą się zdarzyć niestandardowe kroki budowania wymagające rzeczywistej wersji ostatecznej wykorzystywanej podczas budowy. Jeśli ustawiono właściwość generateVersionsLists, komponent PDE Build wygeneruje pliki właściwości zawierające wersje budowanych składników i wtyczek.  Te pliki właściwości można załadować przy użyciu zadania właściwości Ant.

Nazwy plików są następujące: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties i  finalFeaturesVersions.<config>.properties.  Pliki finalPluginsVersions.properties i finalFeaturesVersions.properties zawierają wersje wszystkich wtyczek i składników, które zostały zbudowane.  Pliki właściwości <config> zawierają wersje wtyczek i składników dla określonych konfiguracji budowania.

Format właściwości w tych plikach jest następujący:

    <bundleSymbolicName> = <wersja>
    <bundleSymbolicName>_<pierwsze 3 segmenty wersji> = <wersja>
Jeśli istnieje więcej niż jedna wersja wtyczki lub składnika, <bundleSymbolicName>=<wersja> odnosi się do wtyczki lub składnika o najwyższej wersji. Przykład:
    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