升级到新版本
升级到 React Native 的新版本将为您提供更多 API、视图、开发者工具及其他功能。升级需要花费少量精力,但我们会尽量为您简化流程。
Expo 项目
将您的 Expo 项目升级到新版本的 React Native 需要更新 package.json
文件中的 react-native
、react
和 expo
包版本。Expo 建议逐步升级 SDK 版本,一次升级一个。这样做将有助于您在升级过程中找出可能出现的故障和问题。请参阅升级 Expo SDK 演练,了解有关项目升级的最新信息。
React Native 项目
由于典型的 React Native 项目本质上由一个 Android 项目、一个 iOS 项目和一个 JavaScript 项目组成,因此升级过程可能相当复杂。升级助手(Upgrade Helper)是一个网络工具,通过提供任意两个版本之间发生的所有变更来帮助您升级应用程序。它还会显示特定文件的注释,以帮助理解为什么需要该更改。
1. 选择版本
您首先需要选择要从哪个版本升级到哪个版本,默认情况下会选择最新的主要版本。选择后,您可以点击“显示升级方法”按钮。
💡 主要更新将在顶部显示一个“有用内容”部分,其中包含在升级时提供帮助的链接。
2. 升级依赖项
显示的第一个文件是 package.json
,最好更新其中显示的依赖项。例如,如果 react-native
和 react
显示为已更改,则您可以通过运行以下命令在项目中安装它们
- npm
- Yarn
# {{VERSION}} and {{REACT_VERSION}} are the release versions showing in the diff
npm install react-native@{{VERSION}}
npm install react@{{REACT_VERSION}}
# {{VERSION}} and {{REACT_VERSION}} are the release versions showing in the diff
yarn add react-native@{{VERSION}}
yarn add react@{{REACT_VERSION}}
3. 升级项目文件
新版本可能包含对运行 npx react-native init
时生成的其他文件的更新,这些文件列在升级助手页面中 package.json
之后。如果没有其他更改,则只需重新构建项目即可继续开发。如果存在更改,则需要手动将其应用到您的项目中。
故障排除
我已完成所有更改,但我的应用程序仍在使用旧版本
这类错误通常与缓存有关,建议安装 react-native-clean-project 来清除项目的所有缓存,然后您可以再次运行它。