開發您的第一個 Eclipse RCP 應用程序(6/12)

 

Eclipse V3.1 使得創建富客戶機應用程序比以前更加容易

第 6 頁，共 12 頁

對本教程的評價

幫助我們改進這些內容

創建一個 RCP 產品

創建 Hello World RCP 產品

用 Eclipse 術語來講，產品是伴隨您的應用程序的所有東西，包括所依賴的其他插件、特性、一個運行應用程序的命令（稱作本機啓動程序）和任何使您的應用程序與衆的不同烙印（圖標等）。

在 Eclipse 裏有兩種烙印：特性級的和產品級的。不存在用於定義特性烙印的擴展點。該過程包括將特性烙印文件放入插件中，然後在特性定義 (feature.xml) 中定義該插件。如果特性 ID 與插件 ID 相同，則不必在特性定義中定義插件。在本節中，您將烙印一個名爲 com.ibm.plte 的特性。注意，該特性與插件 com.ibm.plte 具有相同的 ID。

產品烙印是通過 org.eclipse.core.runtime.product 擴展點實現的。Eclipse 提供 Product Configuration 編輯器來幫助創建產品擴展點。您必須設置該擴展點的一個屬性就是產品名。您將定義產品名爲 com.ibm.plte.product。注意，儘管 RCP 是在 Eclipse V3.0 中引入的，但 Product Configuration 功能卻是到 Eclipse V3.1 纔出現的。您也可以在 V3.0 中手動創建 RCP 產品，但是這要複雜得多。

注意，因爲 Eclipse IDE 是一個 RCP 應用程序，所以它也定義了該產品擴展點。Eclipse IDE 定義的產品名是 org.eclipse.sdk.ide。

爲烙印 Hello World RCP 應用程序，該教程提供了很多烙印特定的文件。下表顯示了商標文件與被烙印的 RCP 應用程序之間的對應關係。

表 3. 用於定製 Hello World RCP 應用程序的示例烙印文件的描述

icons/jdg2eAbout.gif	定製 About 對話框：
icons/jdg2eProd.gif	定製窗口系統圖像：
splash.bmp	定製 splash 屏幕：
about.ini about.properties icons/jdg2eFeat.gif	這些文件定製特性烙印。about.ini 爲 com.ibm.plte 特性定義將顯示在 About 對話框中的圖像和 About 信息。about.properties 文件提取顯示文本，以便將文本翻譯出來。

回頁首

步驟 1：烙印一個特性並創建一個 Hello World RCP 產品

實現步驟：

1. 從 com.ibm.plte.help 特性項目，將下列文件夾/文件移動到 com.ibm.plte 插件項目：
   • icons folder
   • splash.bmp
   • about.ini
   • about.properties
2. 右鍵單擊 com.ibm.plte 項目並選擇 New > Product Configuration，以打開 New Product Configuration 對話框。
3. 在 File name 文本域輸入 plte.product。
4. 選中 Use a launch configuration 單選按鈕並單擊 Finish。plte.product 編輯器將會打開。
5. 在 plte.product 編輯器的 overview 頁面上，單擊 Product ID 旁邊的 New。New Product Definition 對話框將會打開。
6. 選擇 com.ibm.plte 項目作爲 Defining Plug-in。
7. 在 Product ID 文本域輸入產品並單擊 Finish。
8. 在 Product Name 文本域輸入 PLTE。
9. 選中 Features 單選框。
10. 切換到 Configuration 頁面。
11. 單擊 New Feature。New Feature 嚮導將打開。
12. 在 Project name 文本域輸入 com.ibm.plte-feature 並單擊 Next。
13. 將 Feature ID 修改爲 com.ibm.plte 並單擊 Next。
14. 選擇插件 com.ibm.plte 和 com.ibm.plte.ui，然後單擊 Finish。com.ibm.plte (feature.xml) 編輯器將打開。
15. 切換到 Information 頁面，然後再切換到 License Agreement 頁面。將 Optional URL 文本域的內容修改爲 license.html。
16. 切換到編輯器的 Included Features 頁面並單擊 Add。
17. 選擇特性 com.ibm.plte.help 和 org.eclipse.rcp，然後單擊 OK。保存 feature.xml。
18. 回到 plte.product 編輯器並切換到 Branding 頁面。
19. 在 Launcher Name 文本域輸入 plte。
20. 選擇針對 splash 屏幕的 com.ibm.plte 插件。
21. 對於 16x16 窗口圖像，選擇 com.ibm.plte/icons/jdg2eProd.gif。
22. 對於 About 對話框圖像，選擇 com.ibm.plte/icons/jdg2eAbout.gif。
23. 在 Text 文本域輸入 This is a sample PLTE application。
24. 保存 plte.product。
25. 將 license.html 從 com.ibm.plte.help 特性項目移動到 com.ibm.plte 特性項目。

回頁首

步驟 2：運行 Hello World RCP 產品

實現步驟：

1. 確保已關閉先前打開的 RCP 應用程序。轉到 plte.product 的 overview 頁面並單擊 Launch the product。在 RCP 應用程序打開之前，您將看到一個 splash 屏幕。檢驗應用程序如圖 16 所示。注意，RCP 應用程序的左上角有您在 plte.product 中指定的圖像。
   
   圖 16. Hello World RCP 應用程序
   
   
   
2. 單擊 Help > About PLTE。最初，這個 Action 名被標爲 About，但是現在附加上了您在 plte.product 中定義的產品名。因爲應用程序現在包含特性，所以 About 對話框提供了有關您的應用程序的附加信息。About 對話框與下圖類似。注意，由於存在一個 bug，所以 Feature Details 按鈕只顯示 org.eclipse.rcp 特性，而不顯示 com.ibm.plte 特性。只有已經烙印過的特性纔會顯示在 Feature Details 對話框中，所以您將看不到 com.ibm.plte.help 特性。當您在下一節中導出並運行該 RCP 應用程序時，您將看到 com.ibm.plte 特性。
   
   圖 17. Hello World RCP 應用程序的 About 對話框