upgrading-react-native

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Upgrading React Native

升级 React Native

Overview

概述

Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.
涵盖完整的React Native升级工作流:通过Upgrade Helper对比模板差异、依赖项更新、Expo SDK升级步骤及常见陷阱。

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
在以下场景中可参考本指南:
  • 将React Native应用升级至新版本时
  • 协调Upgrade Helper给出的原生配置变更时
  • 验证发行说明中的破坏性变更时

Quick Reference

快速参考

FileDescription
[upgrading-react-native.md][upgrading-react-native]Router: choose the right upgrade path
[upgrade-helper-core.md][upgrade-helper-core]Core Upgrade Helper workflow and reliability gates
[upgrading-dependencies.md][upgrading-dependencies]Dependency compatibility checks and migration planning
[react.md][react]React and React 19 upgrade alignment rules
[expo-sdk-upgrade.md][expo-sdk-upgrade]Expo SDK-specific upgrade layer (conditional)
[upgrade-verification.md][upgrade-verification]Manual post-upgrade verification checklist
[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]Monorepo and single-repo app targeting and command scoping
文件描述
[upgrading-react-native.md][upgrading-react-native]路由:选择合适的升级路径
[upgrade-helper-core.md][upgrade-helper-core]核心Upgrade Helper工作流及可靠性校验
[upgrading-dependencies.md][upgrading-dependencies]依赖项兼容性检查及迁移规划
[react.md][react]React及React 19升级对齐规则
[expo-sdk-upgrade.md][expo-sdk-upgrade]Expo SDK专属升级流程(可选)
[upgrade-verification.md][upgrade-verification]升级后手动验证清单
[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]单仓/多仓应用的目标定位及命令范围限定

Problem → Skill Mapping

问题→方案映射

ProblemStart With
Need to upgrade React Nativeupgrade-helper-core.md
Need dependency risk triage and migration optionsupgrading-dependencies.md
Need React/React 19 package alignmentreact.md
Need workflow routing firstupgrading-react-native.md
Need Expo SDK-specific stepsexpo-sdk-upgrade.md
Need manual regression validationupgrade-verification.md
Need repo/app command scopingmonorepo-singlerepo-targeting.md
问题起始参考文档
需要升级React Nativeupgrade-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