设置你的开发环境
在本指南中,你将学习如何设置你的开发环境,以便能够使用 Android Studio 和 Xcode 运行你的项目。这将使你能够使用 Android 模拟器和 iOS 模拟器进行开发,在本地构建你的应用等等。
本指南需要 Android Studio 或 Xcode。如果你已经安装了其中一个程序,你应该能在几分钟内开始运行。如果尚未安装,你可能需要花费大约一个小时来安装和配置它们。
是否必须设置我的开发环境?
如果你正在使用 Framework,则无需设置你的开发环境。使用 React Native Framework 时,你不需要设置 Android Studio 或 Xcode,因为 Framework 会为你处理原生应用的构建。
如果存在限制使你无法使用 Framework,或者你希望编写自己的 Framework,那么设置本地开发环境是必需的。环境设置完成后,请学习如何在不使用 Framework 的情况下开始。
开发操作系统
- macOS
- Windows
- Linux
目标操作系统
- Android
- iOS
安装依赖项
你需要 Node、Watchman、React Native 命令行界面、JDK 和 Android Studio。
虽然你可以使用任何你选择的编辑器来开发应用,但你需要安装 Android Studio 以设置必要的工具来构建你的 React Native Android 应用。
Node 与 Watchman
我们建议使用 Homebrew 安装 Node 和 Watchman。安装 Homebrew 后,在终端中运行以下命令:
brew install node
brew install watchman
如果你已在系统上安装了 Node,请确保其版本为 Node 18.18 或更高。
Watchman 是 Facebook 开发的用于监控文件系统变化的工具。强烈建议你安装它以获得更好的性能。
Java 开发工具包
我们建议使用 Homebrew 安装名为 Azul Zulu 的 OpenJDK 发行版。安装 Homebrew 后,在终端中运行以下命令:
brew install --cask zulu@17
# Get path to where cask was installed to find the JDK installer
brew info --cask zulu@17
# ==> zulu@17: <version number>
# https://www.azul.com/downloads/
# Installed
# /opt/homebrew/Caskroom/zulu@17/<version number> (185.8MB) (note that the path is /usr/local/Caskroom on non-Apple Silicon Macs)
# Installed using the formulae.brew.sh API on 2024-06-06 at 10:00:00
# Navigate to the folder
open /opt/homebrew/Caskroom/zulu@17/<version number> # or /usr/local/Caskroom/zulu@17/<version number>
打开 Finder 后,双击 `Double-Click to Install Azul Zulu JDK 17.pkg` 包以安装 JDK。
JDK 安装完成后,请在 `~/.zshrc`(或 `~/.bash_profile`)中添加或更新你的 `JAVA_HOME` 环境变量。
如果你按照上述步骤操作,JDK 很可能位于 `/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home`
export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
Zulu OpenJDK 发行版提供了适用于 Intel 和 M1 Mac 的 JDK。与使用基于 Intel 的 JDK 相比,这将确保你的构建在 M1 Mac 上更快。
如果你已在系统上安装了 JDK,我们推荐 JDK 17。使用更高版本的 JDK 可能会遇到问题。
Android 开发环境
如果你是 Android 开发新手,设置开发环境可能会有些繁琐。如果你已经熟悉 Android 开发,你可能需要配置一些内容。无论哪种情况,请务必仔细遵循接下来的几个步骤。
1. 安装 Android Studio
下载并安装 Android Studio。在 Android Studio 安装向导中,请确保勾选了以下所有项目旁边的复选框:
Android SDK
Android SDK 平台
Android 虚拟设备
然后,点击“Next”安装所有这些组件。
如果复选框显示为灰色,你将有机会稍后安装这些组件。
设置完成后,当你看到欢迎屏幕时,请继续下一步。
2. 安装 Android SDK
Android Studio 默认安装最新的 Android SDK。然而,使用原生代码构建 React Native 应用特别需要 `Android 15 (VanillaIceCream)` SDK。可以通过 Android Studio 中的 SDK Manager 安装额外的 Android SDK。
为此,打开 Android Studio,点击“More Actions”按钮并选择“SDK Manager”。
SDK Manager 也可以在 Android Studio 的“Settings”对话框中找到,路径为 Languages & Frameworks → Android SDK。
在 SDK Manager 中选择“SDK Platforms”选项卡,然后勾选右下角的“Show Package Details”旁边的复选框。找到并展开 `Android 15 (VanillaIceCream)` 条目,然后确保勾选以下项目:
Android SDK Platform 35
Intel x86 Atom_64 System Image
或Google APIs Intel x86 Atom System Image
或(适用于 Apple M1 芯片)Google APIs ARM 64 v8a System Image
接下来,选择“SDK Tools”选项卡,并同样勾选“Show Package Details”旁边的复选框。找到并展开“Android SDK Build-Tools”条目,然后确保选择了 `35.0.0`。
最后,点击“Apply”下载并安装 Android SDK 及相关构建工具。
3. 配置 ANDROID_HOME 环境变量
React Native 工具需要设置一些环境变量,以便使用原生代码构建应用。
将以下行添加到你的 `~/.zprofile` 或 `~/.zshrc`(如果你正在使用 `bash`,则添加到 `~/.bash_profile` 或 `~/.bashrc`)配置文件中:
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
运行 `source ~/.zprofile`(或 `bash` 用户运行 `source ~/.bash_profile`)将配置加载到当前 shell 中。通过运行 `echo $ANDROID_HOME` 验证 ANDROID_HOME 是否已设置,并通过运行 `echo $PATH` 验证相应的目录是否已添加到你的路径中。
请确保使用正确的 Android SDK 路径。你可以在 Android Studio 的“Settings”对话框中,通过 Languages & Frameworks → Android SDK 找到 SDK 的实际位置。
准备 Android 设备
你需要一个 Android 设备来运行你的 React Native Android 应用。这可以是一个物理 Android 设备,或者更常见的是,你可以使用 Android 虚拟设备(AVD)在你的计算机上模拟一个 Android 设备。
无论哪种方式,你都需要准备好设备以运行用于开发的 Android 应用。
使用物理设备
如果你有一个物理 Android 设备,你可以通过 USB 数据线将其连接到你的计算机,并按照此处的说明,用它代替 AVD 进行开发。
使用虚拟设备
如果你使用 Android Studio 打开 ./AwesomeProject/android
,你可以通过 Android Studio 中的“AVD Manager”查看可用的 Android 虚拟设备(AVD)列表。寻找一个看起来像这样的图标:
如果你最近安装了 Android Studio,你可能需要创建一个新的 AVD。选择“Create Virtual Device...”,然后从列表中选择任意一款手机并点击“Next”,然后选择 VanillaIceCream API Level 35 镜像。
点击“Next”然后“Finish”来创建你的 AVD。此时,你应该能够点击 AVD 旁边的绿色三角形按钮来启动它。
就是这样!
恭喜!你已成功设置开发环境。

