Step 1: Install PhoneGap
The PhoneGap CLI provides a command line interface for creating PhoneGap apps as an alternative to using the PhoneGap Desktop App for those who prefer working at the command line. The PhoneGap CLI currently has some additional features over the PhoneGap Desktop for building, running and packaging your PhoneGap applications on multiple platforms. If you're comfortable using a CLI this option may be best going forward.
There are a few simple requirements you'll need prior to installing the PhoneGap CLI:
- git - used in the background by the CLI to download assets. It comes pre-installed on some operating systems.
To see if you already have it installed, type
git from the command line.
Install the PhoneGap CLI via
npmwith the following command from the Terminal app (Mac) or Command Prompt (Win).
$ npm install -g phonegap@latestTIPS: 1) The
$symbol is used throughout this guide to indicate the command prompt, it should not be typed. 2)
npmis the node package manager and installed with node.js. The
npmcommand fetches the necessary dependencies for the PhoneGap CLI to run on your local machine. It creates a node_modules folder with the necessary code needed to run the CLI. The
-gflag specifies that folder to be installed at the global location so it can be accessed from anywhere on your machine (defaults to /usr/local/lib/node_modules/phonegap on Mac).OS X Users: You may need to prefix this command with
sudoto allow installation to restricted directories and type the following instead:
$ sudo npm install -g phonegap@latest
Windows 8 Users: If you just installed Node.js, be sure to start the Node.js Command Prompt application specifically.
Test to ensure the PhoneGap CLI is properly installed by typing
phonegapon the command line. You should see the following
helptext output displayed:
$ phonegap Usage: phonegap [options] [commands] Description: PhoneGap command-line tool. Commands: help [command] output usage information create <path> create a phonegap project ...TIP: You can access the PhoneGap CLI usage text at any time by adding the keyword
help, or the
--hattribute with any phonegap command i.e.:
$ phonegap create help,
$ phonegap serve -h.