Eclipse Ganymede RCP 開發入門：環境建置、Subversion 與專案建立（上）

教程簡介

Eclipse Ganymede 發行版包含 24 個獨立專案。本系列三部曲介紹新特性：RCP（桌面）、RAP（Web）、eRCP（行動裝置），以及 Subversion 版本控制與 p2 更新安裝。第 1 部分（本教程）涵蓋 RCP 新特性、Subversion 整合、p2 打包分發系統。為示範新特性，您將開發簡單 RCP 應用程式——備忘記事本，並用其探索新功能。

適用對象與先備知識

適合想了解 Ganymede 新功能的 Eclipse 開發者，以及有興趣使用通用程式碼庫開發多平台部署應用程式的人員。需會使用 Java 程式設計，熟悉 Eclipse 平台與外掛模型。

系列架構

• 第 1 部分：RCP 新特性、Subversion 整合、p2 打包分發（本教程）
• 第 2 部分：引入 Rich Ajax Platform (RAP) 撰寫 Web 應用
• 第 3 部分：使用 embedded RCP (eRCP) 開發行動裝置應用

核心主題

• 下載安裝 Ganymede 軟體包
• 設定 Subversion 用戶端並儲存原始碼
• 設定目標平台並切換作業系統（如 Mac OS X 到 Windows Vista）
• 建立應用程式模型與使用者外掛
• 使用 p2 建立產品定義、打包分發應用程式

系統需求

• Eclipse Ganymede（Eclipse Foundation）
• Java 2 Standard Edition V5+（Sun Microsystems）

開始使用 Ganymede

下載 Ganymede

Ganymede 代表 Eclipse 下一增量版本，意味著全新安裝。Eclipse 網站提供比較圖表（見圖 1）供選擇適合開發需求的套件。本系列目的下載 RCP/Plug-in 版本，包含開發部署 RCP 應用程式所需一切（見圖 2）。選擇適用作業系統版本、鏡像站下載（檔案近 200 MB，請耐心）。

安裝與啟動

下載完成解壓縮至所需安裝位置，雙擊 Eclipse 啟動。選擇工作空間，顯示歡迎頁面。選擇 Workbench 圖示（歡迎畫面最右側箭頭，見圖 3）進入工作台。

下節將介紹 RCP 的增量改進。注意：雖然安裝了 Ganymede，但並非所有 Ganymede 套件皆隨安裝包自動分發。Subversion 因授權限制需從 Eclipse 內單獨下載安裝。

使用 Subversive 外掛進行 Subversion 版控

原始碼控制是重要軟體開發工作的核心，尤其支援跨地域分散式團隊開發。Subversion 是開源版控系統，被視為 CVS 繼任者。Eclipse 的 Subversion 支援多年來透過第三方外掛提供，最流行為 Subversive。Ganymede 專案接手 Subversive 開發並加入核心庫，但未解決的法律問題阻止其隨安裝包分發，仍需從 Eclipse 內單獨安裝。

安裝 Subversive

Subversive 分兩部分，皆需單獨安裝：

1. Subversive 外掛本身：提供整合 Subversion 到 Eclipse 的 UI 元素。
2. 連接器庫：單獨開發授權。

安裝步驟：

1. 瀏覽 Help > Software Updates，選 Available Software 點擊 Add Site。
2. Location 輸入 https://download.eclipse.org/technology/subversive/0.7/update-site/ 點擊 OK。
3. 再次 Add Site 加入連接器位置：https://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/。
4. 選擇標示 SVN Team Provider 與 Subversive SVN Connectors 的外掛，點擊 Install。
5. 完成標準安裝畫面（含授權條款），提示時重啟工作區。

設定儲存庫

Subversion 如 CVS 為基於伺服器的原始碼庫，適合分散式團隊協作。伺服器部分不屬 Eclipse，架設超出本教程範圍，但有多種方式運行（如使用 Apache）。

擁有可用 Subversion 伺服器後，設定專案使用 Subversive 管理原始碼：

1. Package Explorer 高亮專案名稱，右鍵 Team > Share Projects。
2. 選擇 SVN（Subversion 縮寫，添加 Subversive 時啟用），點擊 Next。
3. 輸入伺服器 URL 與認證，接受後續畫面預設值，點擊 Finish。

Eclipse 顯示提交畫面（見圖 10），專案所有檔案預設勾選，可選擇不簽入特定檔案。輸入初始簽入註釋（良好習慣），點擊 OK。備忘記事本程式碼需全選。

若使用 Subversion WebDAV 版本（如透過 Apache），可用瀏覽器檢視儲存庫結構：輸入相同 URL 與認證，透過超連結瀏覽目錄樹。

Package Explorer 現顯示專案已與 Subversion 綁定，每個檔案旁有修訂編號，專案名旁有儲存庫名稱。

使用儲存庫程式碼

如 CVS，可從 Team 上下文選單存取 Subversion 功能。常用命令（見圖 13）：

• Commit：儲存儲存庫變更
• Update：用儲存庫最新內容重新整理本地副本
• Revert：放棄變更並用儲存庫最新內容取代
• Add to Version Control：在儲存庫標記新建立的本地檔案（需 Commit 才提交至伺服器）

刪除檔案：從 Package Explorer 正常刪除，再提交父目錄。Commit 前可檢查所有變更。Subversion 採樂觀鎖定：本地自由編輯，完成後簽入，衝突於簽入時解決。

在 Ganymede 中建立 RCP 應用程式

使用 Eclipse 精靈建立 RCP 框架、加入邏輯程式碼並運行，建立簡單單視圖 RCP 應用程式——備忘記事本。

