upgrading-react-native

升级 React Native

概览

涵盖完整的 React Native 升级工作流：借助 Upgrade Helper 应用模板 diff、更新依赖项、Expo SDK 升级步骤以及避坑指南。

典型升级步骤

1. 路由：通过 upgrading-react-native.md 选择合适的升级路径
2. Diff 差异对比：通过 upgrade-helper-core.md 借助 Upgrade Helper 获取官方标准的模板 diff
3. 依赖项：通过 upgrading-dependencies.md 评估并升级第三方包
4. React：若发生升级，通过 react.md 对齐 React 版本
5. Expo（若适用）：通过 expo-sdk-upgrade.md 适配 Expo SDK 层
6. 验证：通过 upgrade-verification.md 进行升级后验证

# 快速开始：检测当前版本并获取 diff
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest

# 示例：从 0.76.9 升级到 0.78.2
# 1. 下载模板 diff
curl -L -f -o /tmp/rn-diff.diff \
  "https://raw.githubusercontent.com/react-native-community/rn-diff-purge/diffs/diffs/0.76.9..0.78.2.diff" \
  && echo "Diff downloaded OK" || echo "ERROR: diff not found, check versions"
# 2. 检查变更的文件
grep -n "^diff --git" /tmp/rn-diff.diff
# 3. 更新 package.json，应用原生层变更，然后安装依赖并重新构建
npm install --prefix "$APP_DIR"
cd "$APP_DIR/ios" && pod install
# 4. 校验：两个平台都必须成功构建
npx react-native build-android --mode debug --no-packager
xcodebuild -workspace "$APP_DIR/ios/App.xcworkspace" -scheme App -sdk iphonesimulator build

适用场景

在以下场景下可参考本指南：

• 将 React Native 应用升级到新版本
• 对齐并合并来自 Upgrade Helper 的原生配置变更
• 查阅 Release Notes 并处理破坏性变更（Breaking Changes）

快速参考

文件	描述
upgrading-react-native.md	路由导航：选择正确的升级路径
upgrade-helper-core.md	核心 Upgrade Helper 工作流与可靠性卡口
upgrading-dependencies.md	依赖兼容性检查与迁移计划
react.md	React 及 React 19 升级版本对齐规则
expo-sdk-upgrade.md	Expo SDK 专项升级层（按需使用）
upgrade-verification.md	升级后验证清单，包含 Agent 设备辅助检查
monorepo-singlerepo-targeting.md	Monorepo 与 Single-repo 应用目标定位及命令作用域控制

问题与 Skill 映射

问题	建议优先参考
需要升级 React Native	upgrade-helper-core.md
需要评估依赖风险并规划迁移方案	upgrading-dependencies.md
需要对齐 React / React 19 版本	react.md
需要先确定工作流升级路径	upgrading-react-native.md
需要 Expo SDK 专项升级步骤	expo-sdk-upgrade.md
需要手动或 Agent 辅助的回归验证	upgrade-verification.md
需要限定仓库/应用命令的作用域	monorepo-singlerepo-targeting.md