跳到主要内容
版本：v8

隐私清单

Apple 最近在 WWDC23 上推出了新的第三方 SDK 隐私协议，要求 SDK 作者声明在其 SDK 中使用 API 的批准原因，以增强透明度和用户隐私。

从 2024 年 3 月 13 日开始，当上传新的或更新的应用而没有访问某些 API 的批准原因时，App Store Connect 将通知用户。

从 2024 年 5 月 1 日开始，您在向 App Store Connect 提交新的或更新的应用时将被要求包含批准的原因。

满足要求的步骤​

并非所有应用都会被标记，但某些插件如 @capacitor/filesystem 和 @capacitor/preferences 可能需要隐私清单文件。如果您收到通知：

  1. 将 Capacitor 更新到： a. Capacitor 7：>= 7.0.0 b. Capacitor 6：>= 6.0.0 c. Capacitor 5：>= 5.7.4 d. Capacitor 4：>= 4.8.2 e. Capacitor <= 3 不受支持
  2. 使用 VS Code 扩展为您的应用创建隐私清单文件，或手动创建它。

VS Code 扩展​

确保您已安装 Ionic VS Code 扩展并打开您的项目。

在推荐项下，如果您的应用使用了使用某些 API 的插件，您将看到 添加隐私清单。

无清单

选择"是"以创建最低限度的隐私清单文件。

然后，扩展会将所有需要的更改列为标题为 缺少隐私清单类别 的推荐。例如：

隐私更改

您必须选择其中一个原因代码来解释您如何使用该插件。如果不确定，请点击 Docs 前往 Apple 文档查看每个原因代码的说明。

请注意，VS Code 扩展有一组已知插件的规则来帮助您。如果您仍然因缺少隐私清单原因而被 Apple 拒绝，可能是您使用了扩展不知道的插件。您可以在 VS Code 扩展问题跟踪器 上开启问题。

手动步骤​

如果您希望手动执行创建隐私清单文件的步骤，请打开 Xcode，然后：

选择 File > New File。

向下滚动到 Resource 部分并选择 App Privacy File 类型。

点击 Next。

在 Targets 列表中选中您的应用。

点击 Create。

将创建一个名为 PrivacyInfo.xcprivacy 的文件。在 Xcode UI 中交互式创建此文件具有挑战性，因此通过右键单击它并选择 使用外部编辑器打开 来手动编辑它可能更容易。

作为示例文件，这里是一个通过使用 @capacitor/preferences 插件使用 UserDefaults API 的 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>NSPrivacyTracking</key>
    <false/>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
      <dict>
        <key>NSPrivacyAccessedAPIType</key>
        <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
        <key>NSPrivacyAccessedAPITypeReasons</key>
        <array>
          <string>CA92.1</string>
        </array>
      </dict>
    </array>
    <key>NSPrivacyTrackingDomains</key>
    <array/>
  </dict>
</plist>

要查找可能需要隐私清单更改的代码和插件，您可以通过运行 sh required_reason_api_text_scanner.sh node_modules 使用类似这样的脚本。

要选择正确的原因代码（如上例中的 CA92.1），您需要阅读 Apple 的文档。

Store 提交前​

在 App Store 提交之前，您可能需要披露用户跟踪、跟踪域或对您的应用唯一的其他数据类型的收集。有关更多信息，请参阅 Apple 的文档。

Contents

编辑此页