BlackBerry 10 Shell Tool Guide
cordova command-line utility is a high-level tool that allows
you to build applications across several platforms at once. An older
version of the Cordova framework provides sets of command-line tools
specific to each platform. To use them as an alternative to the CLI,
you need to download this version of Cordova from
cordova.apache.org. The download contains
separate archives for each platform. Expand the platform you wish to
target. The tools described here are typically available in the
bin directory, otherwise consult the README file for
more detailed directions.
For information on the low-level command-line interface that enables plugins, see Using Plugman to Manage Plugins. See Application Plugins for details on how to develop plugins.
If you need help with any command listed below, type the command along
-help arguments, which are supported by all
commands and which provide descriptions for each of the available
Create an App
create command creates a new project:
bin/create <path-to-project> <project-package> <project-name>
<path-to-project>specifies the directory you want the project created in
<project-package>specifies a reverse domain style identifier
<project-name>specifies the apps display name
create command bootstraps dependency installation
npm install command. Depending on the installation
directory and system permissions, this may require administrator
privileges. If there's problem on OSX/Linux, run
sudo npm install
before using the
create command. On Windows, run
npm install in a
command-line utility opened with administrator privileges.
Create a Target
target command allows you to manage the emulator or BlackBerry
devices that you use to test the app. You can add or remove a target,
or set a target as the default target.
Add a Target
<path-to-project>/cordova/target add <name> <ip-address> [-t | --type <device | simulator>] [-p | --password <password>] [--pin <device-pin>]
<name>specifies a unique name for the target.
<ip-address>specifies the ip address of the BlackBerry device or simulator.
-p | --password <password>specifies the password for the device or emulator. This is required only if the device or emulator is password protected.
--pin <device-pin>specifies the PIN of the BlackBerry device, which identifies that device as a valid host for the debug token. This argument is required only when creating a debug token.
Remove a Target
<path-to-project>/cordova/target remove <name>
Set a Target as the Default
<path-to-project>/cordova/target default <name>
Build the App
build command builds the project as a .bar file. You can build
the app in either release mode (which produces a signed .bar file) or
in debug mode (which produces an unsigned .bar file).
Build the App in Release Mode
<path-to-project>/cordova/build release [-k | --keystorepass <password>] [-b | --buildId <number>] [-p | --params <params-JSON-file>]
-k | --keystorepass <password>specifies the password you defined when you configured your computer to sign applications.
-b | --buildId <number>specifies the build version number of your application. Typically, this number should be incremented from the previous signed version. This argument is optional.
-p | --params <params-JSON-file>specifies a JSON file containing additional parameters to pass to downstream tools. This argument is optional.
Build the Project in Debug Mode
<path-to-project>/cordova/build debug [<target>] [-k | --keystorepass <password>] [-p | --params <params-JSON-file>] [-ll | --loglevel <error|warn|verbose>]
<target>specifies the name of a previously added target. If
<target>is not specified, the default target is used, if one has been created. This argument is only required if you want the script to deploy the app to a BlackBerry device or emulator and you have not created a default target. Additionally, if
<target>is a device, then that device must be connected to your computer by USB connection or be connected to the same Wi-Fi network as your computer.
-k | --keystorepass <password>specifies the password you defined when you configured your computer to sign applications. This password is also used to create your debug token. This argument is only required if you want the script to create and install the debug token for you.
-p | --params <params-JSON-file>specifies a JSON file containing additional parameters to pass to downstream tools.
-ll | --loglevel <level>specifies the log level. The log level may be one of
If you have previously defined a default target (and previously installed a debug token, if that target is a BlackBerry device), you can run the script with no arguments, and the script packages your app and deploys it to the default target. For example:
Run the App
run command deploys the app's most recent build on the specified
BlackBerry device or an emulator. To deploy your app, you need to
specify a target for the device or emulator:
<target> specifies the name of a previously added target.
<target> is a device, then it must be connected to your computer
via USB cable, or else over the same Wi-Fi network as your computer.
target command allows you to add and remove plugins. To fetch a
locally hosted plugin:
<path-to-project>/cordova/plugin fetch <path-to-plugin>
View a list of installed plugins:
Add a plugin:
<path-to-project>/cordova/plugin add <name>
Remove a plugin:
<path-to-project>/cordova/plugin rm <name>