GoLand 2025.3 Help

React Native

使用 React Native与 JavaScript 和 React 开发 iOS 和 Android 的原生移动应用程序。 由 Facebook 创建，并被 Instagram、Airbnb 以及现在 JetBrains 自家的 YouTrack mobile 应用程序使用。 从 React Native 官方网站 了解更多信息。

GoLand 帮助您创建、编辑、lint、运行、调试和维护您的 React Native 应用程序。 GoLand 还提供 React 和 Flow 符号的代码补全。

在开始之前

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

  2. 确保 JavaScript and TypeScript和 JavaScript Debugger必需插件在 设置 | 插件 页面上的 已安装 选项卡中被启用。 如需了解更多信息，请参阅 管理插件。

创建一个新的 React Native 应用程序

在 GoLand 中创建 React Native 应用程序的推荐方法是使用专用项目生成器，例如 React Native CLI。

  1. 从主菜单中选择 文件 | 新建 | 项目 ，或者在 欢迎 屏幕上点击 新建项目 按钮。

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

  3. 在向导的右侧部分，指定项目名称和创建该项目的文件夹。

  4. 在 项目类型 区域，选择 React Native。

    在 Node.js 运行时 字段中，指定要使用的 Node.js 运行时。 从列表中选择一个已配置的运行时，或选择 添加 以配置新的运行时。

    请从 React Native 列表中选择 npx --package react-native-cli react-native。

    或者，对于 npm 版本 5.1 及更早版本，请在 终端 Alt+F12 中运行 npm install -g react-native-cli ，自行安装 react-native-cli 包。 创建应用程序时，选择存储 react-native-cli 包的文件夹。

  5. 当您点击 创建 时，GoLand会生成一个 React Native特定的项目，其中包含所有必需的配置文件，下载依赖项，并创建一个 React Native类型的运行/调试配置，使用默认设置。

  6. 安装用于开始使用 React Native 的其他工具，例如 iOS 模拟器。 这些工具的列表取决于您的操作系统以及您要面向的移动平台。 有关详细的安装说明，请参阅 React Native 入门指南。

从现有的 React Native 应用程序开始

要继续开发现有的 React Native 应用程序，请在 GoLand 中打开它并下载所需的依赖项。

打开您计算机上已有的应用程序源代码

  • 点击 已打开 屏幕上的 欢迎 或从主菜单中选择 文件 | 打开。 在打开的对话框中，选择存储源文件的文件夹。

从您的版本控制系统检出应用程序源代码

  1. 在 欢迎 屏幕上点击 克隆。

    或者，从主菜单中选择 Git ｜ 克隆… 或 VCS | 从版本控制获取。

    在主菜单中，您可能会看到与您的项目关联的其他任何版本控制系统，而不是 Git。 例如， Mercurial 或 Perforce。

    check_out_from_vcs

下载依赖项

  • 在弹出窗口中点击 运行 'npm install' 或 运行 'yarn install'：

    打开应用并下载依赖项

    您可以使用 npm、 Yarn 1 或 Yarn 2 ，详情请参阅 npm 和 Yarn。

  • 或者，在编辑器或 项目 工具窗口 Alt+1 中，打开 package.json 的上下文菜单，然后选择 运行 'npm install' 或 运行 'yarn install'。

    打开 Angular 应用程序并从 package.json 下载依赖项

从项目中排除 android 和 iOS 文件夹

  1. 在 项目 工具窗口 Alt+1 中，选择 android 或 iOS 文件夹。

  2. 从选择的上下文菜单中，选择 标记目录为 ，然后选择 排除。

    标记 IOS 文件夹为排除

项目安全性

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

不受信任的项目警告

请选择以下选项之一：

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

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

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

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

有关更多信息，请参阅 项目安全。

编码辅助

GoLand 在 JavaScript 代码中为 React API 和 JSX 提供代码补全功能。 代码补全适用于 React 方法、特定于 React 的属性、HTML 标签和组件名称、 React 事件 、组件属性等。 请参阅 React：完成代码以获取更多信息。

React Native StyleSheet 属性的代码补全功能也可用：

React Native StyleSheet 属性的补全

如果您在项目中使用 Flow，GoLand 可以在编辑器中高亮显示此类型检查器中的错误。 如需更多信息，请参阅 在 GoLand 中配置 Flow和 在 WebStorm 中使用 Flow。

运行和调试 React Native 应用程序

您可以在物理设备或模拟器上运行和调试您的应用程序。 在启动应用程序之前，请确保模拟器已经在运行，或者如果您正在使用物理设备，请确保它已连接到您的计算机。

GoLand 使运行和调试 React Native 应用程序变得非常灵活。 例如，如果您第一次启动应用程序，您可以选择运行 React Native bundler、构建应用程序并在模拟器上打开它——这些都可以作为运行或调试会话的一部分。 您也可以跳过启动 bundler ，如果它已在运行中，或者拒绝构建应用程序，如果自上次运行以来您未对其原生代码进行任何更改。

