跳至主要内容

升级到新版本

升级到新版本的 React Native 将使您可以访问更多 API、视图、开发者工具和其他好东西。升级需要少量工作，但我们会尽力让它变得简单。

Expo 项目​

将您的 Expo 项目升级到新版本的 React Native 需要更新 package.json 文件中 react-native、react 和 expo 包的版本。Expo 建议逐步升级 SDK 版本，一次升级一个。这样做将有助于您查明升级过程中出现的故障和问题。请参阅 Expo SDK 升级指南，获取有关升级项目的最新信息。

React Native 项目​

由于典型的 React Native 项目基本上由 Android 项目、iOS 项目和 JavaScript 项目组成，因此升级可能相当棘手。 升级助手 是一款网络工具，可通过提供任何两个版本之间发生的所有更改来帮助您升级应用。它还显示有关特定文件的注释，以帮助您理解为什么需要进行此更改。

1. 选择版本​

您首先需要选择要升级的版本范围，默认情况下会选择最新的主要版本。选择后，您可以点击“显示升级方法”按钮。

💡 主要更新将在顶部显示一个“有用内容”部分，其中包含在升级时帮助您的链接。

2. 升级依赖项​

显示的第一个文件是 package.json，最好更新其中显示的依赖项。例如，如果 react-native 和 react 显示为更改，则可以通过运行以下命令在您的项目中安装它们

# {{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 时生成的其它文件的更新，这些文件在 升级助手 页面中 package.json 后列出。如果没有其他更改，则只需要重建项目即可继续开发。如果存在更改，则需要手动将其应用到您的项目中。

故障排除​

我已经进行了所有更改，但我的应用仍在使用旧版本​

此类错误通常与缓存相关，建议安装 react-native-clean-project 来清除项目的所有缓存，然后可以再次运行它。