iOS App 的隐私清单(Privacy Manifest)

有什么问题

Apple 对于 App Store 提交的要求 在 2024 年春季发生了变化. 如果 App 使用了那些需要声明使用原因的 API, 但没有在隐私清单中说明原因, 那么 App Store Connect 不会接受这样的 App.

这是一种自动检查, 不是手动审核: 你的 App 的代码会被分析, 然后你会通过 EMmail 收到一份问题列表. 这封 EMail 会提到 "ITMS-91053: Missing API declaration" 问题, 列出 App 使用的, 被分类为 需要声明使用原因 类别的所有 API.

理想情况下, 你的 app 使用的所有 SDK 都会提供他们自己的隐私清单, 而且你不需要担心这一点. 但是如果你的某些依赖项没有提供隐私清单, 你的 App Store 提交可能会被标记为不正确.

如何解决这个问题

在你尝试提交你的 App, 并从 App Store 收到详细的问题列表之后, 你可以遵照 Apple 文档构建你的清单:

• 隐私清单文件概述

• 在隐私清单中描述对数据的使用

• 描述对需要声明使用原因的 API 的使用

构建完成的清单文件是一组字典. 对每个使用的 API 类型, 要从给定的列表中选择一个或多个原因使用它的原因. Xcode 会提供一个可视化的布局, 并为对每个栏目提供包含有效值的下拉列表, 帮助你编辑 .xcprivacy 文件.

你可以使用一个 专门的工具, 在你的 Kotlin Framework 的依赖项中查找使用了哪些需要声明使用原因的 API, 还可以使用一个 单独的 plugin 来将 .xcprivacy 文件和你的 Kotlin 的 artifact 捆绑在一起.

如果一个新的隐私清单不能满足 App Store 的要求, 或者你不知道如何完成这些步骤, 请联系我们, 并在 这个 YouTrack issue 中分享你的案例.

查找使用了哪些需要声明使用原因的 API

你的 App 中的 Kotlin 代码, 或某个依赖项中的代码, 可能会访问来自库(比如 platform.posix )的需要声明使用原因的 API, 例如, fstat:

import platform.posix.fstat

fun useRequiredReasonAPI() {
    fstat(...)
}

某些情况下, 可能很难确定是哪个依赖项使用了需要声明使用原因的 API. 为了帮助你找到它, 我们创建了一个简单的工具.

要使用这个工具, 请在你的项目中 Kotlin Framework 声明目录中, 运行以下命令:

/usr/bin/python3 -c "$(curl -fsSL https://github.com/JetBrains/kotlin/raw/rrf_v0.0.1/libraries/tools/required-reason-finder/required_reason_finder.py)"

你也可以单独 下载这个脚本, 查看脚本内容, 然后使用 python3 运行它.

将 .xcprivacy 文件放入你的 Kotlin artifact 中

如果你需要将 PrivacyInfo.xcprivacy 文件和你的 Kotlin artifact 捆绑在一起, 请使用 apple-privacy-manifests plugin:

plugins {
    kotlin("multiplatform")
    kotlin("apple-privacy-manifests") version "1.0.0"
}

kotlin {
    privacyManifest {
        embed(
            privacyManifest = layout.projectDirectory.file("PrivacyInfo.xcprivacy").asFile,
        )
    }
}

plugin 会将隐私清单文件复制到 对应的输出位置.

已知使用的 API