接下来做什么?
- 如果你想将这些新的 React Native 代码添加到现有应用中,请查阅集成指南。
- 如果你想了解更多关于 React Native 的信息,请查阅React Native 简介。
安装依赖项
你需要 Node、Watchman、React Native 命令行界面、Xcode 和 CocoaPods。
虽然你可以使用任何你选择的编辑器来开发应用,但你需要安装 Xcode 以设置必要的工具来构建你的 React Native iOS 应用。
Node 与 Watchman
我们建议使用 Homebrew 安装 Node 和 Watchman。安装 Homebrew 后,在终端中运行以下命令:
brew install node
brew install watchman
如果你已在系统上安装了 Node,请确保其版本为 Node 18.18 或更高。
Watchman 是 Facebook 开发的用于监控文件系统变化的工具。强烈建议你安装它以获得更好的性能。
Xcode
请使用 最新版本 的 Xcode。
安装 Xcode 最简单的方法是通过 Mac App Store。安装 Xcode 还会同时安装 iOS 模拟器以及构建 iOS 应用所需的所有工具。
命令行工具
你还需要安装 Xcode 命令行工具。打开 Xcode,然后从 Xcode 菜单中选择 Settings...(或 Preferences...)。前往 Locations 面板,在 Command Line Tools 下拉菜单中选择最新版本以安装工具。
在 Xcode 中安装 iOS 模拟器
要安装模拟器,请打开 Xcode > Settings...(或 Preferences...)并选择 Platforms(或 Components)选项卡。选择你希望使用的相应 iOS 版本的模拟器。
如果你使用的是 Xcode 14.0 或更高版本来安装模拟器,请打开 Xcode > Settings > Platforms 选项卡,然后点击“+”图标并选择 iOS… 选项。
CocoaPods
CocoaPods 是适用于 iOS 的依赖管理系统之一。CocoaPods 是一个 Ruby gem。你可以使用 macOS 最新版本随附的 Ruby 版本安装 CocoaPods。
欲了解更多信息,请访问CocoaPods 入门指南。
[可选] 配置你的环境
从 React Native 0.69 版本开始,可以使用模板提供的 .xcode.env
文件配置 Xcode 环境。
.xcode.env
文件包含一个环境变量,用于将 node
可执行文件的路径导出到 NODE_BINARY
变量中。这是将构建基础设施与系统 node
版本解耦的推荐方法。如果与默认值不同,你应该使用你自己的路径或你自己的 node
版本管理器来自定义此变量。
除此之外,还可以添加任何其他环境变量,并在你的构建脚本阶段引用 .xcode.env
文件。如果你需要运行需要特定环境的脚本,这是推荐的方法:它允许将构建阶段与特定环境解耦。
就是这样!
恭喜!你已成功设置开发环境。

