为新 Eclipse 功能部件或第三方 Eclipse 功能部件定制 Notes® 安装清单

installfeature 元素

“default”、“required”和“show”属性确定“installfeature”名称是否显示在 Notes® 功能部件安装面板上。

以下列表描述了每个“installfeature”元素的必需属性：

• default - 此属性指定“installfeature”名称是否显示为选定，可用于安装。如果设置为 true，会在功能部件安装面板上显示已选定“installfeature”名称。如果设置为 false，则会在功能部件安装面板上显示未选定“installfeature”名称。
  注： 当再次运行安装程序时，将忽略“default”属性，升级时也会忽略该属性，除非先前提供的安装中不存在“installfeature”，从而使安装程序可以显示在先前提供的安装中可用“installfeature”的状态（安装或未安装）。
• id - 此属性指定要安装功能部件的唯一标识。当前没有对标识字段唯一性进行验证检查。
• name -- 指定功能部件在 Notes® 功能部件安装面板上显示时的“installfeature”名称。
• required - 此属性指定是否必须安装的“installfeature”。如果设置为 true，将安装此功能部件。如果设置为 false，并且 show 属性设置为 true，那么功能部件名称显示在 Notes® 功能部件安装面板中，并且用户可以选择此选项。
• show - 此属性指定“installfeature”名称是否显示在 Notes® 功能部件安装面板上。如果设置为 true，会显示“installfeature”名称。如果设置为 false，那么不会显示“installfeature”名称。
• version - 此属性指定“installfeature”安装版本的数值后缀。

feature 元素

以下列表描述了每个“feature”元素的必需属性：

• 下载大小 - 此属性指定安装此功能部件所需的临时磁盘空间。
• id - 此属性指定标识此特定功能部件的唯一标识，此标识与此功能部件的 features.xml 中使用的标识命名约定相符。
• match - 此属性指定功能部件操作对 version 属性值的依赖性，并用于指定所需的匹配规则。
  注： version 值可以包含四部分：主版本.次版本.服务.限定符。
• 这些选项包括：
  • GreaterOrEqual - 版本的所有部分都必须高于或等于。依赖版本必须至少是指定版本，或具备更高服务级别、次版本或主版本级别。
  • compatible - 主版本必须匹配，而其他各部分必须高于或等于。依赖性插件版本必须至少是指定版本，或者具有更高的服务级别或次版本级别（主版本级别必须等于指定版本）。
  • 等效 - 主版本和次版本必须匹配，并且最后部分（例如，服务限定符）必须高于或等于指定版本。依赖性版本必须至少是指定版本，或者具有更高的服务级别（主版本和次版本级别必须等于指定版本）。
  • perfect － 版本的所有部分必须匹配。依赖性版本必须与指定版本完全匹配。

    例如，下列属性仅当更新站点和 site.xml 文件中的 version 值为 3.0.0 时才允许安装。

    version="version="3.0.0" match="perfect"

• size － 此属性指定安装功能部件所需的磁盘空间。
• URL - 此属性指定安装和初始预配置时获取“installfeature”的位置。
• version － 此属性指定要安装和预配置的功能部件版本。

  这是三部分或四部分组成的值，与要安装的功能部件关联。它对确定是否安装此功能部件的“match”值具有依赖性。它在确定是否更新安装的功能部件时，也对 match 值具有未来的依赖性。

  version 属性具有以下主要值：主版本.次版本.服务发行版.限定符。以下示例显示具有“20100309-1700”限定符的版本 3.0.0，表示已命名的构建或其他限定符值：

  version="3.0.0.20100300-1700"

定制或第三方功能部件的样本功能部件

<installfeature default="false" id="ISVExample1" name="YourToolA" required="false" show="true" version "3.0.0.20100309-1700">

                                      <requirements>

			<feature

download-size="72457"id="com.abx.yourtoolabxz.tools.feature" match="perfect" size="227855" url="${installer.root}/updateSite.zip"version="3.0.0.20100309-1700"/>