開發您的第一個 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 插件的描述