React Native
使用 React Native ,您可以使用 JavaScript 和 React 为 iOS 和 Android 开发原生移动应用。 它由 Facebook 创建,被 Instagram、Airbnb 等知名应用采用,现在 JetBrains 自家的 YouTrack 移动版 应用也在使用。 请参阅 React Native 官方网站了解更多信息。
PyCharm 可帮助您创建、编辑、执行 lint、运行、调试并维护 React Native 应用。 PyCharm 还为 React 和 Flow 符号提供代码补全。
开始之前
创建新的 React Native 应用
在主菜单中点击 。 或者,在欢迎界面的左侧窗格中点击 。
将打开 新建 项目 对话框。
在左侧窗格中选择 React Native。
在右侧窗格:
指定用于存储项目相关文件的文件夹路径。
在 Node 运行时 字段中指定要使用的 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包的文件夹。
点击 创建 后,PyCharm 将生成一个特定于 React Native 的项目,包含所有必需的配置文件,下载依赖项,并基于默认设置创建一个类型为 React Native 的运行/调试配置。
从现有 React Native 应用开始
要继续开发现有的 React Native 应用,请在 PyCharm 中将其打开并下载所需依赖项。
打开您计算机上已有的应用源代码
在 欢迎 屏幕的左侧窗格中点击 打开 ,或者从主菜单中选择 。 在打开的对话框中,选择存放源代码的文件夹。
从您的版本控制系统中检出应用源代码
在 欢迎 屏幕的左侧窗格中点击 克隆。
或者,从主菜单中选择 、 或 。
在主菜单中,可能不会显示 Git ,而是显示与您的项目关联的其他版本控制系统。 例如, Mercurial 或 Perforce。
在打开的对话框中,从列表中选择您的版本控制系统,并指定要从中检出应用源代码的存储库。 有关更多信息,请参阅 检出项目(克隆)。
下载依赖项
在弹出窗口中点击 运行 'npm install' 或 运行 'yarn install':

您可以使用 npm、 Yarn 1 或 Yarn 2 ,详细信息请参阅 npm 和 Yarn。
或者,在编辑器中的 package.json 或在 项目 工具窗口 Alt+1 的上下文菜单中,选择 运行 'npm install' 或 运行 'yarn install'。
安装用于开始使用 React Native 的其他工具,例如 iOS 模拟器。 这些工具的列表取决于您的操作系统以及您计划面向的移动平台。 有关详细的安装说明,请参阅 React Native 入门指南。
项目安全
当您打开一个在 PyCharm 之外创建并导入到其中的项目时,PyCharm 会显示一个对话框,您可以在其中决定如何处理该项目及其不熟悉的源代码。

请选择以下选项之一:
在安全模式下预览 :在这种情况下,PyCharm 以预览模式打开项目。 这意味着您可以浏览项目的源代码,但不能运行任务和脚本,也不能运行/调试您的项目。
PyCharm 会在编辑器区域顶部显示通知,您可以随时点击 信任项目… 链接来加载您的项目。
信任项目 :在这种情况下,PyCharm 会打开并加载项目。 这意味着项目已初始化、项目插件已解析、依赖项已添加,且所有 PyCharm 功能均可用。
不打开 :在这种情况下,PyCharm 不会打开项目。
了解更多信息,请参阅 项目安全性。
编码辅助
PyCharm 在 JavaScript 代码中为 React API 和 JSX 提供代码补全。 代码补全适用于 React 方法、React 特定属性、HTML 标签和组件名称、 React 事件 、组件属性等。 有关更多信息,请参阅 React:代码补全。
运行并调试 React Native 应用
您可以在物理设备或模拟器上运行并调试您的应用。 在启动应用之前,请确保模拟器已在运行;如果使用物理设备,请确保其已连接到您的计算机。
PyCharm 使运行和调试 React Native 应用非常灵活。 例如,如果您是首次启动应用,您可以选择运行 React Native 打包器、构建应用并在模拟器上打开它——以上步骤都可作为运行或调试会话的一部分完成。 如果打包器已在运行,您也可以跳过启动;如果自上次运行以来未更改其原生代码,您可以跳过构建应用。
创建 React Native 运行/调试配置
在工具栏的 运行/调试配置 小部件中选择 编辑配置 ,点击 添加新配置 按钮(
),并从列表中选择 React Native 以打开 配置设置。

