React Native
使用 React Native与 JavaScript 和 React 开发 iOS 和 Android 的原生移动应用程序。 由 Facebook 创建，并被 Instagram、Airbnb 以及现在 JetBrains 自家的 YouTrack mobile 应用程序使用。 从 React Native 官方网站 了解更多信息。
WebStorm 帮助您创建、编辑、lint、运行、调试和维护您的 React Native 应用程序。 WebStorm 还提供 React 和 Flow 符号的代码补全。
开始之前
创建一个新的 React Native 应用程序
在 WebStorm 中创建 React Native 应用程序的推荐方法是使用专用项目生成器，例如 React Native CLI。
点击 新建项目 屏幕上的 欢迎 或从主菜单中选择 。 将打开 新建 项目 对话框。
在左侧窗格中，选择 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包的文件夹。
当您点击 创建 时，WebStorm会生成一个 React Native特定的项目，其中包含所有必需的配置文件，下载依赖项，并创建一个 React Native类型的运行/调试配置，使用默认设置。
安装用于开始使用 React Native 的其他工具，例如 iOS 模拟器。 这些工具的列表取决于您的操作系统以及您要面向的移动平台。 有关详细的安装说明，请参阅 React Native 入门指南。
从现有的 React Native 应用程序开始
要继续开发现有的 React Native 应用程序，请在 WebStorm 中打开它并下载所需的依赖项。
打开您计算机上已有的应用程序源代码
点击 打开 屏幕上的 欢迎 或从主菜单中选择 。 在打开的对话框中，选择存储源文件的文件夹。
从您的版本控制系统检出应用程序源代码
在 欢迎 屏幕上点击 克隆仓库。
或者，从主菜单中选择 、 或 。
在主菜单中，您可能会看到与您的项目关联的其他任何版本控制系统，而不是 Git。 例如， Mercurial 或 Perforce。
在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出应用程序源代码的存储库。 有关更多信息，请参阅 检出项目（克隆）。
下载依赖项
在弹出窗口中点击 运行 'npm install' 或 运行 'yarn install'：
您可以使用 npm、 Yarn 1 或 Yarn 2 ，详情请参阅 npm 和 Yarn。
或者，在编辑器中或在 项目 工具窗口 Alt+1 中，从 package.json 的上下文菜单中选择 运行 'npm install' 或 运行 'yarn install'。
从项目中排除 android 和 iOS 文件夹
在 项目 工具窗口 Alt+1 中，选择 android 或 iOS 文件夹。
从选择的上下文菜单中，选择 将目录标记为 ，然后选择 已排除。
安装用于开始使用 React Native 的其他工具，例如 iOS 模拟器。 这些工具的列表取决于您的操作系统以及您要面向的移动平台。 有关详细的安装说明，请参阅 React Native 入门指南。
项目安全性
当您打开一个在 WebStorm 外部创建并导入到其中的项目时，WebStorm 会显示一个对话框，您可以在其中决定如何处理包含不熟悉的源代码的项目。
请选择以下选项之一：
在安全模式下预览 ：在这种情况下，WebStorm 以预览模式打开项目。 这意味着您可以浏览项目的源代码，但无法运行任务和脚本，也无法运行或调试您的项目。
WebStorm 会在编辑器区域顶部显示一条通知，您可以点击 信任项目… 链接，随时加载您的项目。
信任项目 ：在这种情况下，WebStorm 会打开并加载一个项目。 这意味着项目已经初始化，项目的插件已解析，依赖项已添加，并且所有 WebStorm 功能都可用。
不打开 ：在这种情况下，WebStorm 不会打开项目。
有关更多信息，请参阅 项目安全。
编码辅助
WebStorm 在 JavaScript 代码中为 React API 和 JSX 提供代码补全功能。 代码补全适用于 React 方法、特定于 React 的属性、HTML 标签和组件名称、 React 事件 、组件属性等。 请参阅 React：完成代码以获取更多信息。
React Native StyleSheet 属性的代码补全功能也可用：
如果您在项目中使用 Flow，WebStorm 可以在编辑器中高亮显示此类型检查器中的错误。 如需更多信息，请参阅 在 WebStorm 中配置 Flow和 在 WebStorm 中使用 Flow。
运行和调试 React Native 应用程序
您可以在物理设备或模拟器上运行和调试您的应用程序。 在启动应用程序之前，请确保模拟器已经在运行，或者如果您正在使用物理设备，请确保它已连接到您的计算机。
WebStorm 使运行和调试 React Native 应用程序变得非常灵活。 例如，如果您第一次启动应用程序，您可以选择运行 React Native bundler、构建应用程序并在模拟器上打开它——这些都可以作为运行或调试会话的一部分。 您也可以跳过启动 bundler ，如果它已在运行中，或者拒绝构建应用程序，如果自上次运行以来您未对其原生代码进行任何更改。
创建 React Native 运行/调试配置
在工具栏上的 运行/调试配置 小组件中选择 编辑配置 ，点击 添加新配置 （
），然后从列表中选择 React Native 以打开 配置设置。
选择是否希望 WebStorm 为您构建和启动应用程序：
如果这是首次启动应用程序或自上次运行以来已更新其本机代码，请选中 构建和启动 复选框。
如果自上次构建以来未更改应用的原生代码，请清除该复选框的选中状态。 当您开始调试时，WebStorm 会等待您按照 React Native 官方网站 上所述启用远程调试并在模拟器中打开您的应用程序。
如果您选中了 构建和启动 复选框，请选择目标平台，Android 或 iOS。
根据您的选择，WebStorm 将使用
react-native run-ios或react-native run-android来运行 bundler。要模拟 Android 平台，请使用 Android 虚拟设备。
要模拟 iOS 平台，您需要全局安装 ios-sim command-line tool。 您可以通过 Node Package Manager (npm) ，参考 npm、pnpm 和 Yarn ，或者根据您的操作系统运行
sudo npm install ios-sim -g命令来完成。
详情请参阅 React Native 官方网站。
可选地，在 实参 字段中，输入要传递给 React Native 的参数，例如，通过
‑‑simulator标志指定模拟器类型：‑‑simulator="iPhone 4s"。指定要使用的浏览器。
在调试 React Native 应用时，WebStorm 依赖 React Native 自身使用的 Chrome 运行时。 您也可以将 DevTools 与 WebStorm 一起使用。 当您启动调试会话时，WebStorm 会启动一个新的 Chrome 实例并将其附加到该实例。 如果您不希望看到任何新的 Chrome 窗口，请使用 Chrome 无头模式。
在 打包器主机 字段中，指定运行 React Native bundler 的主机，默认值为 本地主机。
在 打包器端口 字段中，指定 React Native bundler 运行的端口，默认选择 8081 ，从 React Native 官方网站了解更多信息。
指定要使用的 Node.js 运行时。
如果您选择 项目 别名， WebStorm 将自动使用在 JavaScript 运行时 页面上 Node.js 运行时 字段中的项目默认解释器。 在大多数情况下， WebStorm 会检测到项目的默认运行时，并自动填写该字段。
您还可以选择其他已配置的本地或远程解释器，或点击
并配置一个新的解释器。有关更多信息，请参阅 配置远程 Node.js 运行时、 配置本地 Node.js 运行时 和 在适用于 Linux 的 Windows 子系统上使用 Node.js。
指定应用程序的 react-native-cli 路径和 工作目录。 如果需要，输入
react-native run-android或react-native run-ios的环境变量。默认情况下，当您调用运行/调试配置时，WebStorm 会自动启动 React Native 打包器。 如果您已经在 WebStorm 之外启动了 bundler，例如，从命令行启动，您可以在不停止和重新启动的情况下重复使用它。 在 启动前 区域选择您的 bundler并点击
。
有关所有运行/调试配置通用设置的详细信息，请参阅 运行/调试配置。
准备设备或模拟器
如果您使用的是 Android 设备，每次开始使用应用程序时都需要准备它。
iOS模拟器只需安装一次，之后 WebStorm 会自动启动它 react-native run-ios。
要准备 Android 设备，请启动 Android virtual device或启用 USB 调试并通过 USB 连接到实际 Android 设备。
详情请参阅 React Native 官方网站。
要准备一个 iOS 模拟器，请打开嵌入的 终端 （Alt+F12 ）并输入：
npm install --global ios-sim
运行应用程序
在工具栏的 运行/调试配置 小部件列表中，选择新创建的 React Native 配置，然后点击其旁边的 
。 WebStorm 打开 运行 工具窗口，并首先在新的 React Native 标签页中启动 React Native bundler。
之后，将根据所选目标平台执行 react-native run-ios 或 react-native run-android 命令。 如果构建成功，模拟器将显示您的应用程序：
调试 React Native 应用程序
使用 WebStorm，您可以调试使用原生 React Native打包器和使用 Expo的应用程序。
在调试 React Native 应用时，WebStorm 依赖 React Native 自身使用的 Chrome 运行时。 您也可以将 DevTools 与 WebStorm 一起使用。 当您启动调试会话时，WebStorm 会启动一个新的 Chrome 实例并将其附加到该实例。 如果您不希望看到任何新的 Chrome 窗口，请使用 Chrome 无头模式。
调试使用 native bundler 的 React Native 应用程序
根据需要在代码中设置 断点。
创建一个新的 React Native 运行/调试配置 如上所述。 如果 bundler 已经在 WebStorm 外部运行，请在 启动前 区域中选择它，然后点击 移除 按钮 (
)。在工具栏的 运行/调试配置 小部件列表中，选择新创建的 React Native 配置，然后点击其旁边的
。 WebStorm 打开 运行工具窗口 并在新 React Native 选项卡中运行 bundler。构建完成并且应用程序出现在模拟器中后， 打开应用中的开发者菜单并选择 远程调试 JS。 了解更多信息，请访问 React official website。
内置 WebStorm 调试器连接到模拟器。
当第一个断点被触发时，继续调试会话——逐步执行断点 ，切换帧，动态更改值， 检查挂起的程序， 评估表达式 ，并 设置监视。
在 WebStorm 中配置 Chrome Headless
请选择 从主菜单。
在 运行/调试配置 对话框中，选择一个 React Native 配置，
在 用于调试的浏览器 字段旁边，点击 浏览 按钮 (
)。 Web 浏览器和预览 对话框打开。选择 Chrome ，点击 复制 （
），并重命名复制的配置，例如，命名为 Chrome Headless。选择新的浏览器配置，点击 编辑 按钮(
)，然后在 Chrome 设置 对话框中输入 macOS 和 Linux 上的 --headless或 Windows 上的--headless --disable-gpu。在运行/调试配置中，从 用于调试的浏览器 列表中选择新的 Chrome Headless 配置。 /Users/varvara.zaikina/Library/Application Support/JetBrains/WebStorm2023.3/chrome-user-data
