Realm-JS iOS隐私清单缺失问题分析与解决方案

问题背景

在iOS应用开发中，苹果公司近期加强了对隐私API使用的管控。开发者需要在应用中明确声明对特定API的使用情况。Realm-JS作为流行的本地数据库解决方案，其iOS版本被发现使用了部分需要声明的隐私相关API，但缺少必要的隐私清单文件(PrivacyInfo.xcprivacy)。

技术细节分析

通过苹果提供的二进制扫描工具分析，发现Realm-JS库中使用了以下需要声明的API：

1. 文件时间戳相关API：

   • fstat
   • stat

2. 磁盘空间相关API：

   • statvfs

这些API分别属于苹果定义的以下隐私类别：

• NSPrivacyAccessedAPICategoryFileTimestamp
• NSPrivacyAccessedAPICategoryDiskSpace

解决方案实现

Realm团队经过多次尝试后，最终确定了以下解决方案：

1. 在Podspec文件中添加资源包声明：

s.resource_bundles = { 'realm_js_privacy' => ['PrivacyInfo.xcprivacy'] }

2. 创建PrivacyInfo.xcprivacy文件，内容包含：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSPrivacyTrackingDomains</key>
    <array/>
    <key>NSPrivacyCollectedDataTypes</key>
    <array/>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <dict>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>C617.1</string>
            </array>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
        </dict>
    </array>
    <key>NSPrivacyTracking</key>
    <false/>
</dict>
</plist>

版本更新与验证

Realm团队在12.8.1-alpha.0版本中加入了上述解决方案。开发者可以通过以下步骤验证：

1. 安装测试版本：

npm install realm@12.8.1-alpha.0

2. 使用苹果提供的二进制扫描工具验证是否还存在API声明缺失问题

注意事项

1. 对于使用较老版本(如v11)的开发者，需要注意移除podspec中的'VERSIONING_SYSTEM' => 'apple-generic'配置，否则可能导致资源包中包含不必要的二进制文件。

2. 虽然Realm-JS不在苹果明确要求的第三方SDK列表中，但使用了需要声明的API的应用仍需要提供相应的隐私声明。

总结

随着苹果对隐私保护要求的提高，开发者需要更加关注依赖库中的隐私API使用情况。Realm-JS团队通过添加隐私清单文件解决了这一问题，为开发者提供了合规的解决方案。建议使用Realm-JS的开发者尽快升级到包含隐私清单的版本，以确保应用能够顺利通过App Store审核。