React Native 升级指南：完整工作流程、依赖更新与 Expo SDK 步骤

upgrading-react-native by callstackincubator/agent-skills

1,200 周安装量

1,100 GitHub Stars

GitHub

安装命令

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

开发开发运维

🇨🇳中文介绍

升级 React Native

概述

涵盖完整的 React Native 升级工作流程：通过 Upgrade Helper 进行模板差异对比、依赖项更新、Expo SDK 步骤以及常见陷阱。

典型升级流程

路线：通过 upgrading-react-native.md 选择正确的升级路径
差异对比：通过 upgrade-helper-core.md 使用 Upgrade Helper 获取规范的模板差异
依赖项：通过 upgrading-dependencies.md 评估并更新第三方包
React：如果升级了 React 版本，请通过 react.md 对齐 React 版本
Expo（如果适用）：通过 expo-sdk-upgrade.md 应用 Expo SDK 层
验证：通过 upgrade-verification.md 运行升级后检查

# 快速开始：检测当前版本并获取差异

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest

# 示例：从 0.76.9 升级到 0.78.2
# 1. 获取模板差异
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

文件	描述
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	手动升级后验证清单
monorepo-singlerepo-targeting.md	Monorepo 和单仓库应用定位及命令作用域

问题	从以下开始
需要升级 React Native	upgrade-helper-core.md
需要依赖项风险评估和迁移选项	upgrading-dependencies.md
需要 React/React 19 包对齐	react.md
需要先进行工作流路由	upgrading-react-native.md
需要 Expo SDK 特定步骤	expo-sdk-upgrade.md
需要手动回归验证	upgrade-verification.md
需要仓库/应用命令作用域	monorepo-singlerepo-targeting.md

🇺🇸English

Upgrading React Native

Overview

Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.

Typical Upgrade Sequence

Route : Choose the right upgrade path via upgrading-react-native.md
Diff : Fetch the canonical template diff using Upgrade Helper via upgrade-helper-core.md
Dependencies : Assess and update third-party packages via upgrading-dependencies.md
React : Align React version if upgraded via react.md
Expo (if applicable): Apply Expo SDK layer via expo-sdk-upgrade.md
Verify : Run post-upgrade checks via 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

When to Apply

Reference these guidelines when:

Moving a React Native app to a newer version
Reconciling native config changes from Upgrade Helper
Validating release notes for breaking changes

Quick Reference

File	Description
upgrading-react-native.md	Router: choose the right upgrade path
upgrade-helper-core.md	Core Upgrade Helper workflow and reliability gates
upgrading-dependencies.md	Dependency compatibility checks and migration planning
react.md	React and React 19 upgrade alignment rules
expo-sdk-upgrade.md	Expo SDK-specific upgrade layer (conditional)
upgrade-verification.md	Manual post-upgrade verification checklist

Problem → Skill Mapping

Problem	Start With
Need to upgrade React Native	upgrade-helper-core.md
Need dependency risk triage and migration options	upgrading-dependencies.md
Need React/React 19 package alignment	react.md
Need workflow routing first	upgrading-react-native.md
Need Expo SDK-specific steps	expo-sdk-upgrade.md
Need manual regression validation	upgrade-verification.md
Need repo/app command scoping

Weekly Installs

823

Repository

callstackincuba…t-skills

GitHub Stars

994

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex618

opencode599

gemini-cli594

github-copilot582

kimi-cli551

amp548