建立 RCP 應用程式框架

1. File > New > Project，選擇 Plug-in Project，點擊 Next。
2. 專案命名 com.devworks.tutorial.po（Personal Organizer），使用預設位置。勾選 Create a Java Project，保留 src/bin 資料夾名稱。Target Platform 選 Eclipse version 下拉選 3.4。Add project to working sets 留空，點擊 Next。

繼續 Plug-in Content 畫面（見圖 15），輸入外掛資訊寫入 Manifest：

• Plug-in ID：com.devworks.tutorial.po
• Version：1.0.0
• Name：Po Plug-in
• Provider：DEVWORKS
• Execution Environment：JavaSE-1.6
• 勾選 Generate an activator...，Activator 類別名 com.devworks.tutorial.po.Activator
• 勾選 This plug-in will make contributions to the UI
• Enable API Analysis 留空
• Would you like to create a rich client application? 選 Yes，點擊 Next。

選擇 RCP Application with a View 範本（專案有視覺元件），點擊 Next。

最後畫面 Single View RCP application（見圖 18）：

• 應用程式視窗標題：Personal Organizer
• Java 套件名稱保留預設 com.devworks.tutorial.po
• 應用程式類別命名：TaskOrganizerApplication
• 勾選 Add branding（啟動時顯示啟動畫面）
• 點擊 Finish。

Eclipse 詢問是否切換至 Plug-in Development 透視圖（包含所需所有視圖），選 Yes。精靈完成產生單視圖 RCP 範本檔案與標準目錄結構。

範本檔案概覽

Package Explorer src 下列出範本檔案功能：

• Activator：外掛啟動點
• TaskOrganizerApplication：實作 Application 定義生命週期
• ApplicationActionBarAdvisor：管理視窗動作生命週期
• ApplicationWorkbenchAdvisor：初始化透視圖
• ApplicationWorkbenchWindowAdvisor：視窗視覺層面（大小、狀態列、選單列等）
• Perspective：應用程式可見視圖與編輯器
• View：含三個元素的簡單 Table Viewer

icons 資料夾含圖示位圖資源；splash.bmp 為啟動畫面圖形。範本檔案是建立 RCP 外掛的絕佳起點，實際上已形成完整應用程式（雖功能簡單），可立即運行：Package Explorer 高亮專案名稱，右鍵 Run As > Eclipse Application，見到啟動畫面後出現帶三元素的樹狀視圖。

撰寫備忘記事本程式碼

備忘記事本提供任務列表畫面，每項任務含描述、優先級、擁有者、完成百分比。具備新增/刪除任務按鈕與關閉應用程式按鈕。預先填充十個範例任務。為簡單起見，輸入資料不持久化於會話間。程式碼細節非教程重點，建議下載原始碼。許多範本檔案無需更改，主要修改視圖相關檔案。

1. 在 View 套件下建立新套件，將範本建立的 View 類別移入並重命名為 PersonalTaskView。
2. 編輯 META-INF/MANIFEST.MF 切換 Extensions 分頁（見圖 21），展開 org.eclipse.ui.views 高亮 View 類別，右側屬性改為 com.devworks.tutorial.po.view.PersonalTaskView，名稱改為 PersonalTaskView，儲存。

資料模型

模型物件稱為 PersonalTaskModel（見清單 1），定義任務結構、運行方法與初始範例資料。

PersonalTaskViewer

定義 TableViewer（保存任務列表的建構塊）。建立涉及：創建 TableViewer、加入 Content/Label Provider、初始化 PersonalTaskModel 設為 TableViewer 輸入（見清單 2）。

其他關鍵類別

• PersonalTaskContentProvider：提供 TableViewer 顯示元素，定義基本操作
• PersonalTaskLabelProvider：提供表格欄位標籤與圖示（見清單 3）
• TaskCellModifier：抽象方式從 CellEditor 存取資料模型
• PersonalTaskSorter：依排序類型比較元素（見清單 4）
• PersonalTaskView：擴展 ViewPart 的視圖類別（見清單 5）
• Perspective：在透視圖中顯示此視圖（見清單 6）

運行應用程式（Run > Eclipse Application），啟動畫面後見到預先填充範例任務的任務管理器。

恭喜！已建立可在桌面環境運行的簡單 RCP 外掛。

建立產品定義

舊版 RCP 分發外掛限於目標目錄可用項目。Ganymede 可精確指定所需外掛，獲得更精確分發版。本節打包應用程式，僅含運行所需內容。

設定目標環境

1. Package Explorer 高亮專案名稱，右鍵 New > Product Configuration。
2. 父資料夾 com.devworks.tutorial.po，檔名 TaskOrganizer.product。Initialize the file content 選 Create a configuration file with basic settings，點擊 Finish。

Eclipse 建立 TaskOrganizer.product，編輯器顯示 Overview 分頁配置範本：

• 應用程式標題列名稱：Personal Organizer
• 產品識別碼：com.devworks.tutorial.po.product
• 版本：1.0.0
• 應用程式：com.devworks.tutorial.po.application（從下拉選單選擇）
• 配置基於外掛：選擇單選按鈕

切換 Configuration 分頁添加所需外掛（見圖 25）：點擊 Add 選擇 com.devworks.tutorial.po。外掛顯示於清單（見圖 26）。點擊 Add required plug-ins，Eclipse 自動添加所有從屬外掛（見圖 27）。

下節將介紹 Launching、Splash、Branding 分頁設定、產品匯出、跨平台部署與 p2 分發。