用途:为 React Native 项目从 0.79.x 迁移到 0.83.x(含两个范围内的次要与补丁版本)提供系统化指导,覆盖破坏性变更检测、代码修复、依赖更新与构建验证。
主要能力:检测 Android 原生模块中的 currentActivity、onNewIntent(Intent?)、MainApplication.kt 结构、MMKV 用法(new MMKV()、storage.delete)及依赖版本等破坏性模式;提供修复方案,包括将 currentActivity 替换为 reactApplicationContext.currentActivity、去除 Intent 的可空标记、按模板重构 MainApplication.kt(移除 reactNativeHost、reactHost 惰性初始化、以 loadReactNative(this) 替代 SoLoader.init())、将 MMKV 迁移为 createMMKV 并使用 storage.remove;给出具体依赖安装命令与版本。
使用方式:按工作流分阶段执行——迁移前分析(查看 package.json 中的 react-native 版本、扫描破坏性模式、建立清单)、运行 grep 并行检测、逐项修复、更新依赖(如 npm install react@19.2.0 react-native@0.83.0 等)、清理并重建(rm -rf node_modules package-lock.json、npm install、./gradlew clean、pod install、npx react-native start --reset-cache)、验证(构建、代码模式 grep 检查应为 0 结果、功能清单)与文档更新。要求 Node.js >= 20。
适用场景:RN 升级后出现构建错误、需要适配 Android 原生模块、迁移 MMKV、重构 MainApplication.kt 或验证迁移完整性。
限制:仅针对 0.79.x 至 0.83.x 范围;跨其他主版本需参考官方升级指南。迁移失败可用 git checkout 回滚。费率、平台支持等未提供。