GoLand 2025.2 Help

运行/调试配置:React Native

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

在此对话框中,为运行 React Native 应用程序创建配置。

开始之前

访问“运行/调试配置:React Native”对话框

  1. 下载并安装 Node.js

  2. 请确保您的计算机上已安装 React Native 包,例如 react-native-cli

React Native 特定的配置设置

项目

描述

构建并启动应用程序

  • 如果是首次启动应用程序,或者自上次运行后更新了其原生代码,请选中 构建并启动 复选框。

  • 如果自上次构建以来未更改应用程序的原生代码,请取消选中该复选框。 当启动调试时,GoLand 将等待您按照 React Native 官方网站 的说明,在模拟器中打开应用程序并启用远程调试。

平台

在此区域选择应用程序的目标平台。

根据您的选择,GoLand 将使用 react-native run-iosreact-native run-android 启动打包器。

  • 要模拟 Android 平台,请使用 Android 虚拟设备

  • 要模拟 iOS 平台,需全局安装 ios-sim 命令行工具。 可通过 Node Package Manager (npm) 或根据操作系统运行 sudo npm install ios-sim -g 命令进行安装。

请参阅 React Native 官方网站 了解更多信息。

参数

在此字段中输入传递给 React Native 的参数,例如,使用 ‑‑simulator 标志指定模拟器类型: ‑‑simulator="iPhone 4s"

调试所用浏览器

在调试 React Native 应用程序时,GoLand 依赖于 React Native 使用的 Chrome 运行时环境。 您也可以将 DevTools 与 GoLand 搭配使用。 在开始调试会话时,GoLand 会启动一个新的 Chrome 实例并附加到该实例。

打包器主机

在此字段中,指定运行打包器的主机,默认值为 localhost

打包器端口

在此字段中,指定打包器运行时使用的端口。

  • GoLand 会自动选择 8081 ,这是 React Native 打包器的默认端口。 请参阅 React Native 官方网站 了解更多信息。

  • 如果应用程序使用了 Expo,可能需要根据 Expo 配置将端口更改为 1900019001

Node 解释器

在此字段中,指定要使用的 Node.js 解释器。

如果选择 项目 别名,GoLand 会自动使用 Node 解释器 字段中的项目默认解释器。 在大多数情况下,GoLand 会检测项目默认解释器,并自动填充该字段。

您也可以选择另一个已配置的本地解释器,或点击 浏览按钮 来配置新的解释器。

React Native 包

在此字段中,指定 react-native-cli 的路径。

工作目录

指定应用程序的 工作目录。 默认情况下,该字段显示 项目根文件夹

环境变量

在该字段中,您可以选择性地输入用于执行 react-native run-androidreact-native run-ios 命令的环境变量。

通用设置

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

描述

名称(N)

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

允许多个实例(U)

允许并行运行该运行配置的多个实例。

默认情况下,该选项处于禁用状态。当您在另一个实例仍在运行时启动该配置,GoLand 会建议停止正在运行的实例并启动另一个实例。 当一个运行配置占用大量资源,且没有充分理由运行多个实例时,此选项非常有用。

存储为项目文件(S)

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

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

工具栏

运行/调试配置的树形视图拥有一个工具栏,帮助您管理当前 项目 中的配置,并调整默认配置模板。

快捷键

描述

添加按钮

Alt+Insert

创建一个运行/调试配置。

删除按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

仅当您选择 临时配置 时,才会显示该按钮。 点击该按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。 您可以通过 将其放入文件夹 来对运行/调试配置进行分组。

要创建文件夹,请选择某分类下的配置,点击 文件夹 ,并指定文件夹名称。 如果仅聚焦于一个分类,则会创建一个空文件夹。

然后,若要将配置移入、移出文件夹或在文件夹间移动,请使用拖动操作或 上移下移 按钮。

若要取消分组,选择一个文件夹并点击 删除配置

排序配置

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

启动前

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

快捷键

描述

添加按钮

Alt+Insert

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

  • 启动Web 浏览器 :选择此选项以启动一个浏览器。 在打开的对话框中,选择浏览器类型并提供启动 URL。 还可指定是否以 JavaScript 调试器启动浏览器。

  • 运行外部工具 :选择此项以运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用程序。 如果尚未在 GoLand 中定义,请先添加其定义。

  • 运行另一个配置 :选择此项以执行另一个运行/调试配置,并在当前配置启动之前等待其完成。 如果您希望并行运行多个配置,请使用 复合运行/调试配置

  • 运行File Watcher :选择此选项让 GoLand 应用所有当前处于活动状态的 File Watchers

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

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

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

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

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

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

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

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

    在打开的 NPM 脚本 对话框中,指定 npm run/debug configuration settings

  • 编译TypeScript :选择此项以运行内置 TypeScript 编译器,从而确保您对 TypeScript 代码所做的全部更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选中或清除 检查错误 复选框,以在检测到任何错误时配置编译器的行为:

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

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

  • 启动React Native Bundler :选择此选项以在运行或调试会话期间自动运行打包器。 默认情况下,这是通过 react-native start 实现的。

    如果您的应用使用 Expo ,则需要通过 start npm 任务运行开发服务器。 为此,请单击 添加 ,然后在 配置 React Native 对话框中,选择 npm script 并从列表中选择 start

  • Go 命令 :选择此项以在运行程序之前执行 Go 命令。 例如,您可以运行 go generate 来在编译之前生成源代码。 在 编辑 Go 命令任务 对话框中,您可以使用自动补全功能。 自动补全支持以下命令: generatevettest -i。 您可以使用自己的命令。

删除按钮

Alt+Delete

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

编辑

Enter

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

方法上移

方法下移

Alt+Up

Alt+Down

单击这些图标可将所选任务在列表中上移或下移一行。 任务将按照它们在列表中的顺序执行。

显示此页面

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

激活工具窗口

默认情况下,此复选框处于选中状态,启动运行/调试配置时会打开 RunDebug 工具窗口。

否则,如果未选中该复选框,则工具窗口将隐藏。 但是,在配置运行时,您可以通过按 Alt+4Alt+5 来手动打开对应工具窗口。

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