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).
: 提供一个可访问、清晰的政策，说明数据使用。测试 & 更新s 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": []
}

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

用户分析

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

配置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	联系人集成

何时请求权限:

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

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

隐私政策显示

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

包含的内容:

数据收集的细节
数据如何被使用
存储数据的保留期
用户对其数据的权利
关于隐私问题的联系方式

联系方式

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

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

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

如何显示隐私政策
将隐私政策链接放置在应用的设置中，方便用户访问
使用简单明了的语言来解释技术概念
添加视觉效果来提高理解
提供版本历史并通知用户更新

Ensure that updates to your app (e.g., via Capgo) comply with these privacy settings and maintain user trust.

测试和App Store提交

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

隐私测试在 xcode

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

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

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

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

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

常见的隐私错误

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

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

App Store隐私细节

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

隐私类别	所需信息	示例
页面/区域：漏洞赏金计划页面。角色：部分或页面标题。见：页面bug-bounty.astro。消息键`bug_bounty_supabase_examples_title` (漏洞赏金计划 Supabase 示例标题)。	数据收集	收集的数据类型
设备ID、位置	数据使用	数据收集的原因
数据关联	数据如何连接到用户	帐户信息、使用数据
数据跟踪	跨应用跟踪细节	广告、分析

关键App Store要求:

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

使用 Capgo 更新

Capgo Live Update Dashboard Interface

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

Capgo Privacy Features

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应用的苹果隐私规则 Capacitor apps 要求

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

实施清单

遵循此清单来满足苹果的要求：

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

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

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

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