为 Capacitor 应用创建隐私清单指南

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["Development","Mobile","Security","June 23, 2026","当前管理事学一个一个为《》__CAPGO_KEEP_0__「》学主：活动","Learn how to create a Privacy Manifest for your app to comply with App Store requirements and protect user data effectively.","Martin Donadieu","Martin Donadieu","Content Marketer","当前管理事学一个一个为《》__CAPGO_KEEP_0__「》学主：活动","Want to launch your","《》__CAPGO_KEEP_0__「》"]} {"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["Development","Mobile","Security","June 23, 2026","当前管理事学一个一个为《》Capacitor「》学主：活动","Learn how to create a Privacy Manifest for your app to comply with App Store requirements and protect user data effectively.","Martin Donadieu","Martin Donadieu","Content Marketer","当前管理事学一个一个为《》Capacitor「》学主：活动","Want to launch your","《》Capacitor「》"]} 在 App Store 上发布应用程序 App Store 无延迟? 首先创建一个隐私清单。苹果现在要求开发者包含此文档，以确保应用程序符合严格的隐私标准。以下是您需要了解的内容：

什么是隐私清单?
一个结构化的文件，概述了您的应用程序的数据收集实践、API 使用和跟踪域名。
为什么它很重要：
- 遵守 App Store 规则，避免拒绝或移除。
- 通过透明地处理用户数据来建立信任。
关键组成部分包括：
- 访问用户数据的 API（例如，位置、照片）。
- 收集的数据类型的隐私标签。
- 用于分析或广告的跟踪域名。
如何创建一个：
- 使用 JSON 定义数据收集详细信息。
- 将文件放在项目的正确目录中。 PrivacyInfo.xcprivacy 使用工具如
- Xcode 避免错误。简化过程的工具：
使用平台如
__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ @capgo/capacitor-app-tracking-transparency 处理 iOS ATT 提示和 @capgo/capacitor-firebase-analytics 记录 Firebase 数据收集以便 App Store 审核

遵循本指南，确保遵守 App Store 规则，保护用户隐私并避免应用商店延迟

隐私清单基础

隐私清单定义

隐私清单是一种结构化文件，概述了您的应用的数据处理实践。它详细说明了像 API 访问用户数据、跟踪域名、收集的数据类型以及第三方SDK集成等元素。这份文件不仅有助于建立信任，还确保了与 App Store 规则的遵守。让我们分解一下您清单中应该包含的关键组件。

主要隐私清单元素

以下是您需要在隐私清单中包含的主要元素，以便与 Apple 的要求保持一致：

必填原因 API
此部分列出了您的应用使用的隐私敏感 API，并解释了它们为什么是必要的

以下是常见API要求的表格总结:

API 类别	常见用途	所需文档
位置服务	用户导航	目的字符串和使用说明
相册	个人资料图片	访问级别和意图
联系人	地址簿同步	数据最小化声明

隐私标签
这些标签提供透明度，具体说明：
- 收集的数据类型
- 数据收集的原因
- 数据是否与用户身份相关联
- 数据用于跟踪的方式
跟踪域名
本节列出了所有参与跟踪的域名，例如用于分析、广告或第三方数据处理的域名。

“App Store compliant” - Capgo [1]

根据 Capgo，95% 的用户在 24 小时内遵守更新。通过向超过 2350 万用户传递更新 [1]保持您的隐私文档最新对于维持用户信任至关重要

为隐私清单编写 Capacitor

Capacitor 框架文档网站

设置要求

在开始编写清单之前，请确保您已安装:

Xcode 15 或更高版本
一个 Capacitor 8.0+ 项目
访问您的应用的 Info.plist 文件
对 JSON 结构的基本了解
概述您的应用的数据收集实践

创建步骤

首先创建一个 PrivacyInfo.xcprivacy 文件必须遵循特定的格式规范：

设置基本信息

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

定义数据收集细节

{
    "NSPrivacyAccessedAPITypes": [
        {
            "NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["1.1"]
        },
        {
            "NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["2.1"]
        }
    ]
}

添加跟踪域名

{
    "NSPrivacyTrackingDomains": [
        "analytics.yourdomain.com",
        "metrics.yourdomain.com"
    ]
}

避免常见错误

为了防止问题，记住以下几点：

包含所有必填字段: 即使某些字段为空，也必须存在。
使用有效的API类型: 检查API标识符与苹果官方文档的对应关系。
检查 JSON 格式: 使用 JSON 验证器检查文件语法错误。
提供完整的理由: 确保每个 API 访问都包含一个对应的理由 code。
保持信息最新: 在添加新功能时更新清单。

另外，请确保清单文件保持在 512KB 以内，以避免构建错误。定期在 Xcode 构建过程中验证文件，以早期捕捉错误。完成清单后，将其整合到您的 Capacitor 项目中，遵循文件放置指南。

将隐私清单添加到 Capacitor

文件放置指南

要将隐私清单添加到您的 Capacitor 项目中，请将文件放置在以下目录结构中： PrivacyInfo.xcprivacy 对于 __CAPGO_KEEP_0__ 插件，请使用以下结构：

your-app/
├── ios/
│   ├── App/
│   │   ├── PrivacyInfo.xcprivacy
│   │   └── Info.plist
│   └── App.xcworkspace

For Capacitor plugins, use this structure:

your-plugin/
├── ios/
│   ├── Plugin/
│   │   └── PrivacyInfo.xcprivacy
│   └── Plugin.xcodeproj

在 Xcode 构建过程中，定期验证文件以早期捕捉错误。完成清单后，将其整合到您的 __CAPGO_KEEP_0__ 项目中，遵循文件放置指南。

将文件放入正确位置后，更新您的Xcode构建设置以确保它正确集成：

打开您的项目在Xcode中。
在 TARGETS中，选择您的应用或插件目标。
转到 Build Settings 选项卡。
设置 Privacy Manifest Development Region 为 en.
Set 隐私声明包含 到 YES.

如果您的项目使用 CocoaPods,请在您的 Podfile 中添加以下代码片段以启用隐私声明:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['INCLUDE_PRIVACY_MANIFEST'] = 'YES'
    end
  end
end

完成这些更改后，请按照以下步骤进行实施检查以验证一切设置正确:

实施检查

确保隐私声明正常工作，请遵循以下步骤:

构建验证
- 确认在构建过程中没有任何与隐私相关的警告。
- 确保清单编译无误。
- 验证隐私清单已包含在构建产品中。
运行时验证
- 在调试模式下，测试正确的隐私提示和API访问行为。
App Store Connect验证
- 上传您的构建并在App Store Connect中查看隐私报告。
- 检查API声明是否完整，并检查跟踪域名格式是否正确。

如果您遇到“隐私清单验证失败”的错误，请检查您的清单以确保它符合最新的App Store要求。特别注意API类型和跟踪域名配置。

苹果隐私清单更改

测试和修复

创建符合苹果指南的隐私清单至关重要。为了保持进度，集成可靠的错误跟踪工具到您的开发过程中。这有助于将开发努力与遵守要求联系起来。

一个像 Capgo 可以帮助。它监控API访问并识别在用户受影响之前的清单问题。一旦潜在问题被标记，您可以将重点转移到彻底验证上。

在做出更新后，测试您的清单在开发环境中。使用错误跟踪的见解来指导您的审查。这种方法有助于确保您的应用程序始终与Apple的隐私标准保持一致。

Capgo 隐私工具

Capgo实时更新仪表板界面

Capgo简化了隐私清单和应用程序更新的管理，确保您的隐私标准始终保持完整而不会延迟部署。

Capgo功能

拥有超过 23.5百万已安全更新 和一个 82%的全球成功率Capgo 确保了 95% 的活跃用户在 24 小时内接收更新 [1]. 这是它提供的内容:

端到端加密 以确保更新的安全
频道系统 用于控制更新分发
错误跟踪 快速识别和解决问题
一键回滚 快速切换到之前的版本

这些工具使得将 Capgo 添加到您的工作流程变得顺畅和高效。

使用 Capgo

开始使用前, 安装 Capgo 插件使用以下命令:

npx @capgo/cli init

Capgo 与 CI/CD pipeline 完美集成，通过平台如 Capgo Actions、GitLab CI 或 Jenkins 等来自动化隐私清单验证。无论您选择云端还是自主托管的选项，Capgo 都支持 750 个生产应用，同时确保每次更新都符合隐私标准。 “我们实行敏捷开发，@GitHub 对于持续交付给我们的用户至关重要！” – Rodrigo Mantica, “__CAPGO_KEEP_0__ 是一种聪明的方式来进行热 __CAPGO_KEEP_1__ 推送 🙂” – NASA 的 OSIRIS-REx __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Capgo

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” – Rodrigo Mantica

“Capgo is a smart way to make hot code pushes 🙂” – NASA’s OSIRIS-REx

Capgo 也包含内置的分析功能，实时监控更新成功率和用户参与度。这确保了隐私更新能够覆盖整个用户群，同时保持与 Apple 指南的兼容性。

结论

关键点

当它来到管理隐私清单时，保持兼容性和强大的安全措施至关重要。以下是最重要的内容：

端到端加密: 从开始到结束都保持更新的安全性。
实时监控: 高效地跟踪更新的分布。
即时回滚功能: 作为快速修复的安全网。
自动验证: 确保您的更新符合兼容性标准。

建立可靠的更新系统有助于您跟上苹果和谷歌的隐私要求的演变。这一方法已被证明可以提高应用商店的通过率和增强用户的信心。 [1].

如何开始

您可以通过遵循以下步骤开始实施这些原则:

设置您的环境: 运行 npx @capgo/cli init 为隐私功能启用
: 为安全更新使用端到端加密。部署监控工具
: 使用分析跟踪更新。规划回滚
: 确保您可以快速恢复到早期版本如果需要。sourceLanguageCode

“Capgo 是开发人员提高生产力所必需的工具。避免 bug 修复的审查延迟是一场改变游戏规则的比赛。” - Bessie Cooper

定期更新和合适的工具是保持合规并不断改进的关键。

从Privacy Manifest for Capacitor Apps: Guide继续前进：指南

如果您正在使用 Privacy Manifest for Capacitor Apps: Guide 来规划安全性和合规性，连接它与 Encryption 来实现Encryption的细节 Compliance 来实现Compliance的细节 Capgo Security Scanner 来实现Capgo Security Scanner的产品工作流程 Capgo 安全性为产品工作流程中的 Capgo 安全性， Capgo 信任中心为产品工作流程中的 Capgo 信任中心。