BlackBerry 代码签名工具申请及安装介绍
作者: BlackBerry 提供
背景
出于安全和出口控制的 原因， Re s e a rc h I n M otio n (RI M ) 必须跟踪一些敏感 Bla c kBe rry ® 应用程 序编程接口（ AP I ）的使用情况。敏感类别或方 法在 AP I 参考文档中使用 “ 锁定 ” 图标或
“S ig ne d” 字样表示。如果 您在应用程序中使用了 这些受控类，在您将应 用程序 .c od 文件加 载到 Blac k Be rry 智能手机之前，您的应用程序必须 使用签名工具（由 RI M 提供）进行签名。完 成 注册流程需要提供有效 的信用卡，将收取管理 费 20 美元。官网介绍 :
ht t p : / /cn .black b erry. c o m/ de v e l o per s /j a vaa ppdev / c o de k e ys.jsp
一、概述
在 Bl a ckberr y 的 开发中， 如果您的 应用程 序使用了 受控 API ，在加 载到 Bla ck b erry 智能 手机之 前， 必须使用 RIM 提 供的签名 密钥对其 进行签 名，签名 所用的 k ey 需要向 RI M 申 请。本文 档介绍 RIM 签名的申 请过程 及在公司 共用一个 签名情 况下的环 境搭建。
注意：仅 当要在 Bl ackB err y 智能手 机上运 行应用程 序时，才 需要对 应用程序 进行注册 和签名 。使
用 Bla ckberr y 智 能手机模 拟器运行 应用程 序时不需 要对其进 行签名 。
二、签名申请
要注册 以获得 Bla ckB erry 运行时、 应用程 序和加 密 API ， 您需要 填写这 一 Web 表单 。注册 完成 后，您将 会通过 电子邮件 收到一系 列密钥 和相关安 装说明， 可用于 使用 Bla c kBerry 签名工 具对您 的应用程 序进行 签名。完 成注册流 程需要 提供有效 的信用卡 ，将收 取管理 费 2 0 美元。
注意：通 常，密 钥会在提 交必要表 单后的 4 8 小时 内发送到 您的电 子邮箱， 但有时这 一过程 也会花 费长达 1 0 个 工作日 的时 间。中国 申请的 签名，一 般需要 5 到 1 0 个 工作日 的时间。 因为密 钥会作 为附件发 送到邮 箱，因此 所使用的 邮箱需 要避免将 该邮件作 为垃圾 邮件过滤 或者自动 删除附 件。
签名申请前请准备：
1 ） 接收密 钥的邮 箱
2 ）具 有美元消 费功能的 信用卡（ 国内的 信用卡， Vi sta 和 M aste r ）
签名申请 的 UR L 为： h ttps:// w w w . bla c kberry. c o m/ Si gnedKe y s/
需要填写 以下表 单 1 ：
对于中国 的姓名 ，一般来 说， fir st n a m e 是名， la st n am e 是 姓，这 个对签名 的申请不 是关键 。接 下来的 c o m p an y 填 写公 司的英文 名称， Em ail 填 写要接收 密钥的 邮箱， p h o n e 填写 个人的 电话号 码， Add ress 、 city 作为公 司的话， 填写公 司的地址 ， p rov in c e 一般 保持原样 ， co un tr y 选择 chin a ， p o stal / z ip c o d e 填 写邮政编 码， Quan ti ty 不 需要填写 。
接下来填 写第二 个表单 2 ：
P IN 是指自 己定义 的密码 ， 1 0 位数字 ，请牢 记该 密码，在 后续接 收到 RI M 的密钥后 会用到 。接下 去关于 Y ES/ N O 的 选项是 关于 RIM 引用加 密 API 相 关，可以 进一步 了解，一 般选择 N O 就 可以。
再接下去 是信用 卡信息， 注意要填 写正确 ， CardHo ld er N am e 信用卡 持有人 的姓名是 指信用 卡正面 的英文名 。 CardH o ld er P h o n e 指信 用卡持 有人的电 话，一般 直接填 写个人的 电话号码 即可， CardH o ld er E m ail 指 信用 卡持有人 的 E m ail ，可以 和上面表 单一样 ， Credi t Card Ty p e 信用 卡 的类 型，信用 卡正面 可以找到 ； Credi t Card Nu m b er 信 用卡号码 ， Expir ati o n D at e 信用卡 过期时 间，在 信用正面 可以找 到， Credi t Card s ecuri t y Nu m b er 信 用卡安全 号只信 用卡背面 的三位数 字。如 果对 信用卡各 项内容 不清楚， 可以从发 卡行的 网站或者 银行信用 卡电话 寻求帮助 。
填写提交 之后， 会出现一 个总结性 的页面 ，在这个 页面要求 用户确 认，最好 拷贝或者 记录各 项信 息，页面 下面有 最终的提 交按钮， 按下之 后将不可 撤销。在 提交之 后，一般 国内的信 用卡消 费美 元会给你 电话确 认（如果 出现这个 ，申请 成功的可 能性就会 很大） 。
注意：在 申请成 功提交之 后，会出 现 $ 3 0 的 信用卡 交易， RI M 的回 答如下 ：
the ini tial $ 3 0 ch arg e is a h o ld in g fe e p la ced by t h e cr edi t card c o m p an y to v erify t h at th e fund s are av ail ab le f o r the t ran s acti on , t h is a mo un t i s high er tha n t h e li st ed $ 2 0 fe e t o acc oun t fo r curr ency
chang es, tax es et c. This is a t e m p o rar y v alu e an d will n o t r em ain o n y o u r bi ll , t h e actual a mo un t fo r t h e
key s is $ 2 0 US.
大概意思 是 $ 3 0 类 似于在 用信用卡 入住酒 店时的冻 结资金， 实际金 额在成交 之后按照 $ 2 0 结算 。 到此，申 请的过 程完结， 接下去需 要 等待 RIM 答复 ，注意， 5 -1 0 天是 指工作 日，而非 自然日 。
三、环境搭建
在成功 申请后 ， RIM 会发 若干封邮 件，其 中至少有 三封包含 附件的 邮件，三 个附件分 别为：
clien t-RBB-X XX XX XX X XX .csi clien t-RCR- XX X XX XX X XX .c si clien t-RRT- XX XX X XX XX X. csi
其中 X XX X XX XX X X 是指申 请签名的 clien t I D 。三个 附件为 RB B, RR T an d RC R key s.
每封邮件 都介绍 有附件的 使用方法 ，按照 里面的步 骤安装签 名就可 以了 。内 容如下：
Th e followin g attach m en t wil l all o w th e B l ackBerr y Sig n atureTo o l t o registe r with th e Signin g A uthorit y . Pleas e ens u r e tha t th e BlackBer r y devel o pmen t too l of
choic e ha s b e e n inst a lle d ont o th e workst a tio n tha t wi l l b e us e d t o sig n yo u r
BlackBerr y a p plicati o ns.
T o registe r t h e atta c hment , pleas e follo w th e instruct i on s bel o w :
I f yo u pla n t o us e b o t h th e Black B err y JD E an d BlackBe r r y JD E P lu g -i n fo r E c lipse instal l th e s ignatur e key s usin g t h e Blac k Berr y JDE . T hi s sho u l d allo w yo u to
sig n fro m ei t he r too l .
BlackBerr y J D E o r Bl a ckBerr y JD E C omponen t Packag e Use r s:
1 ) Double- c lic k o n th e attachme n t .
2 ) I f a di a lo g bo x appear s tha t state s t ha t a privat e ke y ca n no t b e found,
complet e ste p s 3 thr o ug h 6 befor e yo u con t inue . Otherw i se , pro c ee d t o ste p 7 .
3 ) Clic k " Y es " t o c reat e a ne w k e y pai r file.
4 ) Typ e a p asswor d fo r you r pri v at e ke y o f a t leas t 8 charac t ers , an d typ e i t agai n t o con f irm . T h i s i s you r p r ivat e k e y password , w hic h pr o tect s you r p r ivate key . Pleas e r emembe r thi s passwor d a s yo u wil l b e prom p te d fo r i t eac h time
signin g i s a t tempte d o r a signatu r e ke y i s installed .
5 ) Clic k " O k"
6 ) Mov e yo u r mous e t o generat e d at e fo r a ne w privat e key.
7 ) I n th e " Registr a tio n PIN " fi e ld , typ e th e PI N num b e r tha t yo u supplie d on
th e signatur e ke y or d e r form.
8 ) I n th e P rivat e K e y passwor d f ield , t y p e th e pa s sw o r d crea t e d i n ste p 4 .
9 ) Clic k " R egister " .
10 ) Clic k "E x it".
11 ) Repea t t h i s proc e s s fo r th e o t he r .cs i files.
BlackBerr y J D E Plug- i n fo r Eclips e Users :
1 ) Sav e al l 3 .cs i file s i n th e sam e di r ector y (eac h on e wil l b e sen t i n a
separat e ema i l messa g e) .
2 ) Star t E c lipse.
3 ) Clic k o n th e Bl a ckBerr y men u an d cho o s e Instal l S i gnatur e Keys.
4 ) Selec t on e o f t h e 3 .cs i fi l e s save d i n ste p 1 a n d clic k Open.
5 ) Clic k " Y es " t o c reat e a ne w k e y pai r file.
6 ) Typ e a p asswor d fo r you r pri v at e ke y o f a t leas t 8 charac t ers , an d typ e it agai n t o con f irm . T h i s i s you r p r ivat e k e y password , w hic h pr o tect s you r p r ivate key . Pleas e r emembe r thi s passwor d a s yo u wil l b e prom p te d fo r i t eac h time
signin g i s a t tempte d o r a signatu r e ke y i s installed.
7 ) Mov e yo u r mous e t o generat e d at e fo r a ne w privat e key .
8 ) I n th e R egistra t io n PIN " fie l d , typ e th e PI N numb e r tha t y o u supplie d o n the
signatur e ke y orde r f orm.
9 ) I n th e P r ivat e K e y passwor d f i eld , ty p e th e passwo r d creat e d i n ste p 6.
10 ) Clic k "R e gister".
11 ) Clic k "E x it".
12 ) Repea t t h i s proc e s s fo r th e o t he r cs i files.
BlackBerr y W i dge t SD K , BlackBerr y We b Dev e lopmen t Plu g- i n fo r E clips e or
BlackBerr y P l ug-i n f o r Microsof t V isua l S t udi o Users :
1 ) A t th e co m man d pr o mpt , navigat e t o th e bi n folde r w i t h i n th e BlackBerr y W idge t
Package r ins t allatio n directory . Defaul t directorie s a re:
BlackBerr y W i dge t SD K an d BlackBe r r y Plu g- i n fo r Micro s of t Vis u a l Studio:
C:/Progra m F i les/Res e arc h I n Moti on /Black B err y Widge t P ackage r / bi n BlackBe r ry
We b Developm e n t Plug - i n fo r Eclip s e:
<Eclips e Ins t allatio n >/plugins / n e t.rim.b r owser.tools. w cp c / wc p c/bi n C :/Pro g ra m
Files/Resear c h I n Mo t io n /BlackBer r y Widge t Package r/bin
2 ) Typ e th e f ollowin g command , in c ludin g t h e ful l pat h o f th e . cs i file:
jav a -ja r Si g natureT o ol.ja r < .cs i fil e pa t h >
3 ) I f a dia l o g tha t a privat e ke y canno t b e foun d app e ars , pe r for m th e fol l owing
actions:
a . Clic k Yes.
b . Typ e a pa s swor d f o r th e privat e key. c . Typ e th e p asswor d t o confir m i t .
d . Clic k OK.
e . Mov e th e m ous e t o generat e dat a fo r th e ne w privat e key.
4 ) I n th e Re g istrati o n PI N field , typ e th e PI N tha t RI M . provi d ed.
5 ) I n th e Pr i vat e Ke y Passwor d fi e ld , typ e a passwor d o f a t le a s t eight
characters . T hi s i s t h e privat e k e y passw o rd.
6 ) Clic k Reg i ster.
7 ) Clic k Exi t .
Importan t in f ormatio n fo r al l use r s:
Note : Al l 3 k ey s (RB B , RCR , RRT ) r eceive d nee d t o b e i n stalle d o n th e sam e P C.
Th e sam e pas s wor d mu s t b e specifi e d fo r a l l key s o n th e sam e P C . Yo u should receiv e eac h key/.cs i fil e i n a s e parat e e mai l message.
Fo r furth e r inf o rmat i o n on B lackBerr y Con t rolle d AP I s an d sign i n g o f a pplicati o ns , pleas e refe r t o th e B lackBerr y Si g natur e T oo l Develope r Guid e v ersio n 4.2.0 ,
foun d a t th e followi n g link:
http://www.b l ackberr y .com/knowled g ecenter p ublic/liveli n k.exe/f e tch/200 0 /806 7 /6450
45/8655/8656 / 1271077 / BlackBerry_S i gnature _ Tool_Develop e r_Guide . pdf?nodeid=1 2 71325
&vernum=0
Pleas e note : Whe n r e gisterin g wi t h th e s i gnin g author i ty , ens u r e tha t yo u h ave
correctl y en t ere d yo u r registrati o n PI N n u mber . I f yo u ente r t h e incor r ec t PI N 5
times , you r k ey s wil l b e deactiva t ed. Troubleshoot i ng:
I f yo u ar e h a vin g di f ficult y inst a llin g o r registerin g you r si g natur e key s p lease chec k th e Si g natur e K e y an d Cod e s ignin g s ectio n o f th e Develo p e r Knowledg e Base foun d here: http://www.b l ackberr y .com/knowled g ecenter p ublic/liveli n k.exe?f u nc=ll&objId= 8 00989
&objAction=b r owse&so r t=name
I f yo u conti n u e t o e x perienc e iss u e s plea s e contac t de v support @ rim.co m .
Bes t o f luc k wit h yo u r developmen t an d th a n k yo u fo r y o u r inte r es t i n Black B erry. Regards,
BlackBerr y A p plicati o n Developmen t Suppor t Team
http://www.b l ackberr y developer.com
Dat e Issued : Tuesday , Marc h 16 , 2 0 1 0 @ 14 : 54:1 5 Key s I s sued : R R T
Recipient : y o uremail @ rim.com
<<client-RRT - 2076343 6 2.csi>>
------------ - ------- - ----------- -- ------- - ------------ - ------- - ----- -
Thi s transmi s sio n (i n cludin g an y a ttachme n ts ) ma y cont a i n conf i dential
information , privile g e d materia l ( includi n g materia l p r otecte d b y th e solic i to r -
clien t o r ot h e r appl i cabl e privil e ges) , o r constitut e n o n -publ i c in formatio n . Any us e o f t hi s in f ormat i o n b y a n yon e o t he r t h a n th e i ntende d reci p ien t i s prohibit e d.
I f yo u hav e r eceive d thi s transmi s sio n i n error , pleas e immedi a tel y repl y t o the sende r an d d e let e th i s informatio n fro m y o u r system . U s e , diss e mination, distribution , o r rep r oductio n o f t hi s tra n smissio n b y u nintend e d recipient s is
no t authoriz e d an d m a y b e unlawfu l .
注意事项：
1 . 如果希望 签名工 具能够同 时支持 Bla c kBerr y J D E 和 Bla ckBe rr y Ja v a P lug in fo r E clip se ，需 要先为 Bla c kBerr y J D E 安装
2 . 每次要签 名应用 的时候， 就拷贝 c o d 和 c sl 文件到 该机器， 打开 c o d 文件完 成签名。
3 . 如果需要 卸载 JD E 重新安 装， 一定要预 先备份以下三个文件
BlackBerry SDK下载