Using PhoneGap/Cordova

Installing PhoneGap in the Command Line Mode

1. Launch the embedded Terminal by hovering your mouse pointer over in the lower left corner of IntelliJ IDEA and choosing Terminal from the menu (see Working with Embedded Local Terminal for details).
2. Type one of the following commands at the command line prompt:
   npm install -- global phonegap npm install -- global cordova npm install -- global ionic
   With the --global option, the package will be installed globally so it is accessible from all your IntelliJ IDEA projects.

Installing PhoneGap/Cordova/Ionic Through the IntelliJ IDEA Interface

1. Run NPM from IntelliJ IDEA using the Node.js and NPM page of the Settings dialog box: Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or IntelliJ IDEA | Preferences for OS X, and click Node.js and NPM under Languages & Frameworks.
2. On the Node.js and NPM page that opens, the Packages area shows all the Node.js-dependent packages that are currently installed on your computer, both at the global and at the project level. Click .
3. In the Available Packages dialog box that opens, select the phonegap, or cordova, or ionic package, depending on your preferences and workflow.

   Optionally:

   • Specify the version to install.
   • To have the package installed globally so it is accessible from all your IntelliJ IDEA projects, select the Options check box and type --global in the text box.

4. Click Install Package to start installation.

Generating a PhoneGap/Cordova/Ionic Application Stub

1. In the right-hand pane, choose PhoneGap/Cordova App and click Next.
2. On the second page of the wizard, specify the project name and the folder to create it in. Specify the location of the executable file phonegap.cmd, or cordova.cmd, or ionic.cmd (see Installing PhoneGap/Cordova/Ionic).

When you click Finish, IntelliJ IDEA generates a skeleton of a PhoneGap/Cordova/Ionic application with the framework-specific structure.

Enabling PhoneGap/Cordova/Ionic Integration in an Existing Project

1. Open the desired PhoneGap/Cordova/Ionic project in IntelliJ IDEA by choosing File | Open on the main menu or clicking Open on the Welcome Screen.
2. Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or IntelliJ IDEA | Preferences for OS X. Expand the Languages&Frameworks node, and then click PhoneGap/Cordova under JavaScript.
3. On the PhoneGap/Cordova page that opens:
   1. Check the location of the executable file phonegap.cmd, or cordova.cmd, or ionic.cmd or specify the path to it if IntelliJ IDEA has not detected the executable file automatically.

      IntelliJ IDEA detects the installed version and displays it in the PhoneGap/Cordova Version read-only field,

   2. In the PhoneGap/Cordova Working Directory field, specify the folder under which the PhoneGap/Cordova/Ionic application files to run are stored.
   3. In the Plugins area, configure a list of plugins to use in your development by installing required packages. The list shows all the PhoneGap/Cordova/Ionic plugins that are currently installed on your computer, both at the global and at the project level.
      • To install a plugin, click the Install button . In the Available Packages dialog box that opens, select the required package.

        To have the installed globally so it is accessible from all your IntelliJ IDEA projects, select the Options check box and type --global in the text box. Click Install Package.

      • To remove a plugin, select it in the list and click the Uninstall button .
      • To upgrade a plugin to the latest available version, select the plugin in the list and click the Upgrade button .
      See Apache Cordova Plugins and PhoneGap Plugins for information about plugins and their use.

Creating and Launching a PhoneGap/Cordova/Ionic Run Configuration

PhoneGap/Cordova/Ionic applications are executed according to a dedicated run/debug configuration.

1. On the main menu, choose Run | Edit Configurations. In the Edit Configuration dialog box, that opens, click the Add New Configuration toolbar button , and choose PhoneGap/Cordova on the context menu.
2. In the Run/Debug Configuration: PhoneGap/Cordova dialog box that opens, specify the following:
   1. The name of the configuration.
   2. In the PhoneGap/Cordova Executable Path field, specify the location of the executable file phonegap.cmd, cordova.cmd, or ionic.cml (see Installing PhoneGap/Cordova/Ionic).
   3. In the PhoneGap/Cordova Working Directory field, specify the folder under which the PhoneGap/Cordova/Ionic application files to run are stored.
   4. From the Command drop-down list, choose the command to run. The contents of the drop-down list, depend on the actually used framework, namely, on the executable file specified in the PhoneGap/Cordova Executable Path field. The available options are:
      • For PhoneGap:
        • emulate
        • run
        • prepare
        • serve
        • remote build
        • remote run
        See https://www.npmjs.org/package/phonegap for a list of PhoneGap-specific commands with descriptions.
      • For Cordova:
        • emulate
        • run
        • prepare
        • serve
        See https://www.npmjs.org/package/cordova for a list of Cordova-specific commands with descriptions.
      • For Ionic:
        • emulate
        • run
        • prepare
        • serve
        See https://www.npmjs.org/package/ionic for a list of Ionic-specific commands with descriptions.
   5. From the Platform drop-down list, choose the platform for running on which the application is intended. The available options are:
      • Android
      • ios To emulate this platform, you need to install the ios-sim command line tool globally. You can do it through the Node Package Manager (npm), see Installing and Removing External Software Using Node Package Manager or by running the sudo npm install ios-sim -g command, depending on your oeprating system.
      • amazon-fireos
      • firefoxos
      • blackberry10
      • ubuntu
      • wp8
      • windows8
      • browser
      Learn more about targeted platforms at http://docs.phonegap.com/en/edge/guide_platforms_index.md.html#Platform%20Guides and http://cordova.apache.org/docs/en/4.0.0/guide_cli_index.md.html#The%20Command-Line%20Interface.
   6. For Cordova and Ionic, specify the targeted virtual or physical Android device to run the application on: select the Specify Target check box and select the required device from the drop-down list. The list shows all the virtual and physical devices that are currently configured on our machine. See http://docs.phonegap.com/en/edge/guide_platforms_android_index.md.html#Android%20Platform%20Guide for details.
3. To run a PhoneGap/Cordova/Ionic application, select the required run configuration from the list on the main tool bar and then choose Run | Run <configuration name> on the main menu or click the Run toolbar button .