您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Eclipse 插件開發極速入門：從架構理解到圖形化編輯器實戰

編輯：Java 相關知識

Eclipse 不只是 IDE，更是一個由微小核心 + 海量插件構成的豐富客戶端平台 (RCP)。本文為有 Java/SWT 基礎的開發者提供插件開發全景圖：架構認知、環境搭建、PDE 向導實戰、GEF/Draw2D 圖形化編輯器入門、部署發布。

Eclipse 架構核心認知

Eclipse 分層類庫架構

層級	組件	核心作用	獨立使用
基礎圖形	SWT (Standard Widget Toolkit)	原生操作系統組件映射：Button, Table, Tree, Canvas... 替代 Swing	✅ 可構建獨立桌面應用
UI 框架	JFace	Viewer/Provider 模式、對話框、向導、動作、資源管理器	✅ 依賴 SWT
插件基礎設施	PDE (Plugin Development Environment)	Manifest 管理、擴展點聲明、構建腳本、啟動配置	❌ 僅開發時
Java 開發工具	JDT (Java Development Tools)	AST 解析、重構引擎、編譯器、搜索引擎	✅ 程序化操作 Java 代碼
圖形化編輯	Draw2D	輕量級繪圖：Figure、Layout、Router、輸出 SVG/圖片	✅ 獨立繪圖庫
圖形化編輯框架	GEF (Graphical Editing Framework)	MVC 控制器、編輯域、調色板、命令堆棧、拖拽、對齊	❌ 依賴 Draw2D+JFace

環境搭建與目標平台配置

下載 Eclipse SDK (含 PDE)，解壓至 C:\dev\eclipse
安裝 GEF + Draw2D Runtime：
- 下載 GEF-SDK-3.x.zip 解壓到 Eclipse 根目錄 (合併 plugins/features)
- 或 Help → Install New Software 添加 GEF 更新站點安裝
配置目標平台：Window → Preferences → Plug-in Development → Target Platform，確保包含 RCP/GEF 特性
切換透視圖：Window → Perspective → Open Perspective → Plug-in Development

插件開發透視圖

實戰：創建「Invokatron」多頁面編輯器插件

1. 新建插件項目向導

File → New → Plug-in Project

項目名：Invokatron
Activator 類：invokatron.InvokatronPlugin
模板選擇：自定義插件 → 勾選 Multi-page Editor、New File Wizard、Property Pages

2. 編輯器配置 (關鍵參數)

多頁面編輯器設置

包名：invokatron.editor
編輯器類：InvokatronEditor
貢獻類：InvokatronEditorContributor
編輯器名稱：Invokatron Editor
文件擴展名：invokatron

3. 向導配置

新建向導設置

包名：invokatron.wizard
向導類：InvokatronWizard
頁面類：InvokatronWizardPage
初始文件名：MyClass.invokatron

4. 屬性頁配置

屬性頁設置

包名：invokatron.properties
頁面類：InvokatronPropertyPage
目標類型：org.eclipse.core.resources.IFile (針對文件顯示)

5. 生成結構解析

Invokatron/
├── META-INF/
│   ├── MANIFEST.MF          # OSGi 元數據：依賴、導出包、Activator
│   └── plugin.xml           # 核心：擴展點聲明 (編輯器、向導、屬性頁、菜單)
├── build.properties         # 構建輸出配置：源碼輸出、二進制輸出、額外資源
├── src/
│   ├── invokatron/
│   │   ├── InvokatronPlugin.java
│   │   ├── editor/
│   │   │   ├── InvokatronEditor.java           # 繼承 MultiPageEditorPart
│   │   │   ├── InvokatronEditorContributor.java
│   │   │   └── pages/                          # 文本頁、屬性頁、預覽頁
│   │   ├── wizard/
│   │   │   ├── InvokatronWizard.java           # 繼承 Wizard
│   │   │   └── InvokatronWizardPage.java
│   │   └── properties/
│   │       └── InvokatronPropertyPage.java     # 繼承 PropertyPage
│   └── sample.gif                              # 菜單圖標
└── plugin.xml (可視化編輯器同步編輯)

運行與調試：Runtime Workbench

插件編輯器 Overview 頁 → Launch an Eclipse Application (或 Debug)
啟動獨立 Eclipse 實例 (工作區 runtime-workbench-workspace)
新建 Java Project → File → New → Other → Invokatron Wizard
生成 .invokatron 文件 → 自動打開三頁籤編輯器：文本編輯 / 屬性(字體) / 預覽

運行時工作台效果

構建配置深度解析：build.properties 四大區塊

區塊	用途	典型內容
Runtime Information	運行時類路徑 JAR	`bin.invokatron.jar` (編譯輸出打包)
Source Build	源碼構建輸入	`src/`、`META-INF/`、`plugin.xml`、`sample.gif`
Binary Build	導出產物包含文件	`sample.gif`、`plugin.xml`、`MANIFEST.MF`、`bin.invokatron.jar` (勾選自動)
Exact Classpath Entries	編譯期依賴 JAR	第三方庫 JAR (需同時加入 Source Build)

常見錯誤：在 Java Build Path 和 Exact Classpath 重複添加 JAR → 重複類定義。

依賴管理與擴展點

MANIFEST.MF → Dependencies：聲明 Require-Bundle (如 org.eclipse.ui, org.eclipse.gef)
plugin.xml → Extensions：貢獻功能點
- org.eclipse.ui.editors → 編輯器關聯文件擴展名
- org.eclipse.ui.newWizards → 向導分類
- org.eclipse.ui.propertyPages → 屬性頁目標類型
- org.eclipse.ui.menus → 菜單/工具欄貢獻

導出部署三種模式

最佳學習資源：官方示例代碼庫

唯一推薦：Eclipse 官網下載頁 → Example Plug-ins (∼2MB)。解壓後源碼在：

模式	產物	安裝方式	適用場景
目錄結構	展開的 plugins/features	復制到 `eclipse/dropins/` 或修改 `links` 文件	開發自測、內部分發
單個 ZIP	`Invokatron-1.0.0.zip`	解壓到 Eclipse 根目錄	客戶交付、離線安裝
更新站點	`site.xml` + JARs	`Help → Install New Software → Add Site`	版本升級、在線安裝、P2 元數據

類別	代表示例	源碼位置
SWT 基礎	Browser, Controls, Layouts, Paint, OLE	`org.eclipse.swt.examples.*_src.zip`
Workbench/UI	Java Editor, Template Editor, Multi-page Editor, Property Sheet	`org.eclipse.ui.examples.*_src.zip`
GEF/Draw2D	Logic Diagram, Flow Diagram	`org.eclipse.gef.examples.*_src.zip`
JDT/Compare/Help/Team	Java Editor, XML Compare, CVS Sync	對應 `_src.zip`