React Native MMKV Storage 适配 React Native 0.75.1 的 Android 构建问题解析

问题背景

React Native 0.75.1 版本中，Facebook 团队移除了 JSIModulePackage 接口，这是一个重大的架构变更。这一变动影响了多个依赖 JSI 模块的第三方库，包括 react-native-mmkv-storage。当开发者将项目升级到 React Native 0.75.1 后，在构建 Android 应用时会遇到编译错误，提示找不到 JSIModulePackage 类。

技术分析

在 React Native 0.75.1 中，JSIModulePackage 被完全移除，这是新架构演进的一部分。原本的 JSI 模块系统被 Turbo 模块所取代。Turbo 模块是 React Native 新架构的核心组件之一，它提供了更高效的 Native 模块调用机制。

react-native-mmkv-storage 库之前实现了 JSIModulePackage 接口来注册 JSI 模块。在新的架构下，我们需要将其迁移到 Turbo 模块系统。

解决方案

1. Android 端改造

主要修改集中在 Android 部分的代码：

1. 移除 RNMMKVJSIModulePackage.java 文件，因为它依赖了已被移除的 JSIModulePackage 接口
2. 将 RNMMKVPackage 改为继承自 TurboReactPackage 而不是直接实现 ReactPackage
3. 实现 TurboReactPackage 要求的 getModule 和 getReactModuleInfoProvider 方法
4. 在 build.gradle 中添加对新架构的支持判断

2. iOS 端调整

iOS 端需要移除对 RCTTurboModule.h 的引用，因为这个头文件在新版本中已经不再需要。

兼容性考虑

这个修改同时考虑了向后兼容性：

1. Turbo 模块系统在 React Native 中已经存在多个版本，因此修改后的代码可以兼容较旧的 React Native 版本
2. 通过 BuildConfig.IS_NEW_ARCHITECTURE_ENABLED 标志，可以同时支持新旧两种架构
3. 修改后的实现不会影响库的核心功能，只是改变了模块注册的方式

实施建议

对于正在使用 react-native-mmkv-storage 的开发者：

1. 如果你正在升级到 React Native 0.75.1 或更高版本，建议升级到 react-native-mmkv-storage 0.10.3 或更高版本
2. 如果你暂时无法升级库版本，可以使用 patch-package 应用上述修改
3. 对于新项目，建议直接使用最新版本的库和 React Native

总结

React Native 的架构演进是一个持续的过程，这次对 JSIModulePackage 的移除是向更现代化、更高效的架构迈进的一步。react-native-mmkv-storage 通过这次更新，不仅解决了兼容性问题，也为未来可能的架构变化做好了准备。开发者可以放心升级，享受更稳定、更高效的存储解决方案。