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，整个教程写到这里就结束了。

注：转载就注明出处及做者。