出于安全和出口控制的原因,RIM必须跟踪一些敏感BlackBerry应用程序编程接口(API)的使用情况。敏感类别或方法在API参考文档中使用“锁定”图标或“Signed”字样表示。如果您在应用程序中使用了这些受控类,在您将应用程序.cod文件加载到BlackBerry智能手机之前,您的应用程序必须使用签名工具(由RIM提供)进行签名。完成注册流程需要提供有效的信用卡,将收取管理费20美元。官网介绍:http://cn.blackberry.com/developers/javaappdev/codekeys.jsp
一、概述
在Blackberry的开发中,如果您的应用程序使用了受控API,在加载到Blackberry智能手机之前,必须使用RIM提供的签名密钥对其进行签名,签名所用的key需要向RIM申请。本文档介绍RIM签名的申请过程及在公司共用一个签名情况下的环境搭建。
注意:仅当要在BlackBerry智能手机上运行应用程序时,才需要对应用程序进行注册和签名。使用Blackberry智能手机模拟器运行应用程序时不需要对其进行签名。
二、签名申请
要注册以获得BlackBerry运行时、应用程序和加密API,您需要填写这一Web表单。注册完成后,您将会通过电子邮件收到一系列密钥和相关安装说明,可用于使用BlackBerry签名工具对您的应用程序进行签名。完成注册流程需要提供有效的信用卡,将收取管理费20美元。
注意:通常,密钥会在提交必要表单后的48小时内发送到您的电子邮箱,但有时这一过程也会花费长达10个工作日的时间。中国申请的签名,一般需要5到10个工作日的时间。因为密钥会作为附件发送到邮箱,因此所使用的邮箱需要避免将该邮件作为垃圾邮件过滤或者自动删除附件。
签名申请前请准备:
1)接收密钥的邮箱
2)具有美元消费功能的信用卡(国内的信用卡,Vista和Master)
签名申请的URL为:https://www.blackberry.com/SignedKeys/
需要填写以下表单1:
对于中国的姓名,一般来说,firstname是名,lastname是姓,这个对签名的申请不是关键。接下来的company填写公司的英文名称,Email填写要接收密钥的邮箱,phone填写个人的电话号码,Address、city作为公司的话,填写公司的地址,province一般保持原样,country选择china,postal/zipcode填写邮政编码,Quantity不需要填写。
接下来填写第二个表单2:
PIN是指自己定义的密码,10位数字,请牢记该密码,在后续接收到RIM的密钥后会用到。接下去关于YES/NO的选项是关于RIM引用加密API相关,可以进一步了解,一般选择NO就可以。
再接下去是信用卡信息,注意要填写正确,Card Holder Name信用卡持有人的姓名是指信用卡正面的英文名。Card Holder Phone指信用卡持有人的电话,一般直接填写个人的电话号码即可,Card Holder Email指信用卡持有人的Email,可以和上面表单一样,Credit Card Type信用卡的类型,信用卡正面可以找到;Credit Card Number信用卡号码,Expiration Date信用卡过期时间,在信用正面可以找到,Credit Cardsecurity Number信用卡安全号只信用卡背面的三位数字。如果对信用卡各项内容不清楚,可以从发卡行的网站或者银行信用卡电话寻求帮助。
。
填写提交之后,会出现一个总结性的页面,在这个页面要求用户确认,最好拷贝或者记录各项信息,页面下面有最终的提交按钮,按下之后将不可撤销。在提交之后,一般国内的信用卡消费美元会给你电话确认(如果出现这个,申请成功的可能性就会很大)。
注意:在申请成功提交之后,会出现$30的信用卡交易,RIM的回答如下:
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. |
大概意思是$30类似于在用信用卡入住酒店时的冻结资金,实际金额在成交之后按照$20结算。到此,申请的过程完结,接下去需要等待RIM答复,注意,5-10天是指工作日,而非自然日。
三、环境搭建
在成功申请后,RIM会发若干封邮件,其中至少有三封包含附件的邮件,三个附件分别为:
client-RBB-XXXXXXXXXX.csiclient-RCR-XXXXXXXXXX.csiclient-RRT-XXXXXXXXXX.csi其中XXXXXXXXXX是指申请签名的clientID。三个附件为RBB,RRTandRCRkeys.
每封邮件都介绍有附件的使用方法,按照里面的步骤安装签名就可以了。内容如下:
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 ekey 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 si 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: 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 file 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 BlackBerr 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 public/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 < ------------ - ------- - ----------- -- ------- - ------------ - ------- - ----- - 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.如果希望签名工具能够同时支持BlackBerryJDE和BlackBerryJavaPluginforEclipse,需要先为BlackBerryJDE安装.
2.每次要签名应用的时候,就拷贝cod和csl文件到该机器,打开cod文件完成签名。
3.如果需要卸载JDE重新安装,一定要预先备份以下三个文件.
【编辑推荐】