接下来做什么?
- 如果你想将这些新的 React Native 代码添加到现有应用中,请查阅集成指南。
- 如果你想了解更多关于 React Native 的信息,请查阅React Native 简介。
目标操作系统
- Android
- iOS
安装依赖项
你需要 Node、React Native 命令行界面、JDK 和 Android Studio。
虽然你可以使用任何你选择的编辑器来开发应用,但你需要安装 Android Studio 以设置必要的工具来构建你的 React Native Android 应用。
Node、JDK
我们建议通过 Chocolatey(一个流行的 Windows 包管理器)安装 Node。
建议使用 Node 的 LTS 版本。如果你希望能够在不同版本之间切换,你可能需要通过 nvm-windows(一个 Windows 上的 Node 版本管理器)安装 Node。
React Native 还需要 Java SE Development Kit (JDK),也可以使用 Chocolatey 安装。
打开管理员命令提示符(右键点击命令提示符并选择“以管理员身份运行”),然后运行以下命令:
choco install -y nodejs-lts microsoft-openjdk17
如果你已在系统上安装了 Node,请确保其版本为 Node 18 或更高。如果你已在系统上安装了 JDK,我们推荐 JDK 17。使用更高版本的 JDK 可能会遇到问题。
你可以在 Node 的下载页面上找到更多安装选项。
如果你正在使用最新版本的 Java 开发工具包,你需要更改项目的 Gradle 版本,使其能够识别 JDK。你可以通过前往
{project root folder}\android\gradle\wrapper\gradle-wrapper.properties
并更改distributionUrl
值来升级 Gradle 版本。你可以在此处查看 Gradle 的最新版本。
Android 开发环境
如果你是 Android 开发新手,设置开发环境可能会有些繁琐。如果你已经熟悉 Android 开发,你可能需要配置一些内容。无论哪种情况,请务必仔细遵循接下来的几个步骤。
1. 安装 Android Studio
下载并安装 Android Studio。在 Android Studio 安装向导中,请确保勾选了以下所有项目旁边的复选框:
Android SDK
Android SDK 平台
Android 虚拟设备
- 如果你尚未启用 Hyper-V:
性能 (Intel ® HAXM)
(AMD 或 Hyper-V 请看这里)
然后,点击“Next”安装所有这些组件。
如果复选框显示为灰色,你将有机会稍后安装这些组件。
设置完成后,当你看到欢迎屏幕时,请继续下一步。
2. 安装 Android SDK
Android Studio 默认安装最新的 Android SDK。然而,使用原生代码构建 React Native 应用特别需要 `Android 15 (VanillaIceCream)` SDK。可以通过 Android Studio 中的 SDK Manager 安装额外的 Android SDK。
为此,打开 Android Studio,点击“More Actions”按钮并选择“SDK Manager”。
SDK Manager 也可以在 Android Studio 的“Settings”对话框中找到,路径为 Languages & Frameworks → Android SDK。
在 SDK Manager 中选择“SDK Platforms”选项卡,然后勾选右下角的“Show Package Details”旁边的复选框。找到并展开 `Android 15 (VanillaIceCream)` 条目,然后确保勾选以下项目:
Android SDK Platform 35
Intel x86 Atom_64 系统镜像
或Google APIs Intel x86 Atom 系统镜像
接下来,选择“SDK Tools”选项卡,并同样勾选“Show Package Details”旁边的复选框。找到并展开 `Android SDK Build-Tools` 条目,然后确保选择了 `35.0.0`。
最后,点击“Apply”下载并安装 Android SDK 及相关构建工具。
3. 配置 ANDROID_HOME 环境变量
React Native 工具需要设置一些环境变量,以便使用原生代码构建应用。
- 打开 Windows 控制面板。
- 点击 用户账户, 然后再次点击 用户账户
- 点击 更改我的环境变量
- 点击 新建... 创建一个新的
ANDROID_HOME
用户变量,指向你的 Android SDK 路径
SDK 默认安装在以下位置:
%LOCALAPPDATA%\Android\Sdk
你可以在 Android Studio 的“Settings”对话框中,通过 Languages & Frameworks → Android SDK 找到 SDK 的实际位置。
打开一个新的命令提示符窗口,以确保在继续下一步之前加载新的环境变量。
- 打开 powershell
- 将 Get-ChildItem -Path Env:\ 复制并粘贴到 powershell 中
- 验证
ANDROID_HOME
是否已添加
4. 将 platform-tools 添加到 Path
- 打开 Windows 控制面板。
- 点击 用户账户, 然后再次点击 用户账户
- 点击 更改我的环境变量
- 选择 Path 变量。
- 点击 编辑。
- 点击 新建 并将 platform-tools 的路径添加到列表中。
此文件夹的默认位置是:
%LOCALAPPDATA%\Android\Sdk\platform-tools
准备 Android 设备
你需要一个 Android 设备来运行你的 React Native Android 应用。这可以是一个物理 Android 设备,或者更常见的是,你可以使用 Android 虚拟设备(AVD)在你的计算机上模拟一个 Android 设备。
无论哪种方式,你都需要准备好设备以运行用于开发的 Android 应用。
使用物理设备
如果你有一个物理 Android 设备,你可以通过 USB 数据线将其连接到你的计算机,并按照此处的说明,用它代替 AVD 进行开发。
使用虚拟设备
如果你使用 Android Studio 打开 ./AwesomeProject/android
,你可以通过 Android Studio 中的“AVD Manager”查看可用的 Android 虚拟设备(AVD)列表。寻找一个看起来像这样的图标:
如果你最近安装了 Android Studio,你可能需要创建一个新的 AVD。选择“Create Virtual Device...”,然后从列表中选择任意一款手机并点击“Next”,然后选择 VanillaIceCream API Level 35 镜像。
如果你没有安装 HAXM,请点击“Install HAXM”或按照这些说明进行设置,然后返回 AVD Manager。
点击“Next”然后“Finish”来创建你的 AVD。此时,你应该能够点击 AVD 旁边的绿色三角形按钮来启动它。
就是这样!
恭喜!你已成功设置开发环境。

