Create a debug token

In this task, you'll use the blackberry-debugtokenrequest command line tool to register and create a debug token BAR file, which you can then install on a BlackBerry 10 device. You'll find blackberry-debugtokenrequest in the bin subfolder where you installed the BlackBerry SDK for Android apps.

Before you begin:
  • Make sure you have configured your computer to create debug tokens. For more information, see Configure your computer to sign apps and create debug tokens.
  • Make sure you have the location and password for your developer certificate.
  • Make sure that you have the PIN of your device. You can locate the PIN by tapping Settings > About, and then selecting Hardware from the drop-down list.
  1. On the command line, navigate to the bin subfolder where you installed the BlackBerry SDK.
  2. Run the blackberry-debugtokenrequest tool, choosing one of the following syntax options:
     blackberry-debugtokenrequest -storepass <password> (-devicepin <device-pin>)+ [<options>] <debug-token-bar-file>
    
     blackberry-debugtokenrequest -storepass <password> -devicepinlist <device-pin-list> [<options>] <debug-token-bar-file>
    
     blackberry-debugtokenrequest -storepass <password> (-deviceid <device-id>)+ [<options>] <debug-token-bar-file>
    
     blackberry-debugtokenrequest -storepass <password> -deviceidlist <device-id-list> [<options>] <debug-token-bar-file>
    
     blackberry-debugtokenrequest -verify [<options>] <debug-token-bar-file>
    
     blackberry-debugtokenrequest -register -storepass <password> -csjpin <csj-pin> [<options>] (<csj-file>)* 
     

    This table explains the values the of the arguments used in the above syntax.

    Argument

    Value

    -cskpass<csk_password>

    This argument specifies the password that you defined when you configured your computer to sign applications.

    -keystore <developer_certificate>

    This argument specifies the location and file name of the developer certificate that you created when you configured your computer to sign applications.

    -storepass <keystore_password>

    This argument specifies the password that you defined when you created a developer certificate.

    -deviceId 0x<device-pin>

    This argument specifies the PIN of the BlackBerry 10 device that you want to install the debug token on. For each PIN, use the prefix 0x. For example, if your PIN is 100ABCD, then enter:

    -deviceId 0x100ABCD

    To specify multiple devices, specify this argument multiple times or create a text file that contains a list of device PINs and use the -deviceidlist argument.

    -deviceidlist <PINs_list_file>

    This argument specifies a text file that contains a list of device PINs. Device PINs should be listed with one PIN per line. For each PIN, use the prefix 0x. For example, a sample <PINs_list_file> called device_PINs.txt might look this:

    0x100ABCD
    0x100ABCE
    0x100ABCF
    0x100ABCG
    0x100ABCH

    You would specify it like this:

    -deviceidlist device_PINs.txt

    <debug_token_bar_file>

    This argument specifies the file name of the debug token you want to create. The debug token file name must end with a .bar extension. If you specify the name of an existing file, the blackberry-debugtokenrequest tool deletes the existing file before it creates the debug token.

    <password>

    This argument specifies the password for the CSK file and keystore.

    <debug-token-bar-file>

    This argument specifies the input/output debug token file.

    <device-pin>

    This argument specifies the device's PIN in hex. The '0x' is omitted. For example, "50F2D211"

    <device-pin-list>

    This argument specifies a file containing a list of the devices' PINs.

    <device-id>

    This argument displays the device ID in either decimal (****) or hex (0x****).

    <device-id-list>

    This argument specifies a file containing a list of device IDs.

    <csj-file>

    This argument allows you to input the CSJ file for registration.

    <csj-pin>

    This argument displays the PIN associated with the CSJ file.

    -keystore<file>

    This argument produces a file containing the developer certificate.

    verbose

    This argument is for verbose output when you sign/verify your app.

    -proxyhost<host>

    This argument displays the proxy host.

    -proxyport<port>

    This argument displays the port number for connecting to the proxy host.

    -proxyusername<username>

    This optional argument displays the user name for the proxy host.

    -proxypassword<password>

    This optional argument displays the password of the proxy host.

You can now upload the debug token you created to your BlackBerry 10 device.
comments powered by Disqus