跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >Version: Next

更新

时刻将 React Native 更新到最新的版本,可以获得更多 API、视图、开发者工具以及其他一些好东西(译注:官方开发任务繁重,人手紧缺,几乎不会对旧版本提供维护支持,所以即便更新可能带来一些兼容上的变更,但建议开发者还是尽一切可能第一时间更新)。由于一个完整的 React Native 项目是由 Android 项目、iOS 项目和 JavaScript 项目组成的,且都打包在一个 npm 包中,所以升级可能会有一些麻烦。我们会尽量简化这一流程。你可以在项目目录下使用npx react-native info命令查看当前的版本。

译注:英文更新日志点这里查看

React Native 项目

因为典型的 React Native 项目本质上是由一个 Android 项目、一个 iOS 项目和一个 JavaScript 项目组成的,所以升级可能会相当麻烦。Upgrade Helper 是一个网页工具,可以帮助你通过提供任何两个版本之间的所有变更来升级你的应用。它还显示了特定文件的评论,以帮助理解为什么需要进行该变更。

1. 选择版本

首先,你需要从和到哪个版本进行升级,默认情况下会选中最新的主要版本。选择后,可以点击 "Show me how to upgrade" 按钮。

💡 重大更新会在顶部显示一个 "useful content" 部分,其中包含一些链接,以帮助你升级。

2. 升级依赖

首先显示的文件是 package.json,更新其中的依赖是个不错的选择。例如,如果 react-nativereact 出现在变更中,你可以通过运行以下命令来安装它们:

# {{VERSION}} and {{REACT_VERSION}} are the release versions showing in the diff
npm install react-native@{{VERSION}}
npm install react@{{REACT_VERSION}}

3. 升级项目文件

新版本可能包含更新了其他文件,这些文件是在你运行 npx react-native init 时生成的,这些文件列在 Upgrade Helper 页面的 package.json 之后。如果没有其他变更,你只需要重新构建项目即可继续开发。如果有变更,你需要手动应用它们到你的项目中。

常见问题

我已经完成了所有变更,但我的应用仍在使用旧版本

这些错误通常与缓存有关,建议安装 react-native-clean-project 来清除所有项目的缓存,然后重新运行。

Expo 项目

升级到 React Native 的新版本需要更新 package.json 文件中的 react-nativereactexpo 包版本。Expo 建议逐步升级 SDK 版本,一次一个。这样做将帮助你找出升级过程中出现的错误和问题。有关升级项目的最新信息,请参阅 Upgrading Expo SDK Walkthrough