Eclipse4.x插件开发实践02-源码使用指南

插件创建向导本身会创建一份标准的插件工程目录结构， “Hello，World”模 板则演示了扩展点 org.eclipse.ui.actionSets 的使用， 它创建一个简单的 action set， 该 action set 在菜单栏（menu bar）上添加了一个菜单，在工具栏（tool bar）添 加了一个按钮，同时添加了一个供新增菜单的菜单项和工具栏按钮调用的 action。 除了“Hello，World”模板，还有“Hello，World Command”等 10 个模板供
源码使用指南
Eclipse4.x 插件开发实践系列
Eclipse4.x 插件开发实践-源码使用指南
Eclipse 是一个开源的、 高度可扩展的集成开发工具和开发平台，其本身蕴含 了诸多大牛们的架构思想和最佳实践。 鉴于阅读高质量的源代码一直都是快速提 高编程水平的有效手段之一，作为一名 Eclipse 插件开发者，认真学习 Eclipse 自 带的典型示例、深入研究 Eclipse 核心插件源码可以显著降低学习曲线的坡度。 “Eclipse4.x 插件开发实践系列”的第二篇专注于 Eclipse 核心源码的使用， 将引导您：
第 1 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
1. 插件创建向导
1.1. 背景资料
在“Eclipse4.x 插件开发实践系列”第一篇“插件开发起步”中，我们已经 使用插件创建向导完成了第一个插件工程的创建， 当时我们选择了 “Hello， World” 模板，在模板选择页上可以看到它的概述信息（如下图） 。
第 3 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
“com.archopt.rcp.hello2” ，其他设置不变，然后点击 Next 按钮； 3. Eclipse 显示“Content”向导页（可配置插件工程必需参数） ，直接点击 Next 按钮转到“Templates”向导页（点选典型示例模板） ，在左侧选中 “Custom pulg-in wizard” ，点击 Next 按钮。
第 5 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
6. Eclipse 完成插件工程的创建， 并打开插件工程的 MANIFEST.MF 文件显示 概览页（Overview） 。将工作区（workspace）的 com.archopt.rcp.hello 工 程（插件开发起步课程演练时创建）置为关闭状态（右键菜单 Close Project） 。 7. 点击工具栏“调试”按钮侧边下拉菜单触点，选择“Eclipse Application” 菜单项，将启动新的 Eclipse 实例（称之为调试实例，开发环境对应于开 发实例） 。
1.2. 实战演练
1. 启动 Eclipse，切换至插件开发透视图（Plug-in Development） ，点击工具 栏“新建”按钮侧边下拉菜单触点，在弹出菜单中选择“Plug-in Project” 菜单项。
2. Eclipse 弹 出 插 件 工 程 创 建 向 导 主 界 面 ， 指 定 Project name 值 为
第 6 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
8. Eclipse 调试实例的菜单栏上多了一个名为“Sample Menu”的菜单，其 下包含一个名为“Sample Command”的菜单项，工具栏上多了一个名 为“Say hello world(Ctrl+6)”的按钮（鼠标悬浮可查看按钮文本） 。
4. Eclipse 显示“Template Selection”向导页（聚焦于扩展点的典型示例模 板清单） ，勾选“Hello world command contribution” ，点击 Next 按钮。
第 4 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
5. Eclipse 显示“Simple Command Contribution”向导页，将“信息框文本” （Message Box Text） 内容调整为 “Hello, Eclipse world from command !” ， 点击“Finish”按钮。
第 2 页，共 30 页
源码使用指南
Eclipse4.x 插件开发实践系列
选择，模板清单中的第一项“Custom pulg-in wizard”并非模板，而是一个定制向 导， 引导开发者以多选的方式完成典型示例代码的创建， 下面我们将演练 “Custom pulg-in wizard”的使用。
小贴士：actionSets 扩展点主要用于在 Workbench 窗口的公共区域添加菜单、菜单项以及工 具栏按钮，action set 是我们定制透视图（WindowCustomize Perspective…）时可供选择的 逻辑单元。需要特别说明的是，actionSets 扩展点在 Eclipse4.x 中已被弃用，后续版本中将会 移除，官方建议使用 org.eclipse.ui.commands 替代。
1.
使用 Eclipse 插件向导完成典型示例的创建 基于典型示例初步掌握 Workbench 插件的部分关键扩展点 以“导入插件” （Import Plugins）的方式创建插件工程 快速检索 Eclipse 插件制品（Artifact） 目录
2.
Hale Waihona Puke Baidu
3.
4.
5.
插件创建向导........................................................................................................................... 2 1.1. 背景资料....................................................................................................................... 2 1.2. 实战演练....................................................................................................................... 3 1.3. 演练小结....................................................................................................................... 7 1.4. 模板概览....................................................................................................................... 9 扩展项配置页......................................................................................................................... 11 2.1. 背景资料..................................................................................................................... 11 2.2. 实战演练..................................................................................................................... 12 2.3. 演练小结..................................................................................................................... 16 插件源码导入......................................................................................................................... 17 3.1. 背景资料..................................................................................................................... 17 3.2. 实战演练..................................................................................................................... 19 3.3. 演练小结..................................................................................................................... 23 3.4. 官方示例..................................................................................................................... 24 插件快速检索......................................................................................................................... 25 4.1. 背景资料..................................................................................................................... 25 4.2. 实战演练..................................................................................................................... 26 4.3. 演练小结..................................................................................................................... 29 结束语..................................................................................................................................... 30 5.1. 课程总结..................................................................................................................... 30 5.2. 学习建议..................................................................................................................... 30