用途 该技能面向 iOS 与 Android 平台的 React Native 升级工作,假定使用 React Native 0.76+(除清单项另有说明外,默认按新架构互操作处理)。适用时机包括:升级 React Native、React 或原生工具链;开启新架构,或向已使用新架构的应用添加原生模块;因原生依赖发布而被迫升级应用。
主要能力 版本跳跃:升级前阅读目标版本的变更日志以识别破坏性变更;跨多个次版本的跳跃需拆分,使每一步都能启动,而不是一次未经审查的跃迁;自带原生代码的 JS 依赖与 React Native 升级在同一次变更中完成;合并前需在新版本上完成 iOS 与 Android 的构建与启动。
原生版本矩阵:Kotlin、iOS 部署目标与 Android min SDK 需匹配目标 React Native 版本要求;需要时对原生模块运行 Codegen,且应用仍可构建;必须同步升级的原生库(如 navigation screens、gesture handler、在 UI 线程执行动画的库)在同一次变更中一起升级。
新架构:新的原生模块使用新架构互操作;若无书面理由,不新增 bridge 模块;不支持新架构的模块需列出,并在其支持前隐藏或替换相关功能;对升级中改动过原生模块的界面,需在新架构构建上实际走查。
升级之后:冒烟测试覆盖启动、登录以及应用不可缺失的关键路径;发布构建设置仍指向正确环境;源映射或调试符号仍能上传,以便读取新版本的崩溃信息。
使用方式 资料以清单与正误示例形式给出操作规范,例如:错误做法是一次性从 0.72 升到 0.78 并把 Android 留到后续处理;正确做法是每次升一个次版本,每步都在 iOS 与 Android 上构建并启动,并在同一步中升级原生模块。合并阻断级问题定义为:应用在 iOS 或 Android 上无法启动,或原生模块版本与本次 React Native 升级不匹配;应修复项为升级的拆分方式与冒烟测试记录。
适用场景与限制 适用于 React Native 应用的版本升级与新架构迁移。反模式包括:升级期间手工编辑生成的原生工程(下次升级会覆盖修复)、用跳过安装的补丁临时锁定旧原生模块(在新架构上会崩溃),应把改动放入升级会保留的配置中,或在同一次变更中升级或替换模块。注意:仅 JS 的升级也可能因依赖的原生 pod 或 Gradle 版本变化而失败;Hermes 与 JS 引擎标志在版本间会变化,仅在 release 出现的崩溃容易在 debug 冒烟测试中被漏掉。资料未提供安装命令、价格、平台支持之外的收费信息。