WebStorm 2025.2 Help

PhoneGap 和 Cordova

PhoneGap 和 Apache Cordova 是用于通过统一的 HTML、CSS 以及 JavaScript/TypeScript 代码库开发移动应用并面向多个移动平台（包括 Android ）的框架。

开始之前

  1. 请确保您的计算机上已安装 Node.js。

  2. 在 设置 | 插件 页签的 Marketplace 选项卡中安装并启用 Cordova 插件，详情请参见 从 JetBrains Marketplace 安装插件。

  3. 根据目标平台和所使用的操作系统下载并安装模拟器工具。 详细信息请参见 Cordova 官方网站。

  4. 要模拟 iOS 平台，请全局安装 ios-sim 和 ios-deploy 命令行工具。

    打开嵌入式 终端 （Alt+F12 ）并键入：

    npm install -g ios-sim

    npm install -g ios-deploy

安装 PhoneGap 和 Cordova

在嵌入式 终端 （Alt+F12 ）中，键入以下命令之一：

创建新的 PhoneGap 或 Cordova 应用

如果您尚未拥有应用，可以通过样板模板生成具备 PhoneGap 或 Cordova 特定结构的 一个 WebStorm 项目。 或者，按照 创建项目 中的说明创建一个空的 WebStorm 项目，并在其中配置 PhoneGap 或 Cordova 支持。

从模板创建应用

  1. 在 欢迎 屏幕上点击 新建项目 ，或从主菜单中选择 文件 | 新建 | 项目。 将打开 新建 项目 对话框。

  2. 在左侧窗格中选择 Cordova。

  3. 在右侧窗格中，指定存储项目相关文件的文件夹路径。 指定可执行文件的位置。 根据操作系统和目标平台的不同，可执行文件可能位于 phonegap 、 phonegap.cmd 、 cordova 或 cordova.cmd 。

  4. 单击 创建 后，WebStorm 将生成一个应用框架结构的骨架。

使用现有 PhoneGap 或 Cordova 应用开始

要继续开发现有应用，请在 WebStorm 中打开该应用，下载所需依赖项，并在项目中配置 PhoneGap 或 Cordova 支持。

在项目中配置 PhoneGap 或 Cordova

  1. 打开 设置 对话框（Ctrl+Alt+S ），然后转到 语言与框架 | JavaScript | Cordova。

  2. 检查可执行文件的位置，如果 WebStorm 未自动检测到，请手动指定路径。 根据操作系统和所选框架的不同，这可能是 phonegap 、 phonegap.cmd 、 cordova 或 cordova.cmd 。

    WebStorm 会检测已安装的版本，并在 Cordova 版本 只读字段中显示。

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

  4. 默认情况下，WebStorm 会自动将 platforms 或 www 目录视为 已排除 ，并在索引、解析和代码补全过程中忽略该目录，详见 配置内容根目录中的文件夹。

    如需保留此默认行为，请确保已选中 自动排除工作目录（对 ionic 而言为 'platforms'、'www'） 复选框。

项目安全性

当打开在 WebStorm 外部创建并导入的项目时，WebStorm 会显示对话框，允许您决定如何处理包含不熟悉源代码的项目。

不受信任的项目警告

请选择以下选项之一：

  • 在安全模式中预览 ：在此情况下，WebStorm 将在预览模式下打开项目。 这意味着您可以浏览项目源代码，但无法运行任务和脚本，也无法运行/调试项目。

    WebStorm 会在编辑器区域顶部显示通知，您可以随时点击 信任项目… 链接加载项目。

  • 信任项目 ：在此情况下，WebStorm 会打开并加载项目。 这表示项目已初始化、插件已解析、依赖项已添加，且所有 WebStorm 功能均可用。

  • 不打开 ：在此情况下，WebStorm 不会打开项目。

详细信息请参见 项目安全性。

运行 PhoneGap 和 Cordova 应用

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

创建运行配置

  1. 前往 运行 | 编辑配置。 在打开的 编辑配置 对话框中，单击工具栏上的 添加新配置按钮 ，然后从上下文菜单中选择 Cordova。

  2. 在打开的 Run/Debug Configuration: Cordova 对话框中，指定以下内容：

    1. 配置名称。

    2. 在 Cordova 可执行文件 字段中，根据您的操作系统和所选框架，指定可执行文件 phonegap 、 phonegap.cmd 、 cordova 或 cordova.cmd 的位置。

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

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

      • 对于 PhoneGap：

        • emulate

        • run

        • prepare

        • serve

        • remote build

        • remote run

        请参阅 PhoneGap CLI ，获取特定于 PhoneGap 的命令及其说明列表。

      • 对于 Cordova：

        • emulate

        • run

        • prepare

        • serve

        请参阅 Cordova CLI ，获取特定于 Cordova 的命令及其说明列表。

    5. 从 平台 列表中选择应用所针对的平台。

      可用选项包括：

      • Android

      • iOS 要模拟此平台，请全局安装 ios-sim 和 ios-deploy 命令行工具。

        打开嵌入的 终端 （Alt+F12 ），然后输入：

        npm install -g ios-sim

        npm install -g ios-deploy

      • browser

      • amazon-fireos

      • firefoxos

      • blackberry10

      • ubuntu

      • wp8

      • windows

      • windows8

      有关目标平台的更多信息，请参阅 Platform Guides。

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

      该列表显示当前在您的计算机上已配置的所有虚拟和物理设备。 有关设置模拟器的更多信息，请参阅 Cordova 官方网站。

      如果 WebStorm 显示以下错误消息： Cannot detect ios-sim in path ，请确保已安装 ios-sim ，并参阅 Before you start。

运行应用

  • 从主工具栏的列表中选择新创建的运行配置，然后单击 运行按钮。

最后修改日期： 2025年 9月 26日
OpenAPI运行/调试配置：Cordova