使用版本限定元

Eclipse 軟體組和特性的版本號碼格式為 major.minor.micro.qualifier。 版本的限定元區段通常用來指示特定建置版本。  如果您將特性或外掛程式版本限定元設為 qualifier"(也就是 1.0.0.qualifier 版),PDE 建置會自動用產生的限定元來取代 "qualifier" 這個字。

控制產生的限定元

特性或外掛程式可在其 build.properties 檔案中設定 "qualifier" 內容來控制其限定元。此內容的值有數種不同的情形:

qualifier = none將限定元設為空的。(也就是 "1.2.3.qualifier" 變成 "1.2.3")
qualifier = context設定該限定元為 context 限定元。請參閱下文,以得知環境定義限定元的值。
not set如果未設定 "qualifier" 內容,則這相當於設定 qualifier = context。
qualifier = v12345任何其他值會將限定元設為該值。

環境定義限定元

產生的環境定義限定元之值取決於下列中的第一個適用項目:
  1. 如果 forceContextQualifier內容是設定在建置器的配置檔 build.properties 中,便會利用這個內容值作為限定元。 您也可以在呼叫 Ant 時,在指令行中,利用 -D 來設定這個內容。
  2. 如果您利用對映檔來提取儲存庫中的軟體組,便會利用提取軟體組時所用的標示來作為限定元。
  3. 如果既未使用 forceContextQualifier,也未用對映檔,限定元便是格式為 YYYYMMDDHHMM 的時間戳記(亦即 200605121600)

特性版本字尾

您可以在建置配置檔 build.properties 中設定 generateFeatureVersionSuffix=true 內容,來開啟產生特性的限定元字尾。

版本的觀念在於,每當有了某種改變便應增量一次,每次建置,版本限定元都會增量並擷取其間的改變。 特性不太會改變,不過,它們包含的外掛程式可能會常常改變。 當啟用版本字尾時,特性版本的格式如下:major.minor.micro.qualifier-suffix。 字尾事實上是併入特性的所有特性和外掛程式之版本限定元的總和。 這表示當併入的外掛程式之一的版本增量時,特性版本也會自動增量。 當透過更新網站來部署特性時,這尤其有用。

最終版本

有時可能有一些自訂建置步驟需要在建置中使用實際的最終版本。 若設定 generateVersionsLists 內容,「PDE 建置」會產生一些內容檔,其中包含已建置之特性和外掛程式的版本。  您可以利用 Ant 內容作業來載入這些內容檔。

這些檔案的名稱為:finalPluginsVersions.properties、finalPluginsVersions.<config>.properties、finalFeaturesVersions.properties 和 finalFeaturesVersions.<config>.properties。finalPluginsVersions.properties 和 finalFeaturesVersions.properties 包含已建置之所有外掛程式和特性的版本。<config> 內容檔包含特定建置配置之外掛程式和特性的版本。

這些檔案中的內容格式如下:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
如果外掛程式或特性有多個版本,則 <bundleSymbolicName>=<version> 會參照最高版本的外掛程式或特性。 範例:
    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