Skip to content

iOS 应用的隐私清单 ​

如果您的应用旨在发布到 Apple App Store 且使用了 required reasons API, App Store Connect 可能会发出警告,提示该应用没有正确的隐私清单:

Required reasons 警告

这可能会影响任何 Apple 生态系统的应用,无论是原生应用还是多平台应用。您的应用可能通过第三方库或 SDK 使用了 required reason API,而这可能并不直观。Kotlin Multiplatform 可能是使用了您未察觉的 API 的框架之一。

在此页面中,您将找到该问题的详细描述以及解决该问题的建议。

本页面反映了 Kotlin 团队当前对该问题的理解。 随着我们获得更多关于公认方法和变通方案的数据和知识,我们将更新此页面以反映这些内容。

问题是什么 ​

Apple 对 App Store 提交的要求在 2024 年春季发生了变化。 App Store Connect 不再接受未在其隐私清单中说明使用 required reason API 原因的应用。

这是一个自动检查,而非人工审核:系统会对您的应用代码进行分析,并向您发送包含问题列表的电子邮件。邮件将引用“ITMS-91053: Missing API declaration”问题,列出应用中使用的所有属于 required reasons 类别的 API 分类。

理想情况下,您应用使用的所有 SDK 都会提供自己的隐私清单,您无需担心。 但如果您的某些依赖项没有这样做,您的 App Store 提交可能会被标记。

如何解决 ​

在您尝试提交应用并收到来自 App Store 的详细问题列表后,您可以按照 Apple 文档构建您的清单:

生成的文件是一个字典集合。对于每个访问的 API 类型,请从提供的列表中选择一个或多个使用原因。Xcode 通过提供可视化布局和包含各字段有效值的下拉菜单,协助编辑 .xcprivacy 文件。

您可以使用专用工具来查找 Kotlin 框架依赖项中 required reason API 的用法,并使用单独的插件将 .xcprivacy 文件随 Kotlin 构件一起打包。

如果新的隐私清单无法满足 App Store 的要求,或者您无法弄清楚如何执行这些步骤,请联系我们并在此 YouTrack 问题中分享您的案例。

查找 required reason API 的用法 ​

您应用中的 Kotlin 代码或其中一个依赖项可能会访问来自 platform.posix 等库的 required reason API,例如 fstat:

kotlin
import platform.posix.fstat

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

在某些情况下,可能很难确定哪些依赖项使用了 required reason API。 为了帮助您找到它们,我们构建了一个简单的工具。

要使用它,请在项目中声明 Kotlin 框架的目录中运行以下命令:

shell
/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 构件中 ​

如果您需要将 PrivacyInfo.xcprivacy 文件随 Kotlin 构件一起打包,请使用 apple-privacy-manifests 插件:

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

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

该插件会将隐私清单文件复制到相应的输出位置。

已知用法 ​

Compose Multiplatform ​

使用 Compose Multiplatform 可能会导致您的二进制文件中出现 fstat、stat 和 mach_absolute_time 的用法。 尽管这些函数不用于跟踪或指纹采集,也不会从设备发送,但 Apple 仍可能将其标记为缺少 required reason 的 API。

如果您必须为 stat 和 fstat 的用法指定原因,请使用 0A2A.1。对于 mach_absolute_time,请使用 35F9.1。

有关 Compose Multiplatform 中使用的 required reasons API 的进一步更新,请关注此问题。

1.9.10 或更早版本中的 Kotlin/Native 运行时 ​

mach_absolute_time API 被用于 Kotlin/Native 运行时的 mimalloc 分配器中。这是 Kotlin 1.9.10 及更早版本中的默认分配器。

我们建议升级到 Kotlin 1.9.20 或更高版本。如果无法升级,请更改内存分配器。 为此,请在您的 Gradle 构建脚本中为当前的 Kotlin 分配器设置 -Xallocator=custom 编译选项,或为系统分配器设置 -Xallocator=std。

有关更多信息,请参阅 Kotlin/Native 内存管理。