RCP开发指南

2. Viewer,编辑器,透视图类参照starteam上面的ppt文档《RCP技术交流（贾增辉）》 3. 创建首选项 创建首选项类

public class DBPreferencePage extends PreferencePage implements IWorkbenchPreferencePage

protected Control createContents(Composite parent) protected void performDefaults() protected void performApply() public boolean performOk() 创建菜单项

在plugin.xml文件加入首选项扩展点

4. 帮助系统的开发

开发基于Eclipse开的RCP软件可以直接加入Eclipse的帮助系统，使您的产品更加完善。

1. 添加帮助的菜单。

在ApplicationActionBarAdvisor类中加入帮助菜单项。代码片断如下：

//帮助

private IWorkbenchAction helpAction; /** * 创建操作 */

protected void makeActions(IWorkbenchWindow window) { /* 帮助 */

helpAction = ActionFactory.HELP_CONTENTS.create(window); register(helpAction);

} /**

* 填充主菜单 */

protected void fillMenuBar(IMenuManager menuBar) { /* 主菜单栏 */

IMenuManager mainMenu = getActionBarConfigurer().getMenuManager(); MenuManager helpMenu = new MenuManager(\帮助(&H)\

helpMenu.add(introAction); helpMenu.add(helpAction); mainMenu.add(helpMenu); }

2. 添加相关的依赖项。

打开plugin.xml，转到\依赖项\的tab页,点击\添加\按钮，需要加入下面的这些依赖项：

1. org.apache.lucene

2.org.eclipse.help.appserver 3.org.eclipse.help.base 4.org.eclipse.help.ui

5.org.eclipse.help.webapp 6.org.eclipse.tomcat 7.org.eclipse.ui.forms

3. 添加org.eclipse.help.toc扩展点

这个非常容易，转到\扩展\页，点击“添加”按钮。选择\扩展向导\帮助内容\，确定后可以看到“所有扩展”的列表中多了一个org.eclipse.help.toc扩展，这里可能需要修改一下，生成的toc.xml和testToc.xml里面的label属性标签不能是乱码，不然帮助框架会读不出，到时候显示不出帮助的组织结构。结构如下：

point=\

file=\ primary=\

新建自己的帮助文档如toc.xml和testToc.xml

4实现上下文帮助

文帮助是用户在任何界面下，点击F1（windows）或者单击菜单中的动态帮助，出现和当前界面相关联的帮助提示等。

首先，你需要为上下文指定一个ID，这个ID在后面会匹配到帮助内容的某一项或者几项。我们这里为RCP示例的“FirstView”视图创建一个上下文帮助，这需要修改FirstView.java 这个文件，在这个类的createPartControl方法中添加：

PlatformUI.getWorkbench().getHelpSystem().setHelp(top, \\

注意这里的第二个参数，是由文档插件ID+下面xml中id组成。

然后指定了上下文ID以后，就需要在帮助内容中添加与之相应的内容了。 在上面创建的org.example.rcp.ocntent项目下，创建一个文件”contexts.xml”，内容如下：

This is the sample context-sensitive help.

然后需要把这个内容和上面的ID联系起来，这需要用到org.eclipse.help.contexts扩展点，这个扩展点需要指定的值就是刚刚创建的那个文件。 在扩展页面中

1. 点击添加，选择org.eclipse.help.contexts 这个扩展点（注意需要把下面的复选框取消选中才能看到这个扩展点）。

2.新舰载机的扩展,并在file一项中，选择刚才创建的那个文件。

另外，在FirstView.java文件中，做如下修改，即在setFocus()方法中，保证使top获得焦点，以使系统把正确的上下文传递给帮助系统，需要的修改参考下面代码：

private Composite top;

public void createPartControl(Composite parent) { top = new Composite(parent, SWT.NONE); }

public void setFocus() { top.setFocus(); }

五、 RCP项目打包与发行

在RCP项目中有一种扩展名为product的文本文件，它可以用来配置RCP项目，为RCP指定窗口图标、提供以项目方式运行RCP程序、提供RCP项目的导出向导。当然更专业的做法是用Ant脚本来打包导出，也可先用product导出RCP项目，然后再根据导出结果的目录结构和文件内容来编写Ant脚本。下面开始介绍RCP项目的打包发行：

在项目上点右键，创建产品配置文件：

输入产品配置文件名，选择“Use a launch configuration”运行项以便节省后期工作：