返回

ITMS-91053 错误如何解决?- 苹果隐私 API 声明缺失问题指南

IOS

ITMS-91053 错误:隐私 API 声明缺失

简介

当你在构建 Apple 应用时,你可能会遇到恼人的 ITMS-91053 错误。这表明你的应用使用了需要使用原因的 API,而这些原因尚未在你的隐私清单文件中声明。让我们深入了解此错误并找到解决它的方法,以便顺利通过 App Store 审核。

错误背后的原因

ITMS-91053 错误是由访问需要使用原因的 API 的代码引起的。这些 API 被归类为特定类别,例如文件时间戳。为了增强用户隐私,Apple 要求所有新上传到 App Store 的应用都必须在隐私清单文件中声明这些 API,并提供已批准的使用原因。

解决 ITMS-91053 错误

要解决此错误,你需要:

1. 识别受影响的 API

首先,查看 Xcode 错误日志以找出引发错误的具体 API。这将帮助你确定需要声明使用原因的 API。

2. 创建隐私清单文件

如果你的应用尚未包含隐私清单文件,请创建此文件。它是一个 JSON 文件,你的应用如何使用用户数据和 API。

3. 添加 NSPrivacyAccessedAPITypes 数组

在隐私清单文件中,添加一个名为 NSPrivacyAccessedAPITypes 的数组。此数组包含受影响 API 的字符串值列表。

4. 提供使用原因

对于每个受影响的 API,请提供 Apple 认可的使用原因。你可以在他们的开发者文档中找到已批准原因的列表:https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api

代码示例

以下是一个包含 NSPrivacyAccessedAPITypes 数组的隐私清单文件示例:

{
  "privacyPolicyURL": "https://example.com/privacy-policy",
  "NSPrivacyAccessedAPITypes": ["NSPrivacyAccessedAPICategoryFileTimestamp"]
}

5. 上传更新后的应用

修改后,重新构建你的应用并将其上传到 App Store Connect。

其他提示

  • 遵守 Apple 的隐私指南。
  • 在进行更改之前,仔细查看 Apple 的开发者文档。
  • 如遇困难,请向 Apple 开发者支持寻求帮助。

常见问题解答

1. 什么是隐私清单文件?

隐私清单文件是一个 JSON 文件,它了你的应用如何使用用户数据和 API。

2. NSPrivacyAccessedAPITypes 数组是什么?

NSPrivacyAccessedAPITypes 数组包含了你的应用中使用了需要使用原因的 API 的字符串值列表。

3. 我在哪里可以找到已批准的使用原因?

你可以在 Apple 开发者文档中找到已批准原因的列表:https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api

4. 我需要更新所有受影响的 API 吗?

是的,你必须声明所有需要使用原因的 API 的使用原因。

5. 不遵守 Apple 隐私指南有什么后果?

不遵守 Apple 隐私指南可能会导致你的应用被拒绝或从 App Store 中移除。

通过解决 ITMS-91053 错误,你可以保护用户隐私,确保你的应用符合 Apple 的隐私要求,并顺利通过 App Store 审核。