BlackBerry Widget 开发中级篇

最新推荐文章于 2024-09-19 20:49:34 发布

BBturials

最新推荐文章于 2024-09-19 20:49:34 发布

阅读量2k

点赞数

文章标签： blackberry eclipse api class templates extension

作者: 王志刚

背景知识

在入门篇中 , 我们讨论了如何应用 Bl ack berr y 提供的 W i dget A P I 来进行开发，从如下链接中，

http://w w w.b l ackbe r r y.c o m /de v e l ope r s / doc s/widgetapi/

可以找到 Bl ack Berr y 能提供的所有 W i dget A P I 列表。然后，对于很多应用开发来说， wi dget 开发过程中，有些需求是系统 A P I 所不能满足的，还有一种应用场景是用户需要把原有 j av a 系统的代码和功能与 wi dg et 技术结合起来。为了满足这两种开发和应用的需求， wi dget 也提供了扩展机制，能够满足用户的这种需求。本文就以一个扩充 wi dget 的 ap i 来实现手机在 j av as cri pt 中调用 wi dget ap i 来实现手机震动功能，这个 api 在标准 wi dg et api 中是没有实现

的。

开发工具下载

在进行 W i dget 开发之前 , 开发人员需要下载相应的开发工具 ,Bl ack Berr y ecli pse pl ug- i n 。本文使用的 Bl ack Berr y j a va P l ug- i n f or Ecli pse 版本为 : v 1.1.1 ( 下载地址如下 ):

http://na.blackber r y.c o m /eng/de v elopers / browserde v /ec lips e . j sp

这个 p l u g- i n 的作用是给用户开发 wi dget 扩展 api 使用的。

开发具体步骤

步骤一

启动 Ecli pse , F il e à N ew à P r oj ect , 选择 Bl ack Berr y P r oj ect , 然后选择 N ext :

步骤二

在接下来的对话框，输入 pr oj ect 的名字 My W i dget Exte nsi on, 然后选择 N ext

步骤三

接下来，会出现 pr oj ect 的视图，图中可以看到系统已经添加了新的 pr oj ect ，在 pr oj ect 的 src

目录下点击右键，然后添加一个 pack age 名字为 wi dget packge 。

步骤四

在新建好的 wi dg et packag e 上点击右键，添加一个新的 cl ass ，名为 A l ert Sam pl e ，让他继承

net .ri m .de v i ce.api .scri pt .Scri pt abl e.

步骤五

添加好的 cl as s 的基本框架如下所示：

这个 cl as s 的作用是用来映射在 wi dget 应用中的调用逻辑。当在 j av as cri pt 的代码中通过 ”.” 操作符号调用扩展的 api 时， get F i el() 便会被调用。这个函数在 A l ert Sam pl e 中的实现如下：当它被调用后，便会检查当前 d ev i ce 中 v i br at e 功能是不是被支持。

步骤六

然后，添加一个 v i br at e cl as s 类，让他继承自 net .ri m . dev i ce.api .scri pt .Scri pt abl e F uncti on.

步骤七

添加好的 cl as s 的代码框架如下所示：

在自动生成的代码框架中加入如下代码，这段代码的作用是让设备震动一段时间。

步骤八

接下来，我们将把 A l ert S a m pl e 和 v i br at e 两个 cl as s 连接起来。在 A l ert Sam pl e 中加入如下代码：

这些代码的作用是让 A l er t S am pl e 能够调用 v i br at e 的实例，然后在 A l ert Sam pl e 的 get F i el d()

中加入如下函数实现代码

步骤九

最后，添加 Sam pl eExt ens i on cl as s 到项目中，创建 cl as s 的时候确保 pu bli c 和 fi nal 修饰符被选中，让 sa m pl eext ensi oncl as s 继承自 net .ri m .dev i ce.api .w eb.W i dget Exte nsi on.

步骤十

生成好的 cl as s 框架如下所示：

这里的几个主要方法的作用描述如下：

g et Feat u r eL i s t( ) – 这个方式是为了给 widg et 引擎提供我们新的 widg e t 扩成能提供的

