升级到新版本
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
升级到新版本的 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. 选择版本
首先需要选择升级的起始版本和目标版本（默认选中最新主版本）。选择完成后点击 "Show me how to upgrade" 按钮。
💡 主版本更新时，页面顶部会显示 "实用内容" 区域，其中包含帮助您升级的链接。
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 清除项目所有缓存后重新运行。