Posted on 2007-10-25 10:30
寒武紀(jì) 閱讀(8943)
評論(3) 編輯 收藏 所屬分類:
Eclipse
開發(fā)基于Eclipse開的RCP軟件可以直接加入Eclipse的幫助系統(tǒng)，使您的產(chǎn)品更加完善。Eclipse幫助系統(tǒng)提供的良好組織模式以及基于lucene的全文搜索功能。在Eclipse的網(wǎng)站上有一篇文章專門介紹如何為Mail示例RCP添加幫助系統(tǒng)的，但是寫的不完全，按照里面的說明添加后無法正常地顯示幫助框架。網(wǎng)上有少部分文章也提及這個主題，但是都沒有說明白。
經(jīng)過一翻摸索，最后終于折騰出來，在這里記錄下面，與大家分享。如果你做過RCP產(chǎn)品，下面這些內(nèi)容應(yīng)該很熟悉。
1. 添加幫助的菜單。
在ApplicationActionBarAdvisor類中加入幫助菜單項(xiàng)。代碼片斷如下：
//幫助
private IWorkbenchAction helpAction;
/**
* 創(chuàng)建操作
*/
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)", IWorkbenchActionConstants.M_HELP);
helpMenu.add(introAction);
helpMenu.add(helpAction);
....
mainMenu.add(helpMenu);
}
2. 添加相關(guān)的依賴項(xiàng)。
打開plugin.xml，轉(zhuǎn)到"依賴項(xiàng)"的tab頁,點(diǎn)擊"添加"按鈕，需要加入下面的這些依賴項(xiàng)：
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擴(kuò)展點(diǎn)
這個非常容易，轉(zhuǎn)到"擴(kuò)展"tab頁，點(diǎn)擊“添加”按鈕。網(wǎng)上或是相關(guān)的書籍有很多關(guān)于添加help內(nèi)容的介紹，為了節(jié)省篇幅，這里直接添加一個擴(kuò)展向?qū)硗瓿伞＿x擇"擴(kuò)展向?qū)?-->"幫助內(nèi)容"，確定后可以看到“所有擴(kuò)展”的列表中多了一個org.eclipse.help.toc擴(kuò)展，這里可能需要修改一下，生成的toc.xml和testToc.xml里面的label屬性標(biāo)簽不能是亂碼，不然幫助框架會讀不出，到時候顯示不出幫助的組織結(jié)構(gòu)。
結(jié)構(gòu)如下：
<extension
point="org.eclipse.help.toc">
<toc file="toc.xml"/>
<toc
file="testToc.xml"
primary="true"/>
</extension>
4. 部署產(chǎn)品配置
為您的RCP添加一個產(chǎn)品配置，打開產(chǎn)品配置編輯器（xxx.product），轉(zhuǎn)到"配置"tab頁，點(diǎn)擊“添加”，加入你的插件，然后點(diǎn)擊“添加必需的插件”,這樣在“插件和段”列表會看到你的插件以及你的RCP要完整啟動的所有必需相關(guān)插件。在這里你應(yīng)該看到你在plugin.xml中依賴的那七個help相關(guān)的插件，以及一些以nl1結(jié)尾的插件，這些是語言插件。保存，轉(zhuǎn)到“概述”tab頁，點(diǎn)擊"啟動產(chǎn)品"。然后打開“幫助--> 幫助內(nèi)容”，就可能看到你的幫助系統(tǒng)了。
到此一個完整的幫助系統(tǒng)就完成了。下面是一個截圖：
剛進(jìn)場的時候戲就落幕