从零开始搭建React Native完整原生环境（保姆级）

欢迎使用 React Native！这篇文档会帮助你搭建基本的 React Native 开发环境。

许多不同类型的人都在使用 React Native：从高级 iOS 开发人员到 React 初学者，再到职业生涯中第一次开始编程的人。

根据你所使用的操作系统、针对的目标平台不同，具体步骤有所不同。如果想同时开发 iOS 和 Android 也没问题，你只需要先选一个平台开始，另一个平台的环境搭建只是稍有不同。 

官网地址： React Native 中文网

必须安装的依赖有：Node、JDK 和 Android Studio。

虽然你可以使用任何编辑器来开发应用（编写 js 代码），但你仍然必须安装 Android Studio 来获得编译 Android 应用所需的工具和环境。

 正文开始

一、下载安装 Node 和Java SE Development Kit (JDK)

 下载安装nodeNode.js官网

注意：强烈建议始终选择 Node 当前的 LTS （长期维护）版本，一般是偶数版本，不要选择偏实验性质的奇数版本。

 一、安装node

可以直接去node官网下载对应的node版本，但是我推荐使用NVM，因为NVM可以很方便的切换版本，避免后续接手旧项目还得很麻烦的处理node降级的问题。
NVM的安装使用后续会出详细教程，尽请期待……

 1.node安装教程

安装位置最好不要进行改动 

一些npm模块需要在安装时从C/C++编译。如果您希望能够安装这些模块，则需要安装一些工具(Python和Visual Studio Build tools)。如有需要可进行勾选。

勾选后node安装完成时会自动弹出powershell窗口，安装Python和Visual Studio Build tools和相关依赖

注意：勾选时请注意C盘空间，将下载安装将近20G左右的相关依赖包！！！

 下面就直接点击Install进行安装即可，因为我已经安装过下面的内容就不展示了

 2.使用node -v指令来测试node有无安装成功

node -v
v18.16.0

 3.安装yarn

注意：不要使用 cnpm！cnpm 安装的模块路径比较奇怪，packager 不能正常识别！

Yarn是 Facebook 提供的替代 npm 的工具，可以加速 node 模块的下载。

第一步骤已经安装了node，现在可以打开cmd执行以下命令；

npm install -g yarn

个人习惯使用pnpm，和yarn作用功能一样。

npm install -g pnpm

安装完 yarn 之后就可以用 yarn 代替 npm 了，例如用yarn代替npm install命令，用yarn add 某第三方库名代替npm install 某第三方库名。

注意：如果vscode编译器的终端输入yarn的命令报错“无法将 yarn 项识别为…”，原因是vscode中的集成终端使用的是powershell，那么我们就需要设置一下powershell的执行权限。

设置powershell的执行权限：

1.在开始搜索框(win+s)中搜索powershell，右键，以管理员身份运行

这里使用win11进行演示，win10步骤一样

 2.执行set-ExecutionPolicy RemoteSigned命令，并输入Y选项

set-ExecutionPolicy RemoteSigned

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为“N”): Y

这里如果选择y还是出现“无法将 yarn 项识别为…”的问题请输入A

 二、安装Java SE Development Kit (JDK)

 React Native 需要 Java Development Kit [JDK] 11。你可以在命令行中输入 javac -version（请注意是 javac，不是 java）来查看你当前安装的 JDK 版本。如果版本不合要求，则可以去Temurin或Oracle JDK上下载(后者下载需注册登录)。

注意：搭建React Native原生环境必须使用Java Development Kit [JDK] 11

注意：低于 0.67 版本的 React Native 需要 JDK 1.8 版本（官方也称 8 版本）。

如果无法更改JDK版本那就放弃吧，请移步至Expo搭建教程：

1. 下载Java Development Kit [JDK]

这里建议使用Oracle JDK的方式，下载地址

打开官网，如下图所示，点击下载jdk-11.0.20_windows-x64_bin.exe文件，因为安装exe文件后，会自动配置环境变量，无需手动配置。

 2、同意协议后继续下载

点击第一步后会打开如下弹窗：

 3、登录/注册Oracle

有账号的小伙伴可以直接进行登录，如果没有注册过，需要先注册后登录

 需要填很多很多很多的信息，慢慢来小伙子，要有耐心！心急吃不了热豆腐

 4、安装jdk-11.0.20_windows-x64_bin.exe

