Would you like to tell us how we are doing?

You bet No thanks

Create a debug token from the command line

Before you begin:
  • Add the path to the bin subfolder where you installed the BlackBerry 10 SDK for Adobe AIR to the PATH environment variable for your operating system.
  • For more information about command line options, run blackberry-debugtokenrequest from the command line with no options.
You can find the blackberry-debugtokenrequest tool in the bin subfolder where you installed the BlackBerry 10 SDK for Adobe AIR .
To install a debug token on your BlackBerry device and test your application, complete the following steps:
  1. Register your debug token with the BlackBerry Signing Authority.
  2. Create a debug token.
  3. Install a debug token.
Once you have completed these steps, see Test applications using the command line for more information on deploying your application to a BlackBerry device.

Register your debug token with the BlackBerry Signing Authority

If you already configured your computer for creating debug tokens when you configured application signing, go ahead and create a debug token. Otherwise, use the blackberry-debugtokenrequest tool to register with the BlackBerry 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>  

Create a debug token

Create a debug token for your tablet. Provide the following values in a command line console:
blackberry-debugtokenrequest -storepass <KeystorePassword> 
-devicepin<Device_PIN1> -devicepin <Device_PIN2> 
-devicepin <Device_PIN3> <debug_token_file_name.bar>
The following table defines the flags called in the blackberry-debugtokenrequest command.

Option

Value

-storepass

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

-devicepin

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

debug_token_file_name.bar

The file name of the debug token that 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.

Install a debug token

Before you install a debug token, put your BlackBerry device into development mode, and retrieve its IP address.

  1. At a command prompt, enter the following command:
    blackberry-deploy -installDebugToken <path to debug token> -device <IP address of tablet> 
        -password <tablet password>

Now that you have prepared your application for use with a debug token, see Test applications using the command line for information on how to deploy your application to the BlackBerry device.

Configure a debug token through a proxy server

During the signing process, your computer connects to the BlackBerry Signing Authority. If your computer connects to the Internet through a proxy server, you should append the options in the following table to your blackberry-debugtokenrequest commands.

Option

Description

-proxyhost <host>

This option specifies the network host that provides the proxy service. The host parameter can be an IP address or a fully-qualified domain name.

-proxyport <port>

This option specifies the port number on your proxy server through which blackberry-signer or blackberry-debugtokenrequest should communicate with the BlackBerry Signing Authority.

-proxyusername

<user name>

This option allows you to provide your user name if your proxy server requires authentication.

-proxypassword

<password>

This option allows you to provide your password if your proxy server requires authentication.