Apple Privacy Rules for Capacitor Apps

苹果的隐私规则现在要求 Capacitor 让开发者专注于用户数据透明度和遵守相关规定，以确保 App Store 审核通过并维持用户信任。

关键步骤包括：

隐私宣言: 记录数据收集、API 和跟踪细节。
用户同意: 使用 App 跟踪透明度 (ATT) 进行跟踪权限。
数据访问: 清晰地定义权限，例如相机、位置和联系人等功能。
隐私政策context: Page/area: Privacy policy legal page. Role: Section or page heading. Seen in: page privacy.astro. Message key `privacy_title` (Privacy Title). | Page/area: Privacy policy legal page. Role: Short UI label or navigation item. Seen in: page privacy.astro. Message key `privacy_policy` (Privacy Policy).
: 提供一个可访问、清晰的政策，说明数据使用情况。测试 & 更新 Capgo.

这些规则强调用户控制、透明度和安全的应用更新。开发者可以遵循指南，保持合规并提供隐私意识的应用。

防止App Store拒绝：添加Apple隐私清单…

Apple隐私规则解释

Apple要求开发者优先考虑清晰度，并让用户控制他们的数据。如果您是Capacitor开发者，这意味着要对如何收集和使用数据的透明度做出承诺，既对用户，也对Apple审查员。

记录数据处理实践

详细记录您的应用程序处理数据的内部记录。确保包括:

收集的用户数据类型
收集此数据的原因
使用的第三方服务或SDK的详细信息
数据如何传输或共享

拥有这些信息的组织不仅有助于遵守相关规定，还有助于更轻松地应对审查过程中的问题。请务必在App Store隐私标签和应用程序设置中透明地反映这些实践。

隐私披露的关键元素

您的应用程序的隐私信息应清晰地说明:

系统功能和API权限所需的应用程序功能
正在收集的数据类别
正在进行的跟踪活动或与外部服务的通信
数据如何使用以及为什么

清晰的披露有助于建立用户的信任，并减少与App Store审查问题的发生概率。

遵守规定的时间表

苹果会在阶段更新其隐私要求。请定期查看苹果开发者更新，以确保您的应用程序始终符合最新规则。

将隐私规则添加到您的应用程序

了解如何在您的Capacitor应用程序中使用苹果隐私规则的逐步指南。

Setup Requirements

在开始之前，请确保以下条件:

您需要 Xcode 15 或更高版本 才能支持隐私清单。
Capacitor 8 已安装。
iOS 部署目标设置为 iOS 14.5 或更高版本.
您的应用程序包含一个正确配置的 Info.plist 文件。
您有一个 Apple Developer账户 使用有效的证书。

如果您正在使用 Capgo, 请设置端到端加密以保障数据隐私。正确配置的应用程序（使用 Capgo）在更新方面取得了全球成功率达82%。 [1].

一旦您的环境准备就绪，请继续创建和配置您的隐私清单。

隐私清单设置指南

创建隐私清单文件

在 iOS 项目的根目录中添加一个新文件： PrivacyInfo.xcprivacy 定义数据收集

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

指定您的应用程序收集的数据类型，例如：

用户分析

设备信息
使用模式
__CAPGO_KEEP_0__
网络访问

配置API访问

列出您的应用程序需要的系统 API，包括：

相机
位置
联系人
相册

遵守性指南

在设置隐私清单后，请确保您的数据收集实践符合苹果的标准。

数据最小化
仅收集必要的数据以支持您的应用程序的核心功能。Capgo用户在24小时内报告了95%的活跃用户更新率 [1],这表明隐私意识的方法可以保持用户的参与度。

用户透明度
请明确说明:

数据收集的原因
数据存储的时间
用户控制选项
数据共享政策

测试要求

在提交应用之前，测试您的应用以确保隐私符合性。重点关注这些方面：

测试区域	验证点
数据访问	检查是否有合适的权限提示
隐私标签	确认声明的准确性。
用户控制	测试放弃功能。
数据存储	验证加密是安全的。

Capgo 已成功交付 2350 万次更新，同时保持隐私合规 [1]证明了可以有效平衡更新和隐私。

按照以下指南来确保您的应用程序准备好进行测试和 App Store 提交。

用户隐私控制

本节重点介绍如何让用户控制跟踪和数据访问，建立在已建立的隐私指南之上。

设置跟踪权限

To configure App Tracking Transparency (ATT) in your Capacitor app, use @capgo/capacitor-app-tracking-transparency 并在您的 Info.plist 文件中包含以下键:

<key>NSUserTrackingUsageDescription</key>
<string>We use tracking to provide personalized features and improve app performance</string>

接下来，在您的应用程序启动时处理跟踪请求:

import { App } from '@capacitor/app';

async function requestTrackingPermission() {
  const status = await App.requestTrackingAuthorization();
  return status.authorized;
}

ATT 实现的技巧:

在用户体验的合适时机显示权限对话框。
在系统提示出现之前，清晰地解释跟踪的好处。
尊重用户的决定，并为那些选择退出的人提供替代方案。

数据访问权限

对于 iOS，您需要在应用程序的 Info.plist中定义权限。以下是常见的权限及其描述：

权限类型	Info.plist Key	使用说明
摄像头	NSCameraUsageDescription	用于拍照
位置	NSLocationWhenInUseUsageDescription	用于位置功能
照片	NSPhotoLibraryUsageDescription	访问保存/加载图片
联系人	NSContactsUsageDescription	联系人集成

何时请求权限:

