开发您的第一个 Eclipse RCP 应用程序(4/12)

 

开发您的第一个 Eclipse RCP 应用程序 Eclipse V3.1 使得创建富客户机应用程序比以前更加容易

第 4 页，共 12 页 对本教程的评价 帮助我们改进这些内容 基础 步骤 1：创建最小的 Hello World RCP 应用程序 单击 Ctrl+N 打开 New 向导。 选择 Plug-in Project 然后单击 Next。 在 Project name 文本域输入 com.ibm.plte，然后单击 Next。 对于 “Would you like to create a rich client application?” 选择 Yes，然后单击 Next。 选择 Hello RCP 模板，然后单击 Finish。 Open Associated Perspective 对话框将会弹出。单击 Yes。 您的工作台应该与下图类似： 图 1. PDE 透视图中插件 com.ibm.plte 的 plugin.xml Hello RCP 模板非常强大并在幕后执行很多任务。模板生成一个插件项目，并添加两个扩展点和六个 Java 类。每个扩展点和 Java 类描述如下。 表 2. Hello RCP 模板生成的工件的描述 org.eclipse.core.runtime.applications 该扩展点将主程序和实现 IPlatformRunnable 和 run() 方法的类的名称告诉 Eclipse 运行库。在 Hello World RCP 应用程序里，程序名是 com.ibm.plte.application，类名是 com.ibm.plte.Application。 注意，既然 Eclipse IDE 是一个 RCP 应用程序，那么它也定义了该扩展点。在 Eclipse IDE 中，应用程序名是 org.eclipse.ui.ide.workbench，类名是 org.eclipse.ui.internal.ide.IDEApplication。 org.eclipse.ui.perspectives Perspective.java 透视图 是一系列包含位置和大小的可见视图、编辑器和菜单。在 RCP 应用程序中，您必须定义至少一个透视图并将它设置为默认的。透视图是通过使用该扩展点引用的类名实现 IPerspectiveFactory 而创建的。该接口最重要的部分是 createInitialLayout() 方法，您在这里定位和打开您希望用户开始时看到的任何视图或编辑器。本例到目前这里还没有视图或编辑器，因此方法是空的。 PltePlugin.java 该类被称为插件类。一个可选的单个类可以用来存储插件的全局信息。它也是放置插件中其他类使用的静态实用功能的一个方便的地方。 Application.java Application.java 类是 RCP 应用程序的主例程。与 Java 类 main() 类似，是应用程序的控制器。该类负责创建一个工作台并将 ApplicationWorkbenchAdvisor.java 与其连接。 工作台作为 RCP 框架的一部分声明和维护。只有惟一一个工作台，但是可以有不只一个可见的顶层工作台窗口。例如，在 Eclipse IDE 中，当您第一次启动 Eclipse 时，您将会看到一个工作台窗口，但是如果您选择 Window > New Window，则会弹出第二个窗口。因此，现在有了两个工作台窗口，但是只有一个工作台。 ApplicationWorkbenchWindow.java ApplicationWorkbenchAdvisor.java ApplicationActionBarAdvisor.java 有三个 advisor 类用来配置工作台的所有方面，如标题、菜单条等。这些是 RCP 开发人员要理解的最重要的类。您可以在 RCP 应用程序中扩展基类（例如 WorkbenchAdvisor），并覆盖一个或多个方法来设置您需要的选项。详细信息参见产品文档。 回页首 步骤 2：运行最小的 Hello World RCP 应用程序 确保 com.ibm.plte (plugin.xml) 编辑器的 overview 页面是打开的。单击 Testing 部分的 Launch an Eclipse application。最小的 Hello World RCP 应用程序应该与下面所显示的相似。 图 2. 最小的 RCP 应用程序 用这两个简单的步骤，您创建和运行了一个最小的 RCP 应用程序。这时，RCP 应用程序包含一个透视图，而没有其他 Eclipse 功能（菜单、动作、视图、首选项页面、帮助，等等）。接下来您将添加这些功能。 回页首 步骤 3：向最小的 Hello World RCP 应用程序添加菜单和动作 菜单和动作将通过两种途径添加。这里，我们以编程方式来将它们添加到 RCP 应用程序。后面您将通过扩展点来添加。 将添加以下五个菜单： File Window Help Window/Open perspective Window/Show view 然后添加以下六个动作： File/Exit Window/Open perspective/Other Window/Show view/Other Window/Preferences Help/Help contents Help/About 您在这里添加的动作是通常包含在 Eclipse IDE 中的预构建动作。然而，RCP 为了您的方便将它们提供给您。要理解这些菜单和动作是如何定义的，请查看 com.ibm.plte.help 特性项目中的 ApplicationActionBarAdvisor.java。注意，使用工作框架，您可以贡献您自己的动作。后面将使用扩展点来做到这一点。 实施步骤： 用 com.ibm.plte.help 特性项目中一个相同名称的文件替换 com.ibm.plte 插件的 com.ibm.plte.ApplicationActionBarAdvisor.java。 确保已关闭先前打开的 RCP 应用程序。返回 com.ibm.plte (plugin.xml) 编辑器的 overview 页面，并单击 Testing 部分的 Launch an Eclipse application。RCP 应用程序应该有多个菜单。 图 3. 具有一些菜单的 RCP 应用程序 单击 Window > Open Perspective > Other。在 Select Perspective 对话框中，您将会看到一个名为 Plte Perspective (default) 的透视图。这是您使用 Hello RCP 模板创建的透视图。 单击 Window > Show View > Other。您将看到一个空的 Show View 对话框。这是因为您还没有将任何首选项添加到 RCP 应用程序。我们将在下一节中做到这一点。 单击 Window > Preferences。您将会看到 Preferences 对话框。这是因为您还没有将任何 preference 添加到 RCP 应用程序。我将在下一节中做到这一点。 单击 Help > About。About 对话框除了三个按钮，什么都没有。About 对话框提供关于安装在您的 RCP 应用程序中的特性和插件集合的信息。因为您还没有添加任何特性，所以对话框是空的。 单击 Plug-in Details。对话框将显示作为 RCP 应用程序一部分的插件的完全列表。我们将看到 10 个 RCP 插件，以及我们创建的一个插件。 单击该对话框中的 com.ibm.plte 插件，注意到 More Info 按钮是被禁用的。More Info 提供有关插件的附加信息。如果您希望提供有关您的插件的附加信息，您需要将其添加到 about.html 文件中。我们将在下一步做到这一点。 图 4. Hello World RCP 应用程序中包含的插件 我们没有执行的动作是 Help > Help Contents。这需要许多没有包含在 Hello World RCP 应用程序中的 Help 插件。因此，该动作直到添加了必需的 Help 插件才会运行。我们将在下一节做到这一点。 回页首 步骤 4：向最小的 Hello World RCP 应用程序添加插件信息 这里，您通过 about.html 文件提供插件的有关信息： 将 about.html 从 com.ibm.plte.help 特性项目移动到 com.ibm.plte 插件。 确保已关闭先前打开的 RCP 应用程序。返回到 com.ibm.plte (plugin.xml) 编辑器的 overview 页面，并单击 Testing 部分的 Launch an Eclipse application。 单击 Help > About。 单击 Plug-in Details。 选择 com.ibm.plte 插件。More Info 按钮将启用。 单击 More Info，about.html 将打开在浏览器中。 图 5. com.ibm.plte 插件的描述