接下来做什么?
- 如果你想将这些新的 React Native 代码添加到现有应用中,请查阅集成指南。
- 如果你想了解更多关于 React Native 的信息,请查阅React Native 简介。
目标操作系统
- Android
- iOS
安装依赖项
你需要 Node、React Native 命令行界面、JDK 和 Android Studio。
虽然你可以使用任何你选择的编辑器来开发应用,但你需要安装 Android Studio 以设置必要的工具来构建你的 React Native Android 应用。
Node
请按照你的 Linux 发行版的安装说明来安装 Node 18.18 或更高版本。
Java 开发工具包
React Native 目前推荐 Java SE Development Kit (JDK) 17 版本。使用更高版本的 JDK 可能会遇到问题。你可以从 OpenJDK 或 AdoptOpenJDK 或你的系统包管理器下载并安装。
Android 开发环境
如果你是 Android 开发新手,设置开发环境可能会有些繁琐。如果你已经熟悉 Android 开发,你可能需要配置一些内容。无论哪种情况,请务必仔细遵循接下来的几个步骤。
1. 安装 Android Studio
下载并安装 Android Studio。在 Android Studio 安装向导中,请确保勾选了以下所有项目旁边的复选框:
Android SDK
Android SDK 平台
Android 虚拟设备
然后,点击“Next”安装所有这些组件。
如果复选框显示为灰色,你将有机会稍后安装这些组件。
设置完成后,当你看到欢迎屏幕时,请继续下一步。
2. 安装 Android SDK
Android Studio 默认安装最新的 Android SDK。然而,使用原生代码构建 React Native 应用特别需要 `Android 15 (VanillaIceCream)` SDK。可以通过 Android Studio 中的 SDK Manager 安装额外的 Android SDK。
为此,打开 Android Studio,点击“Configure”按钮并选择“SDK Manager”。
SDK Manager 也可以在 Android Studio 的“Settings”对话框中找到,路径为 Languages & Frameworks → Android SDK。
在 SDK Manager 中选择“SDK Platforms”选项卡,然后勾选右下角的“Show Package Details”旁边的复选框。找到并展开 `Android 15 (VanillaIceCream)` 条目,然后确保勾选以下项目:
Android SDK Platform 35
Intel x86 Atom_64 系统镜像
或Google APIs Intel x86 Atom 系统镜像
接下来,选择“SDK Tools”选项卡,并同样勾选“Show Package Details”旁边的复选框。找到并展开“Android SDK Build-Tools”条目,然后确保选择了 `35.0.0`。
最后,点击“Apply”下载并安装 Android SDK 及相关构建工具。
3. 配置 ANDROID_HOME 环境变量
React Native 工具需要设置一些环境变量,以便使用原生代码构建应用。
将以下行添加到你的 `$HOME/.bash_profile` 或 `$HOME/.bashrc`(如果你正在使用 `zsh`,则添加到 `~/.zprofile` 或 `~/.zshrc`)配置文件中:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
.bash_profile
是bash
特有的。如果你正在使用其他 shell,则需要编辑相应的 shell 特定配置文件。
对于 bash
,输入 source $HOME/.bash_profile
;对于 zsh
,输入 source $HOME/.zprofile
,将配置加载到当前 shell 中。通过运行 echo $ANDROID_HOME
验证 ANDROID_HOME 是否已设置,并通过运行 echo $PATH
验证相应的目录是否已添加到你的路径中。
请确保使用正确的 Android SDK 路径。你可以在 Android Studio 的“Settings”对话框中,通过 Languages & Frameworks → Android SDK 找到 SDK 的实际位置。
Watchman
请按照Watchman 安装指南从源代码编译并安装 Watchman。
Watchman 是 Facebook 开发的用于监控文件系统变化的工具。强烈建议你安装它以获得更好的性能,并在某些边缘情况下提高兼容性(译注:你可能在不安装它的情况下也能运行,但效果可能因情况而异;现在安装它可以为你省去日后的一些麻烦)。
准备 Android 设备
你需要一个 Android 设备来运行你的 React Native Android 应用。这可以是一个物理 Android 设备,或者更常见的是,你可以使用 Android 虚拟设备(AVD)在你的计算机上模拟一个 Android 设备。
无论哪种方式,你都需要准备好设备以运行用于开发的 Android 应用。
使用物理设备
如果你有一个物理 Android 设备,你可以通过 USB 数据线将其连接到你的计算机,并按照此处的说明,用它代替 AVD 进行开发。
使用虚拟设备
如果你使用 Android Studio 打开 ./AwesomeProject/android
,你可以通过 Android Studio 中的“AVD Manager”查看可用的 Android 虚拟设备(AVD)列表。寻找一个看起来像这样的图标:
如果你最近安装了 Android Studio,你可能需要创建一个新的 AVD。选择“Create Virtual Device...”,然后从列表中选择任意一款手机并点击“Next”,然后选择 VanillaIceCream API Level 35 镜像。
我们建议在你的系统上配置虚拟机加速以提高性能。遵循这些说明后,返回 AVD 管理器。
点击“Next”然后“Finish”来创建你的 AVD。此时,你应该能够点击 AVD 旁边的绿色三角形按钮来启动它。
就是这样!
恭喜!你已成功设置开发环境。

接下来做什么?
- 如果你想将这些新的 React Native 代码添加到现有应用中,请查阅集成指南。
- 如果你想了解更多关于 React Native 的信息,请查阅React Native 简介。