WebStorm 2025.2 Help

运行/调试配置:Cordova

创建: 运行(U) | 编辑配置(E) | 添加新配置| Cordova

本页介绍了特定于配置的项目以及适用于所有运行/调试配置的 选项。 有关使用此配置的更多信息,请参阅 PhoneGap 和 Cordova

使用此对话框可创建运行和调试通过集成 PhoneGapApache Cordova 框架开发的应用程序的配置,这些应用程序旨在各种移动平台上运行,包括 Android

开始之前

请在 设置 | 插件 页签 插件市场 上安装 PhoneGap/Cordova 插件,具体操作请参阅 从 JetBrains Marketplace 安装插件

PhoneGap 或 Cordova 特定的配置设置

项目

描述

Cordova 可执行文件

在此字段中,根据操作系统和所选框架,指定可执行文件 phonegap phonegap.cmd cordova cordova.cmd 的位置。

Cordova 工作目录

在此字段中指定存储要运行的应用程序文件的文件夹。

命令

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

  • 对于 PhoneGap

    • emulate

    • run

    • prepare

    • serve

    • remote build

    • remote run

    请参阅 PhoneGap CLI ,获取 PhoneGap 的命令列表及说明。

  • 对于 Cordova

    • emulate

    • run

    • prepare

    • serve

    请参阅 Cordova CLI ,获取 Cordova 的命令列表及说明。

平台

从此下拉列表中选择应用程序所针对的平台。

可用选项包括:

  • Android

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

    打开嵌入式 终端Alt+F12 )并键入:

    npm install -g ios-sim

    npm install -g ios-deploy

  • browser

  • amazon-fireos

  • firefoxos

  • blackberry10

  • ubuntu

  • wp8

  • windows

  • windows8

请参阅 平台指南 ,了解有关目标平台的详细信息。

指定目标

选中此复选框以指定一个 Android 物理或虚拟设备用于运行应用程序,并从下拉列表中选择所需的设备。

列表中显示当前在您的机器上配置的所有虚拟和物理设备。 有关设置模拟器的更多信息,请访问 Cordova 官方网站

如果 WebStorm 显示以下错误信息: Cannot detect ios-sim in path ,请确认是否已安装 ios-sim ,并参阅 开始之前

通用设置

在编辑运行配置(而不是运行配置模板)时,您可以指定以下选项:

项目

描述

名称(N)

指定运行配置的名称,以便在编辑或运行时快速识别。

允许多个实例(U)

允许同时运行此运行配置的多个实例。

默认情况下,该选项处于禁用状态,当您在另一个实例仍在运行时启动此配置,WebStorm 将提示停止当前实例并启动新实例。 当运行配置占用大量资源且没有同时运行多个实例的合理理由时,此选项非常有用。

存储为项目文件(S)

将包含运行配置设置的文件保存,以便与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不希望共享 .idea 目录,您可以将配置保存到项目中的其他目录。

默认情况下,该选项处于禁用状态,WebStorm 会将运行配置设置存储在 .idea/workspace.xml 中。

工具栏

运行/调试配置的树状视图包含一个工具栏,可帮助您管理 项目 中可用的配置,并调整默认配置模板。

项目

快捷键

描述

添加按钮

Alt+Insert

创建运行/调试配置。

移除按钮

Alt+Delete

删除选定的运行/调试配置。请注意,无法删除默认配置。 请注意,无法删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。请注意,您创建的是默认配置的副本。 请注意,您创建的是默认配置的副本。

保存配置

该按钮仅在选择 临时配置 时显示。 点击此按钮可将临时配置保存为永久配置。

移至新文件夹/创建新文件夹

移入新文件夹/创建新文件夹。 您可以通过 放入文件夹 的方式对运行/调试配置进行分组。

要创建文件夹,请选择某个类别中的配置,点击 文件夹 ,并指定文件夹名称。 如果仅选定了类别,将创建一个空文件夹。

然后,若要将配置移动到文件夹中、文件夹之间或从文件夹移出,请使用拖动或 上移下移 按钮。

要移除分组,请选中文件夹并点击 删除配置

对配置进行排序

点击此按钮可按照字母顺序对配置进行排序。

启动前

在此区域,您可以指定在启动所选运行/调试配置之前要执行的任务。 这些任务将按照列表中的顺序依次执行。

项目

快捷键

描述

添加按钮

Alt+Insert

点击此图标可添加以下可用任务之一:

  • 启动Web 浏览器 :选择此选项以启动浏览器。 在打开的对话框中,选择浏览器类型,并提供启动 URL。 此外,请指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 :选择以运行外部应用程序。 在打开的对话框中,选择一个或多个想要运行的应用程序。 如果该应用程序尚未在 WebStorm 中定义,请添加其定义。 有关更多信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择以执行另一个运行/调试配置,并等待其完成后再启动当前配置。 如果想要并行运行多个配置,请使用 复合运行/调试配置

  • 运行File Watcher :选择此选项以使 WebStorm 应用所有当前活动的 File Watcher

  • 运行远程外部工具 :添加一个 远程 SSH 外部工具

  • 运行Grunt 任务 :选择此选项以运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数,以及 grunt-cli 包的路径。

  • 运行 Gulp 任务 :选择此选项以运行 Gulp 任务。

    在打开的 Gulp 任务 对话框中,指定定义所需任务的 Gulpfile.js ,选择要执行的任务,并指定传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数,以及 gulp 包的路径。

  • 运行 npm Script :选择此选项以执行 npm 脚本。

    在打开的 NPM Script 对话框中,指定 npm 运行/调试配置设置

  • 编译TypeScript :选择以运行内置的 TypeScript 编译器,确保您对 TypeScript 代码所做的所有更改都已反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选中或取消选中 检查错误 复选框,以配置在检测到错误时编译器的行为:

    • 如果选中 检查错误 复选框,编译器会显示所有错误,运行配置将不会启动。

    • 如果取消选中 检查错误 复选框,编译器会显示所有检测到的错误,但运行配置仍将启动。

  • 初始化 Cordova 平台 :选择此选项以 添加目标平台

    默认情况下,此任务已添加。

  • 生成CoffeeScript 源映射 :选择此选项以为 CoffeeScript 源代码生成 source map。 在打开的对话框中,指定 CoffeeScript 源文件的位置。

移除按钮

Alt+Delete

点击此图标可从列表中移除所选任务。

编辑

Enter

点击此图标可编辑所选任务。 在打开的对话框中进行必要的更改。

方法上移

方法下移

Alt+Up

Alt+Down

单击这些图标可将所选任务在列表中上移或下移一行。 任务将按其在列表中出现的顺序依次执行。

显示此页面

选中此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,此复选框为选中状态,并且在启动运行/调试配置时将打开 RunDebug 工具窗口。

否则,如果未选中此复选框,则工具窗口将被隐藏。 但是,在配置运行期间,您可以通过按 Alt+4Alt+5 自行打开相应的工具窗口。

最后修改日期: 2025年 9月 26日