PyCharm 2025.3 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 特定结构的 一个 PyCharm 项目。 或者，创建一个空的 PyCharm 项目，并在其中配置 PhoneGap 或 Cordova 支持。

从模板创建应用

  1. 在主菜单中，选择 文件 | 新建 | 项目。 或者，在欢迎界面的左侧窗格中，点击 新建 | 新建项目。

    将打开 新建 项目 对话框。

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

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

  4. 点击 创建 时，PyCharm 将生成具有特定框架结构的应用骨架。

从现有的 PhoneGap 或 Cordova 应用开始

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

在项目中配置 PhoneGap 或 Cordova

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

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

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

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

  4. 默认情况下，PyCharm 会自动将 platforms 或 www 目录视为 已排除 ，并在索引、解析和代码补全期间将其忽略；请参阅 在内容根中配置文件夹。

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

项目安全

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

不受信任的项目警告

请选择以下选项之一：

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

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

  • 信任项目 ：在这种情况下，PyCharm 打开并加载项目。 这意味着项目已初始化、项目插件已解析、已添加依赖，并且所有 PyCharm 功能均可用。

  • 不打开 ：在这种情况下，PyCharm 不会打开该项目。

详见 项目安全性。

运行 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 特定命令及其说明的列表，请参阅 PhoneGap CLI。

      • 对于 Cordova：

        • emulate

        • run

        • prepare

        • serve

        有关 Cordova 特定命令及其说明的列表，请参阅 Cordova CLI。

    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

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

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

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

      如果 PyCharm 显示以下错误消息： Cannot detect ios-sim in path ，请确保您已安装 ios-sim ，参见 在开始之前。

运行应用

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

最后修改日期： 2025年 12月 2日
最小化 JavaScriptPrettier