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