BlackBerry代碼簽名工具申請及安裝介紹
出于安全和出口控制的原因，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重新安裝，一定要預先備份以下三個文件.
【編輯推薦】
