react native 如何升级
升级 React Native 项目
升级 React Native 项目通常需要更新依赖项和配置文件。以下是升级的主要步骤:
检查当前版本 使用以下命令查看当前 React Native 版本:
react-native --version
更新 React Native CLI 全局更新 React Native 命令行工具:
npm install -g react-native-cli
更新项目依赖 在项目根目录下运行:

npm install react-native@latest
使用 Upgrade Helper React Native 官方提供了 Upgrade Helper 工具(https://react-native-community.github.io/upgrade-helper/),可以比较不同版本间的差异,帮助手动更新配置文件。
更新 Android 配置
- 更新
android/build.gradle中的 Gradle 版本 - 更新
android/gradle/wrapper/gradle-wrapper.properties中的 distributionUrl - 确保
android/app/build.gradle中的 compileSdkVersion 和 targetSdkVersion 是最新的
更新 iOS 配置

- 更新 Podfile 中的 React Native 相关依赖
- 运行
pod install更新 iOS 依赖
解决冲突 升级后可能需要手动解决一些冲突,特别是:
package.json中的依赖版本- 配置文件如
metro.config.js - 原生代码中的 API 变更
测试升级 完成升级后,务必全面测试应用功能:
react-native run-android
react-native run-ios
注意事项
- 建议在升级前创建分支或备份项目
- 查看 React Native 发布说明了解重大变更
- 逐步升级,不要跨多个主要版本升级
- 可能需要更新相关第三方库版本
对于大型项目,可以考虑使用第三方工具如 rn-diff-purge 来帮助升级过程更顺利。






