mcpField
U
upgrading-react-native

upgrading-react-native

github.com/callstackincubator开发1.7k12.9k 次安装3 周前更新
代码仓库

关于 upgrading-react-native

供开发者升级 React Native 应用的流程指南，涵盖模板差异、依赖与 React 版本对齐、可选的 Expo 步骤及升级后验证。

主要功能

  1. 01选择升级路径
  2. 02获取 Upgrade Helper 模板差异
  3. 03评估依赖兼容性
  4. 04React 与 Expo 升级步骤
  5. 05升级后验证

适用场景

  1. 01规划 React Native 版本升级
  2. 02核对原生模板变更
  3. 03评估依赖升级风险
  4. 04检查升级后的应用是否回归

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/callstackincubator/agent-skills --skill upgrading-react-native

安装后在 Claude Code 中输入/upgrading-react-native确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
expo-sdk-upgrade.md
monorepo-singlerepo-targeting.md
react.md
upgrade-helper-core.md
upgrade-verification.md
upgrading-dependencies.md
upgrading-react-native.md

详细介绍

升级 React Native

概述

涵盖完整的 React Native 升级工作流：通过 Upgrade Helper 查看模板差异、更新依赖、执行 Expo SDK 步骤，以及处理常见问题。

典型升级顺序

  1. 规划路径：通过 upgrading-react-native.md 选择合适的升级路径
  2. 查看差异：通过 upgrade-helper-core.md 使用 Upgrade Helper 获取权威的模板差异
  3. 处理依赖：通过 upgrading-dependencies.md 评估并更新第三方软件包
  4. 处理 React：如果升级了 React Native，则通过 react.md 对齐 React 版本
  5. 处理 Expo（如适用）：通过 expo-sdk-upgrade.md 应用 Expo SDK 层
  6. 验证：通过 upgrade-verification.md 执行升级后的检查
# Quick start: detect current version and fetch diff
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest

# Example: upgrading from 0.76.9 to 0.78.2
# 1. Fetch the template 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. Review changed files
grep -n "^diff --git" /tmp/rn-diff.diff
# 3. Update package.json, apply native changes, then install + rebuild
npm install --prefix "$APP_DIR"
cd "$APP_DIR/ios" && pod install
# 4. Validate: both platforms must build successfully
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 调整原生配置变更
  • 根据发行说明核实有破坏性的变更

快速参考

文件描述
upgrading-react-native.md路由器：选择合适的升级路径
upgrade-helper-core.mdUpgrade Helper 核心工作流和可靠性关卡
upgrading-dependencies.md依赖兼容性检查和迁移规划
react.mdReact 和 React 19 升级对齐规则
expo-sdk-upgrade.mdExpo SDK 专属升级层（有条件时适用）
upgrade-verification.md升级后验证清单，包括由 Agent 设备协助执行的检查
monorepo-singlerepo-targeting.mdMonorepo 和单仓库应用的目标定位与命令范围设置

问题 → 技能映射

问题从此处开始
需要升级 React Nativeupgrade-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

评论

支持 Markdown