只有在需要时才请求权限，并提供明确的上下文。
在提示前，简要说明每个权限的必要性。
如果用户拒绝请求，提供替代功能或选项。

在设置权限后，确保用户通过透明的隐私政策了解这些做法。

隐私政策显示

使您的应用的隐私政策易于找到并理解。

包含的内容:

数据收集的详细信息
How the data will be used
数据存储的保留期
用户对其数据的权利
联系我们

您可以像这样添加一个隐私中心到您的应用

import { Browser } from '@capacitor/browser';

async function showPrivacyPolicy() {
  await Browser.open({
    url: 'https://your-app.com/privacy-policy'
  });
}

如何显示隐私政策:

将隐私政策链接放置在应用的设置中
使用简单明了的语言来解释技术概念
添加视觉效果来提高理解
提供版本历史并通知用户更新
允许用户导出其数据

确保您的应用更新（例如通过 Capgo）符合这些隐私设置并维持用户信任

测试和App Store提交

一旦您设置了隐私清单和用户控制，下一步就是进行彻底的测试，以确保一切按照预期工作。这一过程有助于在提交应用程序到App Store之前确认遵守。

隐私测试在 Xcode

首先，在Xcode中启用隐私报告:

// Enable Privacy Report in Xcode scheme
Edit Scheme > Run > Diagnostics > Enable Privacy Report

在调试模式下运行您的应用程序并在控制台中查看隐私报告。在测试过程中，以下是您需要关注的内容:

测试区域	需要检查的内容
App跟踪	ATT对话框的时间和显示
数据访问	权限的正确实现
API 使用	隐私清单的完整性
网络请求	数据传输的安全性

此测试确保您的应用程序已准备好提交并符合合规标准。

常见的隐私错误

测试后，解决以下常见问题以避免提交延迟:

不完整 privacy-manifest.json: 确保列出了所有必需的API和跟踪域名。
缺失的目的字符串: 清楚地解释每个权限请求的原因。
不当的跟踪请求: 只在用户操作后触发跟踪权限。

App Store 私有性细节

在提交应用程序时，提供准确的关于您的隐私实践的信息。以下是需要包含的内容：

隐私类别	需要的信息	示例
数据收集	收集的数据类型	设备 ID、位置
数据使用	收集数据的原因	应用程序功能、分析
数据关联	数据如何连接到用户	账户信息、使用数据
数据跟踪	跨应用跟踪细节	广告、分析

关键App Store要求:

在提交之前更新您的隐私政策URL。
确保声明的权限与您的应用功能一致。
为任何使用的第三方SDK记录隐私实践。
确认所有网络传输都已加密以确保安全。

使用 Capgo 更新

Capgo Live Update Dashboard Interface

Capgo 提供了一个安全的实时更新系统，同时遵守苹果的隐私规则。

Capgo 的隐私功能

Capgo 的更新系统以安全性和隐私为首要考虑:

功能	隐私益处
端到端加密	确保只有授权用户才能解密更新
App Store 合规	符合苹果严格的隐私要求
安全部署	保护更新的分发
访问控制	允许详细的权限管理

这些功能保护更新并维护用户隐私。

“唯一具有真正端到端加密的解决方案，其他只是签署更新” - Capgo [1]

使用 Capgo 进行更新部署

以下是如何使用 Capgo 部署符合隐私要求的更新的步骤:

安装 Capgo 插件:

运行以下命令以开始使用:
```
npx @capgo/cli init
```
配置您的隐私设置:

更新您的隐私清单以包含 Capgo 的域名和 API
设置加密更新频道:

为不同部署阶段创建单独的频道以确保安全更新。

Capgo 确保 95% 的活跃用户在 24 小时内接收更新，全球成功率为 82% [1]. 频道系统还使更新目标管理变得简单。

用户组更新在 Capgo 中

Capgo 允许您在更新中安全地针对特定用户组：

更新类型	隐私考虑	实施
beta 测试	限制对特定用户的暴露	使用受限访问的单独频道
阶段性发布	逐步发布给用户	根据百分比发布更新

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

Capgo的详细权限确保只有授权的团队成员才能安全地访问和管理更新。

概要

关键隐私要求

苹果的隐私规则 Capacitor应用列出了以下需求:

要求	详细信息
隐私清单	包含必要的域名、API 和跟踪声明。
用户同意	使用 ATT 框架向用户请求跟踪权限。
数据访问	配置访问照片、位置和联系人的权限。
隐私政策	提供一个清晰、可访问的政策，既在应用中又在 App Store 列表中。
安全更新	确保实时更新使用加密的部署通道。

实施清单

按照以下清单来满足苹果的要求：

配置隐私清单
添加API声明，列出跟踪域名，并记录数据使用目的。
设置用户权限
实现ATT对话框，配置照片和媒体访问权限，并启用位置服务。
安全更新系统
使用符合隐私要求的更新解决方案，设置加密通道，并配置用户目标控制。

Capgo的平台提供了一种可靠的方式来满足这些隐私标准，同时保持应用程序功能和用户中心化。 [1].

继续遵循Apple隐私规则的Capacitor应用

如果您正在使用 Apple隐私规则的Capacitor应用 来规划安全性和合规性，连接它与加密为 __CAPGO_KEEP_0__ 加密实现细节做准备合规为 __CAPGO_KEEP_0__ 合规做准备 Capgo 安全扫描器为 Capgo 安全扫描器的产品工作流做准备 Capgo 安全为 Capgo 安全做准备，并且 Capgo 信任中心为 Capgo 信任中心做准备