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 top-level
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 with the
-help arguments, which are supported by all commands and which provide descriptions for each of the available arguments.
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 through the
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.
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.
<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.
<path-to-project>/cordova/target remove <name>
<path-to-project>/cordova/target default <name>
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).
<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.
<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 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. If
<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>
© 2012–2017 The Apache Software Foundation
Licensed under the Apache License 2.0.