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

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