选择是否让 PyCharm 为您构建并启动应用:
如果您是首次启动应用,或自上次运行后更新过其原生代码,请选中 构建并启动 复选框。
如果自上次构建以来未更改应用的原生代码,请清除此复选框。 开始调试时,PyCharm 会等待您在模拟器中打开应用,并按照 React Native 官方网站 上的说明启用远程调试。
如果您选中了 构建并启动 复选框,请选择目标平台 Android 或 iOS。
根据您的选择,PyCharm 将使用
react-native run-ios或react-native run-android运行打包器。要模拟 Android 平台,请使用 Android 虚拟设备。
要模拟 iOS 平台,您需要全局安装 ios-sim 命令行工具。 您可以通过 Node Package Manager (npm) 完成此操作,请参阅 npm、pnpm 和 Yarn ,或者根据您的操作系统运行
sudo npm install ios-sim -g命令。
了解更多信息,请参阅 React Native 官方网站。
可选地,在 实参 字段中输入要传递给 React Native 的参数,例如,通过
‑‑simulator标志指定模拟器类型:‑‑simulator="iPhone 4s"。指定要使用的浏览器。
在调试 React Native 应用时,PyCharm 依赖于 React Native 自身使用的 Chrome 运行时。 您还可以将 DevTools 与 PyCharm 配合使用。 当您启动调试会话时,PyCharm 会启动一个新的 Chrome 实例并附加到该实例。
在 Bundler 主机 字段中,指定 React Native 打包器运行所在的主机,默认值为 localhost。
在 Bundler 端口 字段中,指定 React Native 打包器运行所用的端口,默认选择 8081 ;详见 React Native 官方网站。
指定要使用的 Node.js 运行时。
如果您选择 项目 别名,PyCharm 将自动使用 JavaScript Runtime 页面中 Node 运行时 字段所定义的项目默认解释器。 在大多数情况下,PyCharm 会检测到项目的默认运行时,并自动填写该字段。
您也可以选择其他已配置的本地或远程解释器,或点击
以配置新的解释器。
指定 react-native-cli 和应用的 工作目录 的路径。 可选地,输入
react-native run-android或react-native run-ios的环境变量。默认情况下,PyCharm 会在您调用运行/调试配置时自动启动 React Native 打包器。 如果您已在 PyCharm 之外启动了打包器,例如通过命令行,则可以直接复用,而无需停止并重新启动。 在 启动前 区域中选择您的打包器,然后点击
。

有关适用于所有运行/调试配置的通用设置的更多信息,请参阅 运行/调试配置。
准备设备或模拟器
如果您使用的是 Android 设备,您每次开始处理应用时都需要准备该设备。
iOS 模拟器只需安装一次,此后 PyCharm 会通过 react-native run-ios 自动启动它。
要准备 Android 设备,请启动一个 Android 虚拟设备 ,或启用通过 USB 的调试,并通过 USB 连接到物理 Android 设备。
了解更多信息,请参阅 React Native 官方网站。
要准备 iOS 模拟器,请打开内置的 终端 (Alt+F12 ),然后输入:
<nmp_path>\npm install --global ios-sim
运行应用
在工具栏的 运行/调试配置 小部件列表中,选择新建的 React Native 配置,并点击其旁边的 。 PyCharm 会打开 运行 工具窗口,并首先在新的 React Native 选项卡中启动 React Native 打包器。
之后,将根据所选目标平台执行 react-native run-ios 或 react-native run-android 命令。 如果构建成功,模拟器将显示您的应用:
