从零开始搭建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 版本。如果版本不合要求,则可以去TemurinOracle 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 bashmingw等等,这些在 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环境最困难。俗话说得好,前人栽树,后人乘凉。

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

  • 13
    点赞
  • 37
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 5
    评论
要从零搭建React Native框架,你需要按照以下步骤进行操作: 1. 首先,确保你的开发环境已经安装了Node.js和npm。你可以在官方网站上下载并安装它们。 2. 打开终端或命令提示符,使用npm全局安装React Native命令行工具。运行以下命令: ``` npm install -g react-native-cli ``` 3. 创建一个新的React Native项目。在终端中,进入你想要创建项目的目录,并运行以下命令: ``` react-native init MyProject ``` 4. 进入项目目录: ``` cd MyProject ``` 5. 接下来,你需要根据你的操作系统和平台进行一些设置。 - 对于Android平台: - 确保你已经安装了Java Development Kit (JDK)。你可以从Oracle官方网站下载并安装它。 - 确保你已经安装了Android开发工具包 (Android SDK)。你可以从Android官方网站下载并安装它。 - 设置ANDROID_HOME环境变量,指向你的Android SDK的安装路径。 - 在项目的android目录下,创建一个名为local.properties的文件,并将以下内容添加到文件中: ``` sdk.dir = /path/to/your/Android/sdk ``` 将"/path/to/your/Android/sdk"替换为你的Android SDK的实际路径。 - 对于iOS平台: - 确保你已经安装了Xcode,它是开发iOS应用的官方工具。 - 在项目的ios目录下,运行以下命令来安装项目的依赖: ``` pod install ``` 6. 现在,你可以开始编写React Native代码了。在项目的app目录下,你可以编写React NativeJavaScript代码,描述应用的外观和行为。 7. 如果你需要编写Android原生代码,可以在项目的android目录下进行。同样地,如果你需要编写iOS原生代码,可以在项目的ios目录下进行。 8. 最后,你需要将React NativeJavaScript代码打包并生成相应的资源文件。在终端中,运行以下命令: ``` npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res ``` 这将生成一个名为index.android.bundle的文件,以及一些资源文件,用于在Android应用中加载React Native代码。 这样,你就成功地从零搭建了一个React Native框架。你可以根据需要继续开发和定制你的应用。 #### 引用[.reference_title] - *1* [React Native开发环境搭建详细步骤](https://blog.csdn.net/Asafoetida/article/details/123042482)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* *3* [混合框架ReactNative环境搭建](https://blog.csdn.net/qq_29848853/article/details/129839220)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

蜡笔小开心

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值