跳到主要内容

设置你的开发环境

在本指南中,你将学习如何设置你的开发环境,以便能够使用 Android Studio 和 Xcode 运行你的项目。这将使你能够使用 Android 模拟器和 iOS 模拟器进行开发,在本地构建你的应用等等。

注意

本指南需要 Android Studio 或 Xcode。如果你已经安装了其中一个程序,你应该能在几分钟内开始运行。如果尚未安装,你可能需要花费大约一个小时来安装和配置它们。

是否必须设置我的开发环境?

如果你正在使用 Framework,则无需设置你的开发环境。使用 React Native Framework 时,你不需要设置 Android Studio 或 Xcode,因为 Framework 会为你处理原生应用的构建。

如果存在限制使你无法使用 Framework,或者你希望编写自己的 Framework,那么设置本地开发环境是必需的。环境设置完成后,请学习如何在不使用 Framework 的情况下开始

开发操作系统

目标操作系统

安装依赖项

你需要 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 可能会遇到问题。你可以从 OpenJDKAdoptOpenJDK 或你的系统包管理器下载并安装。

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 & FrameworksAndroid 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`)配置文件中:

shell
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

.bash_profilebash 特有的。如果你正在使用其他 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 & FrameworksAndroid 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 Manager

如果你最近安装了 Android Studio,你可能需要创建一个新的 AVD。选择“Create Virtual Device...”,然后从列表中选择任意一款手机并点击“Next”,然后选择 VanillaIceCream API Level 35 镜像。

我们建议在你的系统上配置虚拟机加速以提高性能。遵循这些说明后,返回 AVD 管理器。

点击“Next”然后“Finish”来创建你的 AVD。此时,你应该能够点击 AVD 旁边的绿色三角形按钮来启动它。

就是这样!

恭喜!你已成功设置开发环境。

接下来做什么?

  • 如果你想将这些新的 React Native 代码添加到现有应用中,请查阅集成指南
  • 如果你想了解更多关于 React Native 的信息,请查阅React Native 简介