使用版本限定符

Eclipse 捆绑软件和功能部件使用格式为 major.minor.micro.qualifier 的版本号。版本的限定符段通常用来指示特定的构建。如果将功能部件或插件的版本限定符设置为“qualifier”(即,版本为 1.0.0.qualifier),“PDE 构建”就会自动将“qualifier”一词替换为所生成的限定符。

控制生成的限定符

功能部件或插件可以通过在其 build.properties 文件中设置“qualifier”属性来控制其限定符。此属性的值有几种不同的情况:

qualifier = none将 qualifier 设置为空值。(即,“1.2.3.qualifier”成为“1.2.3”)
qualifier = context将 qualifier 设置为上下文限定符。有关上下文限定符的值,请参阅下面的内容。
未设置如果未设置“qualifier”属性,那么这等价于设置 qualifier = context。
qualifier = v12345任何其他值都会将 qualifier 设置为该值。

上下文限定符

所生成的上下文限定符值由下列第一个适用的项确定:
  1. 如果在构建器的配置 build.properties 文件中设置了 forceContextQualifier 属性,那么会将此属性的值用作限定符。也可以在调用 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>_<版本的前 3 段> = <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