功能部件在运行期标识组件
Eclipse 允许标识活动产品,也可以选择标识运行期配置中的每一个功能部件。功能部件不是必须要标识出来,您可以不标识您所有的功能部件,但是您应该至少标识一个。
标识定义――插件的工作
添加标识的关键问题是要明白把标识的定义在哪里。您定义标识的是功能部件,但是标识的内容是来自于插件。或者插件与功能部件的id相同(默认的情形),或者插件在功能部件的定义中被明确标识(这是 Eclipse 2.1.1 的新增功能)。在 Eclipse 2.1 中,一个功能部件定义可以通过在 feature.xml 文件中指定属性 plugin=… 来定义其他插件,插件包含了用于定义和提供标识内容的文件。
标识内容概要介绍
about.ini 控制文件定义了产品级和功能部件级的标识。产品标识必须正确包含以下两方面内容:
·功能部件必须被定义为一个可能的主要功能部件,即在 feature.xml 定义文件中要包含 primary="true"。
·功能部件必须被标识为活动的主要功能部件,在产品中通常是在 \eclipse 目录下的 install.ini 文件中的条目来设置。主要功能部件也可以在运行期通过使用 -feature featureId 启动参数来定义。
理解功能部件标识的最简单的办法是去查看在 about.ini 控制文件中定义了哪些元素,以及它们在一个被标识的产品或功能部件中如何起作用。
图 2. 在 Eclipse 透视图中可用的标识内容
以下几条仅用于产品标识:
·windowImage
·appName
·aboutImage
其余条目在产品及功能部件标识过程中使用。
以百分号(%)开头的值在 about.properties 文件中解析。当一个功能部件是主要功能部件时,用 abouText 关键字定义的文本会在 About product 对话框中显示。当用户点击 Feature Details 按钮时,随后弹出的 About Features 对话框中也会显示这些本文内容。
功能部件被加入到运行期配置时,会打开 welcomePage 条目指定的欢迎页面,其后还可以通过选择 Eclipse 菜单选项 Help > Welcome... 打开的 Welcome 选择对话框打开这个欢迎页面。
构建一个可行的有标识的功能部件的最快速方法是克隆一个在 Eclipse 本身中可以找到的一个现有的功能部件。具有 org.eclipse.platform id 的功能部件和插件会提供功能部件标识和插件标识。在The Java Developer's Guide to Eclipse一书第34章练习7中有一个步骤详尽的指导说明。在 Eclipse.org 的更新管理器子工程的开发资源中,您可以找到另外一些关于标识的详细说明。
使用 PDE 构建功能部件的策略
在《The Java Developer's Guide to Eclipse》一书中关于功能部件开发的章节和 Eclipse.org 的文章 《PDE 生成插件》中都对构建功能部件的过程进行了介绍,但是也还有一些其他的途径。当您理解了如何使用 PDE 来构建功能部件和相关联的插件之后,您可以让这些步骤自动完成。
由 PDE 实现的 Ant 目标
让我们从对 PDE 所提供功能概要介绍开始讲起。PDE 将为一个 plugin.xml 或 feature.xml 文件生成 build.xml 文件。Build.xml是一个 Ant 脚本,可以完成运行期平台的功能部件和插件所需要的不同任务。PDE 构建过程允许您生成下列构建目标中的一个或多个。
重要的功能部件构建目标:
·build.jars 为每一个引用到的插件调用 build.xml 文件中的 build.jars 任务。
·build.update.jar 为每一个引用到的插件调用 build.xml 文件中的 build.update.jars 任务。同时会为功能部件创建一个 Update JAR。这是 Ant 脚本的默认目标。
·build.sources 为每一个引用到的插件调用 build.xml 文件中的 build.source 任务。
·zip.distribution 创建一个包含功能部件和引用到的插件所需要的所有文件的压缩文件。
·refresh 使 Eclipse 刷新功能部件工程及任何引用到的插件的工程。
重要的插件构建目标:
·build.jars 为插件定义的每一个运行期 JAR 调用 build.xml 文件中的许多目标。被调用的目标的名字与运行期 JAR 文件的名字相同。这些目标编译 Java 代码并创建 JAR 文件,包含任何在源文件目录下的资源。
·build.update.jar 将所有运行期插件目录下所有需要的文件压缩打包为一个名字为 plugin.id_version.jar 的文件,在这里 plugin.id 和 version 来自于 plugin.xml 文件。这是 Ant 脚本的默认目标。
·build.sources 基于给定的运行期 JAR 文件所定义的源文件目录,创建 Java 源文件的压缩包。
·zip.plugin 创建一个包含有插件所需要的所有内容的压缩包。
·refresh 使 Eclipse 刷新插件工程。
注意:在功能部件和插件的Ant 处理过程中,更新 JAR 或生成压缩包的处理过程中打包的文件,是运行期环境所需要的那些文件。这些内容在功能部件或插件的 build.properties 文件和在 plugin.xml 中定义的每一个插件的运行期 JAR 文件中,通过 bin.includes 或者 bin.excludes 条目来描述。
1
2
下一页>>