适配苹果隐私新规:如何获取/创建Cordova的Privacy Manifest文件?
Cordova适配苹果隐私清单(Privacy Manifest)操作指南及官方说明
一、分步操作指南
1. 升级Cordova iOS平台(推荐)
- 优先升级到Cordova iOS 7.1.0及以上版本,该版本已内置隐私清单支持,可自动生成基础模板文件
- 升级命令:
cordova platform update ios@latest
2. 获取/创建Privacy Manifest文件
- 若使用Cordova iOS 7.1.0+,执行
cordova prepare ios后,platforms/ios/[你的应用名称]/目录下会自动生成PrivacyInfo.xcprivacy模板 - 若未自动生成或使用旧版本,手动在上述目录创建
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>NSPrivacyAccessedAPITypes</key> <array> <!-- Cordova核心功能涉及的API示例 --> <dict> <key>NSPrivacyAccessedAPIType</key> <string>NSPrivacyAccessedAPICategoryFileTimestamp</string> <key>NSPrivacyAccessedAPITypeReasons</key> <array> <string>C617.1</string> </array> </dict> </array> <key>NSPrivacyCollectedDataTypes</key> <array> <!-- 应用收集数据时添加对应声明,无收集则留空 --> </array> </dict> </plist>
3. 完善隐私清单内容
- 根据Cordova核心功能及你使用的第三方插件实际访问的API,补充
NSPrivacyAccessedAPITypes数组条目,每个条目需包含API类型和合规理由代码(理由代码参考苹果官方的隐私API理由列表) - 若应用收集用户数据(如位置、设备信息等),需在
NSPrivacyCollectedDataTypes中声明数据类型、收集用途、是否关联用户身份等信息
4. 处理二进制依赖签名(若有)
- 若项目使用二进制形式的Cordova插件/依赖,需确保这些二进制文件带有苹果认可的代码签名
- 打开Xcode项目,在
Build Settings中检查Code Signing Identity和Provisioning Profile配置,确保签名身份与应用开发者账号匹配
5. 验证与提交
- 使用Xcode打开
platforms/ios下的.xcodeproj或.xcworkspace文件,执行Product > Archive打包 - Xcode会自动检查隐私清单的合规性,若有错误,根据提示修正后重新打包提交至App Store Connect
二、Cordova官方处理文档说明
Apache Cordova团队已针对苹果隐私清单要求更新了iOS平台的官方文档,核心内容包括:
- Cordova iOS 7.1.0及以上版本默认支持自动生成隐私清单模板
- 明确列出了Cordova核心功能涉及的隐私API及对应合规理由代码
- 提供了插件开发者适配隐私清单的规范和示例
- 针对旧版本Cordova iOS的兼容方案(手动创建隐私清单的步骤)
内容的提问来源于stack exchange,提问作者user15710951
相关产品推荐
相关产品推荐