安装这个就很简单，直接一路下一步就好了，安装路径建议用默认路径。我这里安装过就不展示了

 5、查看是否安装成功

打开cmd，输入 javac -version ,如果能看到版本号就说明安装成功了

javac -version
javac 11.0.20

 二、搭建Android 开发环境

搭建Android 开发环境是很麻烦的，官网也没有说得很详细，搭建过程是有一点坑的，本文就手把手教你搭建Android 开发环境，带你少走一些弯路。

如果你之前没有接触过 Android 的开发环境，那么请做好心理准备，这一过程相当繁琐。请万分仔细地阅读下面的说明，严格对照文档进行配置操作。

 一、下载 Android Studio

国内用户可能无法打开官方链接，那就需要先连接VPN，再进入官方链接下载。没有VPN就自行使用搜索引擎搜索可用的下载链接。

这里推荐一款自己使用的加速器。简单好，用易上手，可对gitHub、Twitch、公共CDN、Discord、Uplay、国外验证码平台等进行加速，详细请移步：Watt Toolkit

点击进入 Android Studio 

 点击滑动到底部勾选协议

 下载得到 android-studio-2022.2.1.19-windows.exe，双击打开安装

 二、安装 Android Studio

作为资深安装工程师，告诉你安装技巧就是，一路Next，最后Install。

 勾选打开Android Studio会自动打开Android Studio

三、配置Android Studio

 1、选择方式

打开后会弹出一个弹窗如下，默认选择第二个选项就好

 2、是否要配置代理

下一步如果出现如下弹窗，就是想让你配置一个代理，在我们没有熟悉 Android Studio或者没有经常用的时候，这个配置无需理会，点击 Cancel 关闭弹窗

 3、进入初始配置页面，点击Next

 4、选择自定义安装

 5、选择安装路径

这里使用默认路径即可，直接Next

6.选择主题背景颜色 

选哪个都无所谓，看个人喜欢

 7、勾选要下载的内容

注意：不一定要下载这个模拟器，可以使用第三方模拟器（例如：雷电模拟器），使用第三方模拟器的用法我就不介绍了，本文只介绍Android 官方提供的Android Virtual Device模拟器，我觉得还是很好用的。

重点来了，一共需要下载的包是1.97G，这个Android Virtual Device包就占了1.44G，走下一步会下载得非常慢，有时候是下载进度一动不动，不过没关系，后面会讲解决方案，先继续走。

像下图这样全部勾上，包括Android Virtual Device，Android SDK Location路径也是默认就好(防止后续找不到)，点击 Next 走下一步： 

注意 ：安装路径中不要有中文，否则无法Next

 8、这一步是检测到你可以设置系统加速，推荐就好，继续点击 Next 走下一步：

 9、安装确认，点击Next

 10、要下载的详情

显示都需要安装什么包，继续Next

 11、同意协议

分别点击左边的三个项目，勾选右边的 Accept 表示同意协议，然后点击 Finish：

 12、进入安装个个包的界面

点击 Show Details 查看要下载的具体内容

 13、拿到模拟器链接

这一步主要是防止模拟器文件下载失败，或者下载速度慢的问题

重点来了，把下载模拟器包的链接复制出来：

https://dl.google.com/android/repository/sys-img/google_apis/x86_64-33_r10.zip

以后可能下载路径会变动，最好自行复制，看到带有x86_64的zip包就没错

 14、下载模拟器包x86_64-33_r10.zip

把复制链接放到浏览器地址栏，回车下载，直接就是满速下载，无需挂代理

十几分钟就下载好了，可以让它先下载，先走后续的步骤。

 15、关闭下载，关闭Android Studio

注意：如果第12步没有出错，后续可省略

先点击 Cancel 关闭下载 ，然后点击 Finish，然后点击右上角 X 关闭Android Studio：

 16、重新打开Android Studio

重新打开Android Studio，就又回到初始步骤，按照之前的步骤继续走。

重点：走到下面这一步的时候，把Android Virtual Device取消勾选，可以看到 Total download size只有224M(这样后面下载包当然就很快)，然后继续 Next，后续的步骤和上面一样。

 17、下载完成

注意：下载完成的时候，可能程序会自动给你配置系统环境变量，如果你安装了360之类的安全软件，会提示你 检测到有程序尝试修改系统设置，这时候一定要允许，不然后续可能得自己配置环境变量了，怎么配置就先自行百度了（后续会出详细教程）。

 点击 Finish 完成

 18、打开项目

