BlackBerry Widget開發進階
在入門篇中,我們討論了如何應用Blackberry提供的Widget API來進行開發，從如下鏈接中http://www.blackberry.com/developers/docs/widgetapi/
可以找到BlackBerry能提供的所有Widget API列表。然后，對于很多應用開發來說，widget開發過程中，有些需求是系統API所不能滿足的，還有一種應用場景是用戶需要把原有Java系統的代碼和功能與widget技術結合起來。為了滿足這兩種開發和應用的需求，widget也提供了擴展機制，能夠滿足用戶的這種需求。本文就以一個擴充Widget的API來實現手機在javascript中調用widgetapi來實現手機震動功能，這個API在標準Widget API中是沒有實現的。
開發工具下載
在進行Widget開發之前,開發人員需要下載相應的開發工具,BlackBerry eclipse plug-in。本文使用的BlackBerry javaPlug-in for Eclipse版本為:v1.1.1(下載地址如下):
http://na.blackberry.com/eng/developers/browserdev/eclipse.jsp
這個plug-in的作用是給用戶開發Widget擴展API使用的。
開發具體步驟
步驟一
啟動Eclipse,File New Project,選擇BlackBerry Project,然后選擇Next:
步驟二
在接下來的對話框，輸入project的名字My Widget Extension,然后選擇Next
步驟三
接下來，會出現project的視圖，圖中可以看到系統已經添加了新的project，在project的src目錄下點擊右鍵，然后添加一個package名字為widgetpackge。
步驟四
在新建好的widgetpackage上點擊右鍵，添加一個新的class，名為Alert Sample，讓他繼承net.rim.device.api.script.Scriptable.
步驟五
添加好的class的基本框架如下所示：
這個class的作用是用來映射在Widget應用中的調用邏輯。當在JavaScript的代碼中通過”.”操作符號調用擴展的API時，get Fiel()便會被調用。這個函數在Alert Sample中的實現如下：當它被調用后，便會檢查當前device中vibrate功能是不是被支持。
步驟六
然后，添加一個vibrateclass類，讓他繼承自net.rim.device.api.script.ScriptableFunction.
步驟七
添加好的class的代碼框架如下所示：
在自動生成的代碼框架中加入如下代碼，這段代碼的作用是讓設備震動一段時間。
步驟八
接下來，我們將把AlertSample和vibrate兩個class連接起來。在AlertSample中加入如下代碼：
這些代碼的作用是讓Alert Sample能夠調用vibrate的實例，然后在Alert Sample的getField()中加入如下函數實現代碼
步驟九
***，添加Sample Extension class到項目中，創建class的時候確保public和final修飾符被選中，讓sample ext ension class繼承自net.rim.device.api.web.Widget Extension.
步驟十
生成好的class框架如下所示：
這里的幾個主要方法的作用描述如下：
get Feature List()–這個方式是為了給widget引擎提供我們新的widget擴成能提供的feature list列表，如基礎篇介紹，這里的feature就是widget開發過程中可以加入的access的資源。
load Feature()–這個方法是當widget使用相應的widget engine提供的feature時候，可以執行的一些任務，這個一般就是widget引擎加載進來我們extensionapi的入口點。
register()–這個方法提供一個入口插入點，擴充的widget程序可以自動執行一些對當前widget配置文件和瀏覽器的操作。
unloadFeatures()–這個是一個入口點，可以加入一些邏輯，如果需要做一些清理工作當widget退出出這個api調用的時候。
步驟十一
在上步生成的SampleExtension的getFeatureList中添加如下代碼：
在loadFeature中，添加如下代碼：
步驟十二
在完成widget擴充api的具體開發和定義工作之后，剩下的就是把widget發布到BlackBerry的widget平臺中，這一步是通過export相應的Java文件完成的。根據基礎篇里面的信息，我們需要把我們做好的java文件export到相應的widget sdk的目錄下。右鍵選擇項目，然后選擇Export
在出現的對話框中，選在general下的filesystem然后下一步：
不管是用戶使用Blackberry的widget sdk還是基于eclipse的web plug-in做widget開發發布，我們都需要把這里做出來的java文件export到相應widget sdk安裝目錄下的devicet emplates目錄下。在上圖中選擇Export之后，在出現的對話框中選中src目錄，確保源文件會被export出來。
這里的Todirectory，選擇為相應的開發機器上的widget sdk(或者web plug in-in for eclipse安裝好之后的plugins目下下的)安裝錄下的device_templates目錄。在完成了export之后，可以看到在blackberry的widgetsdk的package目錄下，會出現相應的source文件
步驟十三
出了發布source文件在widget平臺，我們還需要修改系統的API列表訪問，這樣才能***在widget中訪問調用到我們新添加的API。
修改其中的Widget Config Impl.java，加入如下黑體的內容
- pro tecte d W i d g etC on f i g I m p l() {
- _ cus to m Head er s = n e w Http H ead er s () ;
- _ n o tif icat io n s = n e w Has h tab l e() ;
- _ ac ce ss Lis t = n e w Has h tab le() ;
- _ f ea tu r eT ab le = n e w Ha sh tab l e() ;
- _ w id g etE x te ns io n s = n e w Vec tor() ;
- //s et d ef a u lt s s etVer sio n () ;
- _ w id g etE x te ns io ns .add Ele m e n t(
- n et.r i m .d e v ice. ap i. w eb .j s e.B lack B err y W id g etT oo lk it.g etIn s t an ce()) ;
- _w id ge tExte n sion s.a d d Eleme n t( n e w w id ge tpac k age .S am p leExte n sion () );
- }
步驟十四
所有的這些設置做完之后，剩下來的就是要測試運行了，如開發入門中的方式我們可以添加一個新的widget。在你的計算機上創建一個c:\widget\alert目錄(也可以工作在別的目錄)，在這個目錄中生成兩個index.html和config.xml文件，正如基礎篇介紹的那樣。
定義的index.html和config.xml如下所示：
- < head >
- < m et a nam e="v i ew por t " cont ent = " wi dt h= dev i ce -wi dt h; h ei ght = dev i ce- hei ght " / >
- < scri pt t y pe=" t ext/ J av aScri pt " >
- f uncti on v i br at eA l ert( ) {
- i f ( sa m pl e.al er t .vi br at eSuppo rt ed)
- {
- }
- el se
- }
- sa m pl e.al ert .v i br at e( 10 00) ;
- al ert( ' ext ensi on not support ed' ) ;
- < / scri pt >
- < / head >
- < body >
- < di v >
- < i nput t y pe=" subm i t " v a l ue=" A l ert " oncli ck="v i br at eA l ert() " />
- < / di v >
- < / body >
- < / ht m l >
Config.xml的內容如下：
- < ? xm l v er si on= " 1.0" encodi ng= " ut f- 8" ? >
- < wi dget xm l ns=" htt p:/ / ww w . w 3.or g/ ns/ wi dget s" xm l ns: r i m = " htt p: / / ww w .bl ackber r y .co m / ns/ w i dget s" v er si on= " 1.0.0" >
- < nam e> A l er t W i dget < / nam e>
- < des cri pti on>
- Sam pl e wi dget t hat dem onst r at es how t o use
- t he A l er t A P I t o v i br at e t he Bla ck Berr y S m art phone
- < / des cri pti on>
- < aut hor hr ef = " htt p://w w w .r i m .co m / "
- r i m : cop y ri ght = " no cop y ri ght "
- em ail = " aut hor _nam e@aut hor dom ai n.com " > Com pany N am e ? A ut hor N a m e
- < / aut hor >
- < cont ent sr c = " i ndex.ht m l " / >
- < f eat ur e i d= " sa m pl e" />
- < /wi dget >
在入門文檔中，我們是通過eclipse自動打包這兩個文件成cod的，這里我們也可以使用另外一種手工通過bbwp打包工具完成這一步，先zip然后生成cod。
首先把這兩個文件壓縮為一個zip包，名為alert.zip
然后執行如下命令
這里的bbwp.exe位于安裝好的widget sdk的目錄下面。在執行完上述命令后在命令行出可以看到如下輸出，***在zip同級目錄下會生成一個bin目錄，如果基礎篇介紹的，bin目錄下，我們可以發現***生成的cod文件。
驗證
完成這一步,就可以把模擬器自動啟動了.***在模擬器中或者真機上,就可以看到我們的widget的效果，如果上一篇基礎篇的介紹那樣，到這里，一個基于我們新的擴充的widget的開發API的新的widget的開發就完成了。點擊Alert按鈕，就可以體驗我們新添加的API能提供的功能了。
【編輯推薦】
