跳到主要内容

升级到新版本

升级到 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` 显示为更改，那么您可以通过运行以下命令将其安装到您的项目中

shell
# {{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来清除您项目的所有缓存，然后您可以再次运行它。