feature lis t 列表，如基础篇介绍，这里的 fea ture 就是 widg et 开发过程中可以加入的 ac cess

的资源。

l oadFe at u r e ( ) – 这个方法是当 widg et 使用相应的 wi dg et e ng in e 提供的 fea ture 时候，可以执行的一些任务，这个一般就是 widg et 引擎加载进来我们 e xt ensi o n api 的入口点。

r eg i st er ( ) – 这个方法提供一个入口插入点，扩充的 widg et 程序可以自动执行一些对当前

widg et 配置文件和浏览器的操作。

unl oad Fea t ur es ( ) – 这个是一个入口点，可以加入一些逻辑，如果需要做一些清理工作当

widg et 退出出这个 ap i 调用的时候。

步骤十一

在上步生成的 S am pl eExt ensi on 的 get F eat ur e L i s t 中添加如下代码：

在 l oadF eat ur e 中，添加如下代码：

步骤十二

在完成 wi dge 扩充 api 的具体开发和定义工作之后，剩下的就是把 wi dget 发布到 Bl ac kberr y

的 wi dget 平台中，这一步是通过 ex por t 相应的 j av a 文件完成的。根据基础篇里面的信息，我们需要把我们做好的 j av a 文件 ex por t 到相应的 wi d get sdk 的目录下。右键选择项目，然后选择 Ex por t

在出现的对话框中，选在 gener al 下的 fil e s y st e m 然后下一步：

不管是用户使用 Bl ack berr y 的 wi dget sdk 还是基于 ec li pse 的 w eb pl ug- i n 做 wi dget 开发发布，我们都需要把这里做出来的 j av a 文件 exp or t 到相应 wi dget sdk 安装目录下的 de v i ce t e m pl at es 目录下。在上图中选择 Exp or t 之后，在出现的对话框中选中 sr c 目录，确保源文件会被 exp or t 出来。

这里的 T o dir ect or y ，选择为相应的开发机器上的 w i dget sdk （或者 w e b pl ugi n - i n f or ecli pse

安装好之后的 pl u gi ns 目下下的）安装录下的 dev i ce_t em pl at es 目录。在完成了 e xpor t 之后，可以看到在 bl ackberr y 的 wi dget sdk 的 p ackag e 目录下，会出现相应的 so ur ce 文件

步骤十三

出了发布 s our ce 文件在 wi dget 平台，我们还需要修改系统的 A P I 列表访问，这样才能最后

在 wi dget 中访问调用到我们新添加的 A P I 。

修改其中的 W id g etC o n f ig I m p l .j av a ，加入如下黑体的内容

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 () );

}

步骤十四

所有的这些设置做完之后，剩下来的就是要测试运行了，如开发入门中的方式我们可以添加一个新的 wi dget 。在你的计算机上创建一个 c:/wi dge t/ al er t 目录（也可以工作在别的目录），在这个目录中生成两个 i nd ex.ht m l 和 confi g.xm l 文件，正如基础篇介绍的那样。

定义的 i ndex. ht m l 和 confi g.xm l 如下所示：

< ht m l >

< 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 >

C onfi g.xm l 的内容如下：

< ? 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 >

在入门文档中，我们是通过 ecli pse 自动打包这两个文件成 c od 的，这里我们也可以使用另外一种手工通过 bbw p 打包工具完成这一步，先 zi p 然后生成 cod 。

首先把这两个文件压缩为一个 zi p 包，名为 al ert .zi p

然后执行如下命令

这里的 bbw p. exe 位于安装好的 wi dget s dk 的目录下面。在执行完上述命令后在命令行出可以看到如下输出，最后在 z i p 同级目录下会生成一个 bi n 目录，如果基础篇介绍的， bi n 目录下，我们可以发现最后生成的 c od 文件。

验证

完成这一步 , 就可以把模拟器自动启动了 . 最后在模拟器中或者真机上 , 就可以看到我们的 wi dget 的效果，如果上一篇基础篇的介绍那样，到这里，一个基于我们新的扩充的 wi dget 的开发 A P I 的新的 wi dget 的开发就完成了。点击 A l e r t 按钮，就可以体验我们新添加的 A P I 能提供的功能了。