打开react native项目，还没项目的就先去 new 一个项目：

 19、打开SDK Manager

打开项目后，就会像下图这么展示，

 点击左上角File，选择Settings，搜索Android SDK，复制下图Sdk路径

粘贴到文件夹目录，回车打开Sdk目录：

 20、解压模拟器

在Sdk目录下面找到x86_64文件夹，把（14）步骤下载的模拟器压缩包（这个包解压出来刚好是x86_64文件夹）解压到这个目录替换掉这个文件夹，如下：

 21、配置SDK

关闭Android Studio，再次打开SDK Manager

在 SDK Manager 中选择”SDK Platforms”选项卡，然后在右下角勾选”Show Package Details”。

展开Android 13 (Tiramisu)选项，确保勾选了 Android SDK Platform 33 和 Google APIs Intel x86 Atom System Image(这个就是上一步解压的模拟器包，前面是横杠说明已经配置好，无需再勾选下载) ，如下：

然后点击”SDK Tools”选项卡，同样勾中右下角的”Show Package Details”。展开”Android SDK Build-Tools”选项，确保选中了 React Native 所必须的33.0.0版本。你可以同时安装多个其他版本。

注意：这里必须确保选中了 React Native 所必须的33.0.0版本，否则React Native无法运行

 然后点击”Apply”来下载和安装这些组件，弹窗确认，点击 ok

 等待下载完成点击Finish，然后关闭SDK Manager即可

 22、创建模拟器

点击 Create device 按钮

 23、配置ANDROID_HOME 环境变量

React Native 需要通过环境变量来了解你的 Android SDK 装在什么路径，从而正常进行编译。

打开控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 -> 高级 -> 环境变量 -> 新建，创建一个名为ANDROID_HOME的环境变量（系统或用户变量均可），指向你的 Android SDK 所在的目录，具体的路径可能和下图不一致，请自行确认，

参考第19步打开SDK Manager，复制SDK路径：

 24、把一些工具目录添加到环境变量 Path

打开控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 -> 高级 -> 环境变量，选中Path变量，然后点击编辑。点击新建然后把这些工具目录路径添加进去：platform-tools、emulator、tools、tools/bin

%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
%ANDROID_HOME%\tools
%ANDROID_HOME%\tools\bin

 你需要关闭现有的命令符提示窗口然后重新打开，这样新的环境变量才能生效。

 三、创建运行React Native项目

 一、创建React Native项目

如果你之前全局安装过旧的react-native-cli命令行工具，请使用npm uninstall -g react-native-cli卸载掉它以避免一些冲突： 

npm uninstall -g react-native-cli @react-native-community/cli

#安装新版本react-native
npm install react-native -g

必须要看的注意事项一：请不要在目录、文件名中使用中文、空格等特殊符号。请不要单独使用常见的关键字作为项目名（如 class, native, new, package 等等）。请不要使用与核心模块同名的项目名（如 react, react-native 等）。

必须要看的注意事项二：请不要在某些权限敏感的目录例如 System32 目录中 init 项目！会有各种权限限制导致不能运行！

必须要看的注意事项三：请不要使用一些移植的终端环境，例如git bash或mingw等等，这些在 windows 下可能导致找不到环境变量。请使用系统自带的命令行（CMD 或 powershell）运行。

使用 React Native 内建的命令行工具来创建一个名为”AwesomeProject”的新项目。这个命令行工具不需要安装，可以直接用 node 自带的npx命令来使用：

npx react-native@latest init AwesomeProject

 二、运行React Native项目 

确保你先运行了模拟器或者连接了真机，然后在你的项目目录中运行yarn android或者yarn react-native run-android：

cd AwesomeProject
yarn android
# 或者
yarn react-native run-android

 输入命令后会自动进行一系列的打包编译工作，并自动安装到模拟器或者你的真机上：

 自动弹出界面：

 一般情况下会自动唤出模拟器，如果在真机环境下请保持USB连接，并且处于解锁状！

 最后最后最后：

总结：所有操作和问题都是自己一步一个坎淌出来的，都说创建原生React Native环境最困难。俗话说得好，前人栽树，后人乘凉。

希望这篇文章可以帮到大家，感谢您的阅读❥(^_-)