# PhoneGap 和 Cordova

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 所需插件  :
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。
>
>
>
> `Cordova`  -  在   设置 | 插件   页面上安装插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

> **Warning:**
> 此技术不再受支持。  Cordova  插件已弃用，但仍可从 [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/7436-cordova) 获取。

[PhoneGap](http://phonegap.com/) 和 [Apache Cordova](http://cordova.apache.org/) 是用于开发移动应用程序的框架，可以使用单个 HTML、CSS 和 JavaScript/TypeScript 代码库并针对各种移动平台，包括 [Android](http://cordova.apache.org/)。

## 开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。

2. 请确保已在设置中启用  JavaScript 和 TypeScript  插件。 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))打开设置，然后选择  `插件` 。 在搜索字段中，键入  JavaScript 和 TypeScript 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

3. 安装  Cordova  插件。  插件已弃用，但仍可从 [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/7436-cordova) 获取。

4. 根据您所使用的目标平台和操作系统下载并安装一个仿真器工具。 了解更多信息，请访问 [Cordova](https://cordova.apache.org/docs/en/latest/#develop-for-platforms)官方网站。

5. 要模拟 [iOS](https://developer.apple.com/ios/) 平台，请全局安装 [ios-sim](https://github.com/ios-control/ios-sim) 和 [ios-deploy](https://github.com/ios-control/ios-deploy) 命令行工具。

打开你的命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），然后输入：

`npm install -g ios-sim`

`npm install -g ios-deploy`

## 安装 PhoneGap 和 Cordova

Procedure:

在命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中，输入以下命令之一：

* `npm install -g phonegap@latest`

了解更多信息，请访问 [PhoneGap 官方网站](http://docs.phonegap.com/getting-started/1-install-phonegap/cli/)。

* `npm install -g cordova`

请访问 [Cordova 官方网站](https://cordova.apache.org/#getstarted) 了解更多信息。

## 创建新的 PhoneGap 或 Cordova 应用程序

如果您还没有应用程序，您可以使用 PhoneGap 或 Cordova 特定结构从样板模板生成 一个 IntelliJ IDEA 项目。 或者，创建一个空的 IntelliJ IDEA 项目，并在其中配置 PhoneGap 或 Cordova 支持。

Procedure: 从模板创建应用程序

1. 从主菜单中选择  `文件 | 新建 | 项目` ，或者在   %instance% 主页   屏幕上点击  `新建 | 项目` 。

2. 在   新建项目   对话框的左侧窗格中，选择   JavaScript  。

3. 在右侧窗格中，选择   Cordova  并点击   下一步  。

4. 在向导的第二页中，指定项目名称以及要在其中创建项目的文件夹。 指定可执行文件的位置。 根据您的操作系统和目标平台，这可以是  `phonegap` 、  `phonegap.cmd` 、  `cordova`  或  `cordova.cmd` 。

5. 当您点击   完成  时，IntelliJ IDEA 会生成一个具有框架特定结构的应用程序骨架。

## 从现有的 PhoneGap 或 Cordova 应用程序开始

要继续开发现有应用程序，请在 IntelliJ IDEA 中打开它，下载所需的 dependencies，并在项目中配置 PhoneGap 或 Cordova 支持。

Procedure: 在您的项目中配置 PhoneGap 或 Cordova

1. 打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），然后转到  `语言与框架 | JavaScript | Cordova` 。

2. 请检查可执行文件的位置，或如果 IntelliJ IDEA 未能自动检测到该可执行文件，请指定其路径。 这可能是  `phonegap` 、  `phonegap.cmd` 、  `cordova`  或  `cordova.cmd` ，取决于您的操作系统和所选的框架。

IntelliJ IDEA 检测到已安装的版本并在   Cordova 版本  只读字段中显示。

3. 在   Cordova 工作目录   字段中，指定存储要运行的应用程序文件的文件夹。

4. 默认情况下，IntelliJ IDEA 会自动将  `platforms`  或  `www`  目录视为  已排除 ，并在项目分析、解析和代码补全期间将其忽略，请参阅 [配置内容根中的文件夹](null)。

要保留此默认行为，请确保选中   自动排除工作目录（'platforms'、'www' 用于 ionic）   复选框。

### 项目安全

打开在 IntelliJ IDEA 外部创建并导入其中的项目时，IntelliJ IDEA 会显示一个对话框，可在其中决定如何处理此包含不熟悉源代码的项目。

请选择以下选项之一：

* 在安全模式中预览 ：在这种情况下，IntelliJ IDEA 以预览模式打开项目。 这意味着可以浏览项目的源代码，但无法运行任务和脚本，也无法运行/调试项目。 IntelliJ IDEA 会在编辑器区域顶部显示一条通知，可以点击 信任项目… 链接随时加载项目。

* 信任项目 ：在这种情况下，IntelliJ IDEA 会打开并加载一个项目。 这意味着项目已初始化，项目的插件已解析，依赖项已添加，并且所有 IntelliJ IDEA 功能都可用。

* 不打开 ：在这种情况下，IntelliJ IDEA 不会打开项目。

有关更多信息，请参阅 [项目安全](project-security.html)。

> **Tip:**
> 从欢迎屏幕或通过  `文件 | 新建 | 项目`  创建的项目会被自动视为受信任。

## 运行 PhoneGap 和 Cordova 应用程序

PhoneGap 和 Cordova 应用程序根据专用的运行/调试配置执行。

Procedure: 创建运行配置

1. 前往  `运行 | 编辑配置` 。 在弹出的   编辑配置   对话框中，点击工具栏上的 ![添加新配置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置：Cordova](run-debug-configuration-phonegap-cordova.html) 对话框中，指定以下内容：

1.  配置名称。

2.

在   Cordova 可执行文件   字段中，指定可执行文件  `phonegap` 、  `phonegap.cmd` 、  `cordova`  或  `cordova.cmd`  的位置，具体取决于您的操作系统和所选框架。

3.

在   Cordova 工作目录   字段中，指定存储要运行的应用程序文件的文件夹。

4.

从   命令   列表中选择要运行的命令。 列表的内容取决于实际使用的框架，即取决于在   Cordova 可执行文件   字段中指定的可执行文件。 可用选项包括：

* 针对 PhoneGap ： * 模拟 * run * 准备 * 提供服务 * 远程构建 * 远程运行 有关带说明的 PhoneGap 特定命令列表，请参阅 [PhoneGap CLI](https://www.npmjs.org/package/phonegap)。

* 针对 Cordova ： * 模拟 * run * 准备 * 提供服务 有关带说明的 Cordova 特定命令列表，请参阅 [Cordova CLI](https://www.npmjs.org/package/cordova)。

5.

从   平台  列表中选择应用程序的目标平台。

可用选项包括：

* 安卓

* iOS 系统 要模拟此平台，请全局安装 [ios-sim](https://github.com/ios-control/ios-sim) 和 [ios-deploy](https://github.com/ios-control/ios-deploy) 命令行工具。 打开你的命令行 shell 或嵌入式 终端 （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），然后输入： `npm install -g ios-sim` `npm install -g ios-deploy`

* browser

* amazon-fireos

* firefoxos

* blackberry10

* ubuntu

* wp8

* windows

* windows8

从 [平台指南](http://docs.phonegap.com/en/edge/guide_platforms_index.md.html#Platform%20Guides)详细了解目标平台。

6.

对于  Cordova ，指定要运行应用程序的目标虚拟或物理 Android 设备：选中   指定目标  复选框，并从列表中选择所需设备。

该列表显示当前在您的计算机上配置的所有虚拟和物理设备。 从 [Cordova 官方网站](https://cordova.apache.org/docs/en/8.x/guide/platforms/android/index.html#setting-up-an-emulator)详细了解如何设置模拟器。

如果 IntelliJ IDEA 显示以下错误消息：  无法在路径中检测到 ios-sim ，请确保已安装  `ios-sim` ，请参阅 [开始之前](#ws_cordova_before_you_start_install_ios-sim)。

Procedure: 运行应用程序

* 从主工具栏的列表中选择新建的运行配置，并点击 ![运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置：Cordova](run-debug-configuration-phonegap-cordova.html)

