Eclipse RCP开发入门（一）——创建RCP项目

一、开发环境：
操作系统：windows XP Home Edition Service Pack3
Java环境：JDK1.6.0_01_b06
Eclipse环境：Eclipse SDK 3.2（中文）、Eclipse RCP3.2.2

 

二、创建插件项目

1、打开Eclipse的插件开发透视图：窗口-打开透视图-其他-插件开发。

2、创建插件开发项目：

    a：新建-插件开发-插件项目，点“下一步”。

    b：输入“项目名”（此处我使用的是“Rcp_Test”）。其余使用缺省设置即可，点“下一步”。

项目名

在为插件项目选择名称时，建议遵循逆向命名域约定（例如 com.example.abc），但 PDE 并未要求必须这样做。

 

项目位置

插件项目的缺省位置是工作空间位置中嵌套的一个子目录。要更改此位置，请取消选中使用缺省位置复选框，然后输入您选择的位置。

 

项目设置

是否应该将插件项目创建为 Java 项目取决于该插件是否要添加代码。大部分插件将添加代码，因此应该包含在 Java 项目中。其他插件（例如文档插件）不添加代码，因此，它们可以包含在简单项目中。

 

Eclipse 与 OSGi 框架

Eclipse 与 OSGi 框架选项控制插件内容页上的代码生成选项以及可用的模板列表。

Eclipse 插件是使用了 Eclipse 扩展注册表的 OSGi 捆绑软件。大部分 Eclipse 插件使用此注册表；这是因为，此注册表是在运行时层提供的。因此，在缺省情况下选择了 Eclipse 目标。

如果您不打算使用 Eclipse 扩展注册表，则应该使用 OSGi 框架选项。如果选择 OSGi 框架选项，则不会导致依赖于运行时层。并且，PDE 将对可用的模板进行限制，并且生成的代码将面向 OSGi 层。

 

Equinox 与标准

当面向 OSGi 框架时，可以在 Equinox 与标准框架之间进行选择。Equinox OSGi 框架使用特定于 Eclipse 的头（例如 Eclipse-LazyStart 和 Eclipse-PlatformFilter）以及伪指令（例如 x-friends）对 MANIFEST.MF 内容进行扩充。如果您不希望使用这些特定于 Eclipse 的头和属性，请选择标准选项。

    c：设置“富客户机应用程序”中的“想要创建富客户机应用程序吗？”选择“是”（说明：如果选择“否”，则创建的应用为依赖与Eclipse的插件程序，而不是独立运行的程序），其余使用缺省设置即可。点“下一步”。

插件属性

插件标识是必填的，它必须与 plugin.dtd 一致。建议您指定与插件项目名匹配的插件标识（但这不是必要条件）。

插件版本是必填的，它的格式必须是 major.minor.micro.qualifier。

插件名是插件的可翻译表示名。此字段是必填的。

插件供应商是插件供应商的可翻译名称。此字段是可选的。

类路径是指将插件打包后代码所在的位置。对于 Eclipse 3.1 来说，建议将插件作为 JAR 交付并将代码保存在 JAR 的根目录中，同时保留类路径字段为空。

 

插件选项

激活器是用于控制插件生命周期的 Java 类。仅当需要在启动或关闭插件后执行工作时，才需要使用激活器。

根据插件是否对 UI 添加内容，为激活器生成的代码会有所不同：

• 如果该插件是 UI 插件，则激活器类扩展 org.eclipse.ui.plugin.AbstractUIPlugin 类。
• 如果该插件是无外设插件（即，非 UI 插件），则激活器扩展 org.eclipse.core.runtime.Plugin 类。
• 如果该插件面向 OSGi 框架，则激活器实现 org.osgi.framework.BundleActivator 接口。

根据您选择的是 UI 插件还是无外设插件，下一个向导页上提供的模板会有所不同。

富客户机应用程序

富客户机应用程序至少需要带有 org.eclipse.core.runtime.applications 扩展的插件。如果需要品牌，则还需要 org.eclipse.core.runtime.products 扩展。通过对富客户机应用程序部分中的问题回答是，您将需要转到模板页。在该页中，可以选择用于生成所有必需扩展的 RCP 模板。

 

    d：在此处为选择一个应用使用的模版，一般应用使用Hello RCP即可，高级应用应视情况选择不同模版。在选择该模版后在右边有各模版使用说明。点“下一步”。

PDE 为平台的常用扩展点提供了复杂性和功能均有所不同的模板。每个模板都可以生成功能全面的插件。

根据您在插件结构和插件内容向导页上选择的选项的不同，您在此向导页上看到的模板列表也会有所变化：

1. Java 项目与简单项目
2. UI 与无外设
3. 富客户机应用程序与正规插件

模板是可定制的。例如，具有编辑器模板的插件允许您定制 XML 编辑器名和类名等内容。

 

添加模板

要将模板添加到新建插件项目创建向导中，请参阅 org.eclipse.pde.ui.pluginContent 扩展点。

    e：此处显示的为Hello RCP的一些应用程序的参数设置，缺省即可一般不用修改。点完成，Eclipse自动创建应用。

3、测试插件

    项目创建完成后，Eclipse自动打开MANIFEST.MF文件，在“概述”中点击“启动Eclipse应用程序”，将回看到插件运行效果。