React Native Code Push 隐私清单适配指南

随着苹果对应用隐私要求的日益严格，从2024年5月1日起，所有提交到App Store的新应用或更新都必须声明其使用的"Required Reason APIs"。本文针对React Native Code Push项目中涉及的隐私清单适配问题进行了深入分析，并提供了完整的解决方案。

问题背景

React Native Code Push作为热更新解决方案，在iOS平台上使用了多个需要声明隐私用途的API，主要包括：

1. NSFileModificationDate - 用于获取文件修改日期
2. NSFileCreationDate - 用于获取文件创建日期
3. NSUserDefaults - 用于存储用户偏好设置

这些API属于苹果定义的"Required Reason APIs"，开发者必须通过PrivacyInfo.xcprivacy文件明确声明其使用目的。

技术分析

问题的核心在于项目依赖的SSZipArchive库版本较旧(2.2.2)，而该库在2.5.5版本中已经添加了合规的隐私清单文件。此外，React Native Code Push本身也需要声明NSUserDefaults的使用目的。

解决方案

方案一：升级SSZipArchive依赖

通过修改CodePush.podspec文件，将SSZipArchive依赖版本升级到2.5.5：

1. 更新iOS最低部署目标至15.5
2. 修改SSZipArchive版本约束

具体修改内容如下：

Pod::Spec.new do |s|
  s.ios.deployment_target = '15.5'
  s.dependency 'SSZipArchive', '~> 2.5.5'
end

方案二：手动添加隐私清单

如果无法立即升级依赖，可以临时手动添加PrivacyInfo.xcprivacy文件，内容应包含：

NSPrivacyAccessedAPITypes = (
    {
        NSPrivacyAccessedAPIType = "NSPrivacyAccessedAPICategoryFileTimestamp";
        NSPrivacyAccessedAPITypeReasons = (
            "C617.1"  // 声明获取文件时间戳的必要原因
        );
    },
    {
        NSPrivacyAccessedAPIType = "NSPrivacyAccessedAPICategoryUserDefaults";
        NSPrivacyAccessedAPITypeReasons = (
            "CA92.1"  // 声明使用用户偏好的必要原因
        );
    }
)

实施建议

1. 对于新项目，建议直接采用方案一，升级到最新依赖
2. 对于已有项目，如果存在兼容性问题，可先采用方案二作为过渡
3. 使用patch-package工具可以确保修改在团队协作和CI/CD环境中保持一致

后续更新

微软已在AppCenter SDK ReactNative v9.0.0版本中正式修复了此问题，建议开发者尽快升级以获得官方支持。

通过以上措施，开发者可以确保应用符合苹果最新的隐私要求，顺利通过App Store审核流程。隐私合规不仅是满足平台要求，更是对用户数据保护的承诺，值得每位开发者重视。