创建 React Native 运行/调试配置

  1. 在工具栏上的 运行/调试配置 小组件中选择 编辑配置 ，点击 添加新配置 （添加新配置按钮 ），然后从列表中选择 React Native 以打开 配置设置。

    开始创建运行/调试配置

  2. 选择是否希望 GoLand 为您构建和启动应用程序：

    • 如果这是首次启动应用程序或自上次运行以来已更新其本机代码，请选中 构建和启动 复选框。

    • 如果自上次构建以来未更改应用的原生代码，请清除该复选框的选中状态。 当您开始调试时，GoLand 会等待您按照 React Native 官方网站 上所述启用远程调试并在模拟器中打开您的应用程序。

  3. 如果您选中了 构建和启动 复选框，请选择目标平台，Android 或 iOS。

    根据您的选择，GoLand 将使用 react-native run-ios 或 react-native run-android 来运行 bundler。

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

    • 要模拟 iOS 平台，您需要全局安装 ios-sim command-line tool。 您可以通过 Node Package Manager (npm)或根据您的操作系统运行 sudo npm install ios-sim -g 命令来完成此操作。

    详情请参阅 React Native 官方网站。

    可选地，在 实参 字段中，输入要传递给 React Native 的参数，例如，通过 ‑‑simulator 标志指定模拟器类型： ‑‑simulator="iPhone 4s"。

  4. 指定要使用的浏览器。

    在调试 React Native 应用时，GoLand 依赖 React Native 自身使用的 Chrome 运行时。 您也可以将 DevTools 与 GoLand 一起使用。 当您启动调试会话时，GoLand 会启动一个新的 Chrome 实例并将其附加到该实例。

  5. 在 打包器主机 字段中，指定运行 React Native bundler 的主机，默认值为 localhost。

  6. 在 打包器端口 字段中，指定 React Native bundler 运行的端口，默认选择 8081 ，从 React Native 官方网站了解更多信息。

  7. 指定要使用的 Node.js 运行时。

    如果您选择了 项目 别名，GoLand 将自动使用 Node.js 运行时 字段中的项目默认解释器。 在大多数情况下， GoLand 会检测到项目的默认运行时，并自动填写该字段。

    您还可以选择另一个已配置的本地解释器，或点击 “浏览”按钮 并配置一个新的。

  8. 指定应用程序的 react-native-cli 路径和 工作目录。 如果需要，输入 react-native run-android 或 react-native run-ios 的环境变量。

  9. 默认情况下，当您调用运行/调试配置时，GoLand 会自动启动 React Native 打包器。 如果您已经在 GoLand 之外启动了 bundler，例如，从命令行启动，您可以在不停止和重新启动的情况下重复使用它。 在 启动前 区域选择您的 bundler并点击 移除。

React Native 运行/调试配置

有关所有运行/调试配置通用设置的详细信息，请参阅 运行/调试配置。

准备设备或模拟器

如果您使用的是 Android 设备，每次开始使用应用程序时都需要准备它。

iOS模拟器只需安装一次，之后 GoLand 会自动启动它 react-native run-ios。

  • 要准备 Android 设备，请启动 Android virtual device或启用 USB 调试并通过 USB 连接到实际 Android 设备。

    详情请参阅 React Native 官方网站。

  • 要准备 iOS 模拟器，请打开嵌入的 终端 （Alt+F12 ）并输入：

    npm install --global ios-sim

运行应用程序

在工具栏的 运行/调试配置 小部件列表中，选择新创建的 React Native 配置，然后点击其旁边的 “运行”按钮。 GoLand 打开 运行 工具窗口，并首先在新的 React Native 标签页中启动 React Native bundler。

之后，将根据所选目标平台执行 react-native run-ios 或 react-native run-android 命令。 如果构建成功，模拟器将显示您的应用程序：

React Native 打包程序正在运行

调试 React Native 应用程序

使用 GoLand，您可以调试使用原生 React Native打包器和使用 Expo的应用程序。

在调试 React Native 应用时，GoLand 依赖 React Native 自身使用的 Chrome 运行时。 您也可以将 DevTools 与 GoLand 一起使用。 当您启动调试会话时，GoLand 会启动一个新的 Chrome 实例并将其附加到该实例。

调试使用 native bundler 的 React Native 应用程序

  1. 根据需要在代码中设置 断点。

  2. 创建一个新的 React Native 运行/调试配置 如上所述。 如果 bundler 已经在 GoLand 外部运行，请在 启动前 区域中选择它，然后点击 移除 按钮 ("移除"按钮)。

  3. 在工具栏的 运行/调试配置 小部件列表中，选择新创建的 React Native 配置，然后点击其旁边的 运行 按钮。 GoLand 打开 运行工具窗口 并在新 React Native 选项卡中运行 bundler。

  4. 构建完成并且应用程序出现在模拟器中后， 打开应用中的开发者菜单并选择 远程调试 JS。 了解更多信息，请访问 React official website。

    内置 GoLand 调试器连接到模拟器。

  5. 当第一个断点被触发时，继续调试会话——逐步执行断点 、在帧之间切换、动态更改值、 检查挂起的程序、 评估表达式 和 设置监视。

在 GoLand 中配置 Chrome Headless

  1. 请选择 运行(U) ｜ 编辑配置(R)… 从主菜单。

  2. 在 运行/调试配置 对话框中，选择一个 React Native 配置，

  3. 在 用于调试的浏览器 字段旁边，点击 浏览 按钮 (“浏览”按钮)。 Web 浏览器和预览 对话框打开。

  4. 选择 Chrome ，点击 复制 （复制按钮 ），并重命名复制的配置，例如，命名为 Chrome Headless。

  5. 选择新的浏览器配置，点击 编辑 按钮(“编辑”按钮 )，然后在 Chrome 设置 对话框中输入 macOS 和 Linux 上的 --headless 或 Windows 上的 --headless --disable-gpu。

  6. 在运行/调试配置中，从 用于调试的浏览器 列表中选择新的 Chrome Headless 配置。 /Users/varvara.zaikina/Library/Application Support/JetBrains/WebStorm2023.3/chrome-user-data

最后修改日期： 2025年 12月 5日
Closure Linter重构 JavaScript