React Native MMKV 应对 Apple 隐私清单要求的解决方案

背景介绍

随着苹果公司对用户隐私保护的日益重视，自2024年5月1日起，苹果要求所有提交至App Store的应用必须声明其使用的特定API类别。这一政策变化影响了众多使用NSUserDefaults等API的第三方库，包括React Native生态中广泛使用的键值存储库MMKV。

问题分析

在苹果的新隐私政策下，任何使用NSUserDefaults或相关API的库都需要在隐私清单文件中声明NSPrivacyAccessedAPICategoryUserDefaults类别。开发者在使用react-native-mmkv库时，扫描工具会在MMKV的头文件中检测到对UserDefaults和NSUserDefaults的引用，这可能导致应用提交被拒绝。

技术解决方案

MMKV核心团队已经意识到这一问题，并在最新版本中采取了根本性解决方案：

1. 移除敏感API依赖：MMKV 1.3.5版本通过代码重构，完全移除了对NSUserDefaults等敏感API的依赖，从根本上避免了隐私清单声明的需要。

2. 替代实现方案：MMKV转而使用苹果允许的其他存储机制，既满足了隐私要求，又保持了原有的高性能特性。

开发者操作指南

对于使用react-native-mmkv的开发者，应采取以下步骤确保合规：

1. 确保项目中安装的是react-native-mmkv 2.12.2或更高版本
2. 进入iOS项目目录
3. 执行pod install --repo-update命令
4. 检查Podfile.lock文件，确认MMKV版本为1.3.5或更高

未来展望

react-native-mmkv团队已经在其V3版本中完全解决了这一问题。这一变化体现了开源社区对隐私保护的积极响应，也为其他面临类似问题的库提供了参考解决方案。开发者可以放心使用最新版本的MMKV，无需担心苹果隐私政策的合规性问题。