本論文的內(nèi)容主要介紹了在Eclipse平臺上構(gòu)建您自己的產(chǎn)品的方法。
Eclipse平臺不必多做解釋了，它應(yīng)該是目前最熱門的開源的java開發(fā)工具之一了。而且，它的目標(biāo)是定義為一個工具集成平臺，這種插件式的架構(gòu)可以使眾多的工具提供廠商發(fā)布自己公司的基于Eclipse的產(chǎn)品，如IBM的workplace、borland公司的jbuilder2006 (Eclipse版)。
本文就是介紹如如何創(chuàng)建基于Eclipse產(chǎn)品。遵循Hello world的慣例，本文的例子是一個最簡單的RCP例子，它只有一個介紹頁面。它最主要的目的不是教您如何進(jìn)行插件的開發(fā)，而是介紹如何將您的插件打包成可分發(fā)的RCP產(chǎn)品。
創(chuàng)建您的RCP產(chǎn)品
在Eclipse 3.2中(事實(shí)上在Eclipse 3.1中,因?yàn)槲覀兿旅娴漠a(chǎn)品都是在Eclipse 3.2上開發(fā)的，所以統(tǒng)一都叫做3.2)，開發(fā)RCP（富客戶端程序）比較方便。在Eclipse3.0中，也可以開發(fā)RCP產(chǎn)品，但是還是有幾點(diǎn)不方便之處:必須手工config.ini文件，將您的product、application和閃屏等手工更改或者添加到config.ini文件。在Ecllipse3.2中，您可以添加一個product文件，配置您的閃屏所在的目錄、RCP產(chǎn)品運(yùn)行時的圖標(biāo)、關(guān)于對話框中產(chǎn)品圖片和文字、RCP產(chǎn)品的product和application、產(chǎn)品名稱、啟動器的名稱、包含的功能部件等。同時，在Eclipse 3.2中，還可以直接導(dǎo)出RCP產(chǎn)品，而在Eclipse 3.0中，您只能導(dǎo)出插件，而后放入到RCP平臺中。
下面，我們就以一個簡單的例子演示如果創(chuàng)建您自己的RCP產(chǎn)品。
生成一個簡單的RCP例子
打開Eclipse3.2，新建插件項(xiàng)目，項(xiàng)目名稱最好遵循約定俗稱的方式，因?yàn)閜lugin.xml中的插入點(diǎn)的id將根據(jù)這個項(xiàng)目名稱來生成（當(dāng)然您也可以手工更改）。
最下面是您的RCP產(chǎn)品發(fā)布時選擇哪一個Eclipse平臺，這里選擇Eclipse 3.1。點(diǎn)擊下一步按鈕。
圖表 1
填寫您的插件的id、版本、名稱和提供商,選擇您的產(chǎn)品為RCP產(chǎn)品(相對Eclipse 3.0新增加的功能)。點(diǎn)擊下一步按鈕。
圖表 2
選擇您要采用的模板。通過模板，您可以快速的建立起您的project，當(dāng)然您也可以創(chuàng)建一個空的project，然后逐步添加相應(yīng)的文件。
在這個例子中，采用了一個帶有介紹頁面的模板。
在我們第一次啟動Eclipse時，通常會看到一個Eclipse的歡迎頁面。我們這個例子也演示了這個功能，當(dāng)別人第一次運(yùn)行我們的產(chǎn)品的時候，我們給他顯示一個產(chǎn)品介紹的頁面，用戶將來也可以在幫助菜單中選擇顯示這個頁面。
這里之所以采用這個模板是為下一片文章埋下伏筆，下一片文檔將重點(diǎn)介紹Eclipse的介紹頁面。點(diǎn)擊下一步按鈕。
圖表 3
在這一步中，需要填寫產(chǎn)品的id、產(chǎn)品名稱和application的id。并選擇歡迎界面的內(nèi)容是靜態(tài)的還是動態(tài)的，這里選擇是靜態(tài)的，將以xhtml格式文件提供介紹頁面。點(diǎn)擊下一步，project就建立了。
圖表 4
生成product配置文件 相對Eclipse3.0，最新的Eclipse產(chǎn)品提供了配置product產(chǎn)品的功能，如果配置了這個文件，就可以將您的這個產(chǎn)品直接導(dǎo)出成RCP產(chǎn)品。
選擇新建一個Product Configuration：
圖表 5
在接下來的對話框中填寫您的這個文件的名稱，以及如何初始化這個文件的內(nèi)容。這里選擇了我們正在開發(fā)的這個產(chǎn)品，您選擇第一項(xiàng)也沒關(guān)系，因?yàn)榭梢酝ㄟ^編輯器可視化的編輯。
圖表 6
點(diǎn)擊完成之后就會顯示這個文件的編輯器。這個編輯器有三個頁面，第一個頁面描述了這個產(chǎn)品的一些基本信息。剛才我們創(chuàng)建這個文件的時候選擇是基于這個產(chǎn)品創(chuàng)建，所以這里已經(jīng)填寫了我們產(chǎn)品的內(nèi)容。
圖表 7
第二個頁面顯示了我們這個產(chǎn)品發(fā)布時包含的功能部件以及程序運(yùn)行時的運(yùn)行時的參數(shù)。
圖表 8
第三個頁面時配置啟動程序的名稱、程序運(yùn)行時的圖標(biāo)、閃屏所在的插件以及關(guān)于對話框的圖片和文字。在這里先填寫啟動程序的名稱。
啟動程序是只調(diào)用startup.jar的那個exe文件。默認(rèn)是eclipse.exe，它負(fù)責(zé)查找jre、處理啟動時的參數(shù)以及調(diào)用starup.jar文件。
其他的配置在下面介紹。
圖表 9
圖表 10
創(chuàng)建產(chǎn)品的windows圖標(biāo) 看看我們的Eclipse，程序在運(yùn)行時圖標(biāo)是日食那個圖標(biāo)。如果我們要發(fā)布自己的產(chǎn)品，必然要采用自己的產(chǎn)品的圖標(biāo)。
首先準(zhǔn)備兩張gif圖片，一張是16×16的，一張是32×32的。在我們的project中創(chuàng)建一個icons文件夾，將這兩個圖片放到這個文件夾中。
圖表 11
雙擊plugin.xml文件，在編輯器中選擇build那一頁，在二進(jìn)制輸出選項(xiàng)中將icons選中，這樣在發(fā)布的時候就會同時將icons發(fā)布。
圖表 12
現(xiàn)在我們雙擊product文件(rcpapp.product)，選取第三頁(Branding)。配置Window Images這一節(jié)。
圖表 13
這樣，我們的程序在運(yùn)行時，將顯示我們的圖標(biāo)。
圖表 14
作者:smallnest
網(wǎng)址:http://www.kuaff.com
email:smallnest@gmail.com
創(chuàng)建產(chǎn)品About圖片和文字 在Eclipse的幫助菜單中，選擇“關(guān)于”(about)那一個菜單項(xiàng)，將顯示Eclipse產(chǎn)品信息。
圖表 15
如果我們要發(fā)布自己的產(chǎn)品，自然會想到顯示我們自己的圖片和信息。下面就介紹了如何替換成自己的圖片和文本信息。
首先將一個gif格式的產(chǎn)品圖片放入icons文件夾下，圖片的大小不能超過500×330像素，如果大于250×330像素，文本信息將不被顯示。
現(xiàn)在我們雙擊product文件(rcpapp.product)，選取第三頁(Branding)。配置About dialog這一節(jié)。
圖表 16
到目前為止，我們的程序只有一個菜單“Help”，而且菜單中只有一個菜單項(xiàng)“Help”,現(xiàn)在我們就需要將“About”菜單項(xiàng)添加到幫助菜單中。
可以通過下面的代碼將“About”菜單添加上。其中的aboutAction是我們現(xiàn)在才添加的代碼。
圖表 17
這樣，選擇“About”菜單時將顯示我們的產(chǎn)品信息。
圖表 18
替換閃屏現(xiàn)在讓我們做一個閃屏(Splash)，來替換掉project中那個臨時的splash.bmp文件。
圖表 19
替換完畢，雙擊rcpapp.product，在打開的編輯器選擇第三頁的Splash Screen這一節(jié)，選擇閃屏在哪個插件中。
圖表 20
事實(shí)上，閃屏圖片不一定就是splash.bmp圖片，您可以起隨便一個名字，不過這樣一來就需要修改config.ini文件，這里不多做介紹了。
定制產(chǎn)品的Theme
目前來講，我們的產(chǎn)品做的差不多了。如果直接運(yùn)行我們的產(chǎn)品，可以看到，那個Tab標(biāo)題欄不是我們在Eclipse 3.0以后看到的那種波浪型的樣式。我們可以通過配置文件的方式更改產(chǎn)品的樣式。
雙擊plugin.xml文件，在編輯器中打開“擴(kuò)展”那一頁，選擇擴(kuò)展點(diǎn)"org.eclipse.core.runtime.products"。
圖表 21
可以看到在我們的產(chǎn)品下已經(jīng)配置好了三個屬性：windowImages、aboutImage、aboutText?，F(xiàn)在我們增加一個屬性，點(diǎn)擊“Add”按鈕，增加屬性“preferenceCustomization”，它的值設(shè)為“plugin_customization.ini”。
圖表 22
可以在這里設(shè)置的屬性都是在接口org.eclipse.ui.branding.IProductConstants定義的。包括ABOUT_IMAGE 、ABOUT_TEXT、APP_NAME、PREFERENCE_CUSTOMIZATION、STARTUP_FOREGROUND_COLOR、STARTUP_MESSAGE_RECT、STARTUP_PROGRESS_RECT、WELCOME_PAGE、WINDOW_IMAGE（棄用)、WINDOW_IMAGES。
同時在我們的project下新增加一個文件plugin_customization.ini，它的內(nèi)容如下：
org.eclipse.ui/SHOW_TRADITIONAL_STYLE_TABS=false
org.eclipse.ui/DOCK_PERSPECTIVE_BAR=topRight
它的第一項(xiàng)就是設(shè)置我們的Tab的樣式，true是傳統(tǒng)樣式。我們設(shè)置為false。第二項(xiàng)是設(shè)置透視圖所在的位置，這里設(shè)置為右上，不過我們的產(chǎn)品中沒有顯示這個選擇，設(shè)不設(shè)無所謂。
事實(shí)上，在這個文件中可以定義的參數(shù)有上百個，可以通過Eclipse的javadoc中的
org.eclipse.platform.doc.isv/reference/api/constant-values.html
文件查找。配置方式為"包名/常量名=值"。
注意:現(xiàn)在雖然添加了plugin_customization.ini,但是在發(fā)布產(chǎn)品的時候還是不會將這個文件添加上去。所以您需要在plugin.xml文件的編輯器的build頁面中，將plugin_customization.ini文件選上。
圖表 23
發(fā)布產(chǎn)品現(xiàn)在到了發(fā)布我們產(chǎn)品的時候了。
不過在發(fā)布之前，先更改一個Eclipse3.2錯誤，因?yàn)槟壳暗淖詣由傻慕榻B頁面有些錯誤。在生成介紹頁面的時候，在content目錄下生成了三個xhtml文件，將這三個文件中的中文去掉，否則在Eclipse解析的時候會出錯。
選擇"Export"(導(dǎo)出)菜單，在對話框中選擇“Eclipse product”。
圖表 24
點(diǎn)擊下一步按鈕。在接下來的對話框中選擇哪一個產(chǎn)品文件,以及產(chǎn)品發(fā)布的文件夾的名稱。您可以選擇發(fā)布成打包的文件，也可以選擇發(fā)布到某個文件夾中。同時還可以選擇class的版本。
圖表 25
現(xiàn)在運(yùn)行一下我們的產(chǎn)品吧。
圖表 26
圖表 27
選擇您的jre真正在用戶的機(jī)器上安裝的時候，他的機(jī)器上不一定安裝了JRE。所以您可以將JRE和您的RCP程序一起打包。啟動程序首先在本文件夾下檢查是否有jre文件夾，否則的話再找注冊表等地方，如果查找不到j(luò)re，程序?qū)o法運(yùn)行。
打包jre非常的簡單，只需將您機(jī)器上的jre文件夾復(fù)制到您的RCP產(chǎn)品的目錄下。
提示:在一些應(yīng)用中，可能需要java的串口包，或者是java的媒體開發(fā)包，這些開發(fā)包需要安裝到JDK下。您可以將您的jdk目錄復(fù)制到RCP應(yīng)用程序文件夾下，同時將jdk文件夾改名為jre。
創(chuàng)建您自己的啟動程序目前來說，我們的RCP產(chǎn)品是發(fā)布完畢。但是這里有一點(diǎn)點(diǎn)的瑕疵?？匆幌挛覀兊漠a(chǎn)品的文件夾。
圖表 28
那個啟動程序“RCP演示程序.exe”文件的圖標(biāo)還是Eclipse的圖標(biāo)，這不能不說有那么一點(diǎn)點(diǎn)的遺憾。
可以有多種方式解決。
一種就是通過資源修改文件，將“RCP演示程序.exe”的圖標(biāo)的資源進(jìn)行修改。
再一種就是自己寫一個啟動程序，查找jre、分析參數(shù)、調(diào)用startup.jar文件。
現(xiàn)在給您介紹第三種方法。
打開Eclipse3.2所在的文件下的
eclipse3.2\plugins\org.eclipse.platform.source_3.1.0\src\org.eclipse.platform_3.1.0文件夾，解壓其中的launchersrc.zip文件。
替換解壓的文件夾下的library\win32\eclipse.ico文件，替換成您的文件。
圖表 29
運(yùn)行l(wèi)ibrary\win32\build.bat文件，將生成啟動程序。將啟動程序改名為“RCP演示程序”，然后復(fù)制到您的RCP程序的文件夾下，替換相應(yīng)的程序即可。
圖表 30
需要注意的是，在Windows下需要Microsoft Visual C and C++ Compiler 6.0，在vs.net 2005下無法編譯。使用mingw也可以。
通過以上的步驟，您就可以完整的發(fā)布一個RCP產(chǎn)品的例子了。
下面是廣告時間，您可以休息一次了。以下是我做的一個RCP的程序。
