BlackBerry Phonegap項目的搭建

• 前言

事實上，這稱不上是搭建，由於整個項目依舊是phonegap包裏的例子項目，是使用ant來構建的。

• 準備材料:

1. JDK(不是java系的童鞋請自覺離開)

2. Apache ant

http://ant.apache.org/bindownload.cgi  記得配好環境變量.

3. BlackBerry WebWork SDK

https://developer.blackberry.com/html5/download/#smartphones

4. BlackBerry Plug-in for Eclipse(裏面集成了blackberry插件的eclipse)

https://developer.blackberry.com/java/download/eclipse/

可選,若是你有真傢伙,這個大玩意兒能夠不裝.它用來建立blackberry項目和跑模擬器.

5. phonegap發佈包(裏面有文檔和各個平臺的demo)

http://phonegap.com/download/

• 安裝過程:

對菜鳥: next->next->...

其餘人: 本身decide

• 步驟:

1. 爲了並行工做，我們先去註冊signing key吧。https://www.blackberry.com/SignedKeys/codesigning.html

其中PIN是一個6到10位的數字，用本身的生日吧，Why not？

2. 解壓phonegap壓縮包，把路徑「/lib/blackberry/example」拷到別的地方（我爲了方便，直接複製到E盤根目錄了），記住了這個文件夾就是一個blackberry的phonegap項目，是我們可愛的小白鼠。

咱們先來看看它的「身材」如何

build文件夾： 執行ant build以後纔會有，一開始是木有滴。

cordova文件夾： 存放了ant執行腳本，貌似多是linux下的腳本文件，在windows下運行不了。

lib文件夾： 不解釋，你們都懂得。

www文件夾：其實也不用解釋了，存放js、html、css。

blackberry.xml，playbook.xml，qnx.xml： 三個xml分別對應BlackBerry三個分支

BlackBerry OS 5.0 and higher，BlackBerry PlayBook，BlackBerry 10 (QNX)。這些xml會在build的時候用到。

 project.properties： 這個配置文件會跟下載安裝後的webwork sdk搞基，因此到時候須要從新配置一下下。

 3. 鑑於signing key還沒來，先作一些其餘事情吧。好比說，配置project.properties文件。

你用哪一個分支就改哪一個，好比我用的blackberry smartphone，改的是第一個，指向的路徑即安裝好的webwork sdk路徑，路徑分隔符用「\\」。

用的哪一個分支就選哪一個配置項，密碼是什麼請看下面分解。由於signing key還沒下來，這裏先讓它空着。

4. 繼續等signing key的凱旋，再看看webwork sdk吧。

三個csi文件多麼拉風，它們正是你苦苦等待的，因此郵件到了別忘了把這三兄弟拷到這個目錄下。

SignatureTool.jar 用來註冊signing key以及代碼的signing（要讓代碼在真機上跑起來必需要作這一步）。

另外這裏要提一個很噁心的東西，在build項目的時候會遇到莫名的錯誤。找到BlackBerry WebWorks SDK 2.3.1.5\ext\common\blackberry\common\util路徑下的URLDecoder.java文件，這裏會出現一個因爲編碼引發的問題（不知道是否是因爲用了中文操做系統環境的緣故）。這個文件編碼方式是ansi，因此裏面大部分字符就亂碼了，右引號會消失，所以報錯，我試過改爲utf-8仍是不行，因此這些亂碼字符就讓他？吧。你的目標是「保持引號成對，消滅畸形字符」。

5. 坑爹啊，郵件還沒來，我等得花兒都謝了。

再來看看到時候運行哪些命令來生成最終可運行的blackberry程序。

java -jar SignatureTool.jar [CSI file name].csi： 註冊signing key，那三大表明（註冊完後這三大表明就殘廢了，不能再用了）都須要註冊過。註冊時須要填密碼，也就是上面配置項裏須要的password。三大表明都註冊完後在目錄下會看到sigtool.csk和sigtool.db兩個文件生成。

ant blackberry build：生成blackberry安裝文件（.alx），裏面有未經signing過的.code文件，因此雖然在真機上能安裝可是運行會報錯。

ant blackberry load-simulator或者debug-device: 前提是安裝了BlackBerry Plug-in for Eclipse，裏面會有BlackBerry的模擬器，load-simulator會給你開一個模擬器，debug-device是在桌面上已經有一個開着的模擬器的狀況下使用。

6. 哦，賣糕的，忘了今天那邊應該是禮拜六，怪不得等了幾個小時都沒郵件過來。Sorry，那就只能憑記憶來闡述了。

轉到Research In Motion\BlackBerry WebWorks SDK 2.3.1.5\bin路徑下，進行signing key的註冊，打開一個控制檯，依次執行java -jar SignatureTool.jar [CSI file name].csi。將三個csi文件所有註冊好，註冊的時候請保持這個界面是全場的焦點，這樣能加快很多速度。須要輸入signing key的密碼，這個千萬別忘記了。還有就是在註冊的時候須要輸入一次PIN，就是上面說的生日，這個總不可能忘吧。

上面註冊作完後，雙擊打開SignatureTool.jar時就不會再有個確認框出現了（確認框出現是由於你還沒註冊）。之後就可使用這個工具來對.cod文件進行signing了。

具體方法是：點擊「Add」按鈕-->添加.code文件-->點擊「Request」按鈕

7. 轉到example文件夾下，打開一個控制檯，運行「ant blackberry build」命令。

 

看到BUILD SUCCESFUL就成功了，若是上面第四步中URLDecoder.java文件你改對了，這裏基本不會報奇葩錯誤。

build成功了，去example/build下看build的產物。其中StandardInstall文件夾存放安裝文件alx、代碼文件cod以及其餘文件。

事實上如今徹底能夠在模擬器上安裝和運行了。但要在真機上運行起來，還須要對.cod文件進行signing。

雙擊打開SignatureTool.jar，選擇這個.cod文件，點擊「request」按鈕開始signing（這裏固然須要輸入第6步裏設置好的密碼）。

理論上1分鐘應該能搞定signing，可是有時候卻卡在那邊，其中某個的status始終是Receiving...。這時，你能夠從新打開從新來。直到一個對話框出現，纔算是真正完成了signing。

8. 激動人心的時刻到來了，哦，對了，你還須要一個安裝管理BlackBerry應用程序的利器——BlackBerry Desktop Software

http://us.blackberry.com/software/desktop.html

點擊「Applications」選項卡，加載完後點擊Import files按鈕，選擇剛纔生成的.alx文件，再點擊右下角Apply按鈕進行安裝。

安裝完後，打開這個機器人圖標（不知道這算不算是機器人？）。看到DEVICE IS READY顯示，也就是觸發了phonegap封裝好的onDeviceReady事件，證實這確實是個phonegap程序了。

接下來BlackBerry的開發就是前端html、js、css的事情了，也就是在www文件夾下進行應用程序的編寫。我也試過編寫js獲取設備信息，結果是能夠的，徹底證實了它是正統的phonegap項目。

OK，整個教程寫到這裏就結束了。

注：轉載就註明出處及做者。