Create a debug token from the command line

Before you begin:

  • Request permission to sign BlackBerry Tablet OS applications by completing the BlackBerry code signing keys web form.
  • If you connect to the Internet through a proxy server, you must specify additional command line options to contact the RIM Signing Authority.

You can find the blackberry-debugtokenrequest tool in the bin subfolder where you installed the BlackBerry Tablet OS SDK.

  1. If you already configured your computer for creating debug tokens when you configured application signing, go to step 2. Otherwise, use the blackberry-debugtokenrequest tool to register with the RIM Signing Authority using your PDBT .csj registration file for creating debug tokens. In the -storepass parameter, specify the keystore password. In the -csjpin parameter, specify the registration PIN you enter in the PIN field on the web form when you requested permission to sign applications. Perform this command once.

    blackberry-debugtokenrequest -register -csjpin <PIN>
        -storepass <KeystorePassword> <DebugTokenCSJFile>  

  2. Create a debug token for your tablet. Provide the following values for the command line options:

    Option

    Value

    storepass

    The keystore password that you specified when you registered with the RIM Signing Authority.

    devicepin

    The PIN of the BlackBerry tablet on which you want to install this debug token. For example,-devicepin12A34B56C.

    debug_token_file_name.bar

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

Example: blackberry-debugtokenrequest command line

blackberry-debugtokenrequest -storepass <KeystorePassword>
-devicepin<PIN tablet 1> -devicepin <PIN tablet 2>
-devicepin <PIN tablet n> <debug_token_file_name.bar>

Install a debug token

Before you begin: Retrieve the IP address of your BlackBerry tablet.

  1. Open the BlackBerry tablet options. In the upper-right corner of the Home screen on your BlackBerry tablet, touch the gear icon.

  2. In the list of options, touch Security.
  3. In the list of security options, touch Development Mode.
  4. Touch Upload Debug Token.
  5. At a command prompt, enter the following command:

    blackberry-deploy -installDebugToken <path to debug token> -device <IP address of tablet>
        -password <tablet password>

Configure your application for use with a debug token

You can use the BlackBerry Tablet OS to run an unsigned application on a BlackBerry tablet that has a debug token installed. To install an unsigned application, you must configure the application's author and authorId properties match those specified by the debug token.

You can find the blackberry-airpackager tool in bin subfolder where you installed the BlackBerry Tablet OS SDK.

  1. When you package your application, include -debugToken to extract author and authorId from <token> and apply it to your application.

    blackberry-airpackager -devMode -debugToken <token> -package <MyApplication.bar>
    <MyApplication.xml> <bar-descriptor.xml> <others files...> 

Example: blackberry-airpackager command line

blackberry-airpackager -devMode -debugToken <token> -package <MyApplication.bar>
<MyApplication.xml> <bar-descriptor.xml> <others files...>