示例 — 软件更新

介绍

此示例演示如何将附加组件安装到 Eclipse 平台上。该示例包含在插件 org.eclipse.update.examples 中。
 

运行示例

要运行该示例,您必须具有可用的 HTTP Server(如 Apache 服务器)。从示例插件 org.eclipse.update.examples 将整个 install 目录复制到 HTTP Server 文档树(如 Apache 服务器的 htdocs 目录)中。确保服务器正在运行。

启动 Eclipse 工作台。选择帮助,再选择软件更新,然后选择添加...
在位置页面上,输入服务器的 URL(例如,http://my.server/... 在此处填入您实际的服务器 URL)。URL 需要反映导向所复制的 install 目录的任何附加服务器路径元素。例如,如果您将 install 目录复制到了 htdocs/examples 中(从而路径就是 htdocs/examples/install),则输入的 URL 应为 http://my.server/examples。
添加下一步>。应出现一个包含可安装组件的列表。所提供的示例包含一个名为更新示例的组件。选择该组件并完成安装。必须重新启动工作台以激活更改。

一旦重新启动了工作台,就可通过将新的示例功能添加到透视图中来查看该功能。选择透视图而后选择定制...,然后展开其他。选择样本操作集(这是由您刚下载并安装的此示例插件实现的操作集)。标有示例菜单的新菜单应出现在工作台中,并带有一项新操作。单击该菜单操作将显示一个信息框(用于验证安装实际上是否起作用)。
 

详细信息

该示例说明 HTTP Server 上用于下载 Eclipse 组件所必需的结构。该示例由一个将菜单和操作添加到工作台的简单插件组成。已使用 Eclipse 工作台中的“插件开发”工具(PDE)将插件封装为组件 jar。注意,org.eclipse.update.examples 的基本插件目录不包含 plugin.xml 文件。因此,该基本插件不向工作台添加任何内容。基本插件包含在前面的步骤中使用的 install 目录。

复制到 HTTP Server 的 install 目录是使用“PDE 组件项目”安装程序(添加了额外的“服务器方”文件)构建组件 jar 的输出。它包含下列内容:

install/
    components/
        install.index
        org.eclipse.update.examples.component_1.0.0/
            install.xml
            install.properties
            install_en.properties
            orq.eclipse.update.examples.component_1.0.0.jar

服务器上必须存在以上目录结构。有一个公共的 install 根目录。还有一个公共的 components 子目录。它包含可用于下载的每一个组件(在该示例中,只有一个组件 org.eclipse.update.examples.component_1.0.0)的子目录。 文件 install.index 是手工创建的(不是由 PDE 生成的)。它是组件目录的简单目录索引(每个目录一行)。这允许更新客户机发现哪个组件目录实际存在于服务器上。

由 PDE 创建的实际组件包含在 orq.eclipse.update.examples.component_1.0.0.jar 中。 还将公开描述组件的 install.xml 文件以让更新支持找出有关组件的内容而不必实际下载该 jar。install[_locale].properties 文件包含分隔开来的字符串。

有关创建组件 jar 的其他详细信息,请参考 PDE 文档。选择帮助,然后从下拉框中选择帮助内容PDE ISV 指南。有关安装约定的其他详细信息,请参考 Eclipse 平台文档。选择帮助,然后从下拉框中选择帮助内容平台插件开发者指南。安装信息包含在参考其他参考文章,平台安装与更新章节中。
 

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.