用途:指导使用 React Native 0.76 至 0.82+ 与 Expo SDK 52+ 构建应用,重点处理新架构(New Architecture)强制启用、React 19 破坏性变更及版本迁移。依赖 Node.js 18+ 与 Expo CLI,最新版本为 react-native@0.82、expo@~52.0.0、react@19.1。
主要能力:覆盖新架构在 0.82+ 不可禁用、Hermes 成为唯一 JS 引擎、propTypes 移除、forwardRef 弃用、Swift iOS 模板、Metro 日志转发移除、Chrome 调试器移除、JSC 迁出核心、深层导入弃用等变更;介绍 display: contents、boxSizing、mixBlendMode、outline 等新 CSS 属性,Android XML Drawables,以及 useActionState、useOptimistic、use 等 React 19 新 Hook。
使用方式:用 npx create-expo-app@latest my-app 创建项目,npx expo install react-native@latest expo@latest 安装依赖,npx expo config --type introspect | grep newArchEnabled 验证新架构,npx expo start 启动开发服务器,按 j 打开 React Native DevTools。迁移时先升级到 0.76-0.81 使用互操作层,再升级到 0.82+,并用 npx @codemod/react-19 upgrade 处理 propTypes。
适用场景:新项目搭建、旧版本升级、新架构适配、React 19 迁移及调试工具切换。
限制:0.82+ 无法禁用新架构;DevTools 暂不支持第三方扩展,网络检查器计划在 0.83 提供;JSC 已从 Expo Go 移除;CodePush、i18n-js 等与新架构存在兼容问题,建议改用 Redux Toolkit 与 react-i18next。