苹果审核警告：ITMS-91053: Missing API declaration

已于 2024-04-25 15:43:31 修改
阅读量1.7k 收藏 31
点赞数 15
分类专栏： OC学习小记 文章标签： xcode
于 2024-04-24 10:31:43 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lyz0925/article/details/138133567
版权
本文讲述了苹果的新规，从2024年5月1日起，开发者需在App的隐私清单文件中为使用NSPrivacyAccessedAPICategory下的各类API提供原因，包括FileTimestamp、SystemBootTime、DiskSpace、ActiveKeyboards和UserDefaults。开发者需添加PrivacyInfo文件并详细列出API声明及其使用理由。
摘要由CSDN通过智能技术生成

苹果隐私声明的记录

背景

前段时间（2024年3月24号）提交了一个版本，appstore给我发了一个提醒的邮件，邮件内容如下：

Although submission for App Store review was successful, you may want to correct the following issues in your next submission for App Store review. Once you've corrected the issues, upload a new binary to App Store Connect.

ITMS-91053: Missing API declaration - Your app’s code in the “Owner” file references one or more APIs that require reasons, including the following API categories: NSPrivacyAccessedAPICategoryFileTimestamp. While no action is required at this time, starting May 1, 2024, when you upload a new app or app update, you must include a NSPrivacyAccessedAPITypes array in your app’s privacy manifest to provide approved reasons for these APIs used by your app’s code. For more details about this policy, including a list of required reason APIs and approved reasons for usage, visit: https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api.

ITMS-91053: Missing API declaration - Your app’s code in the “Owner” file references one or more APIs that require reasons, including the following API categories: NSPrivacyAccessedAPICategoryDiskSpace. While no action is required at this time, starting May 1, 2024, when you upload a new app or app update, you must include a NSPrivacyAccessedAPITypes array in your app’s privacy manifest to provide approved reasons for these APIs used by your app’s code. For more details about this policy, including a list of required reason APIs and approved reasons for usage, visit: https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api.

ITMS-91053: Missing API declaration - Your app’s code in the “Owner” file references one or more APIs that require reasons, including the following API categories: NSPrivacyAccessedAPICategoryUserDefaults. While no action is required at this time, starting May 1, 2024, when you upload a new app or app update, you must include a NSPrivacyAccessedAPITypes array in your app’s privacy manifest to provide approved reasons for these APIs used by your app’s code. For more details about this policy, including a list of required reason APIs and approved reasons for usage, visit: https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api.

ITMS-91053: Missing API declaration - Your app’s code in the “Owner” file references one or more APIs that require reasons, including the following API categories: NSPrivacyAccessedAPICategorySystemBootTime. While no action is required at this time, starting May 1, 2024, when you upload a new app or app update, you must include a NSPrivacyAccessedAPITypes array in your app’s privacy manifest to provide approved reasons for these APIs used by your app’s code. For more details about this policy, including a list of required reason APIs and approved reasons for usage, visit: https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api.

Apple Developer Relations

大概的意思是说，缺少了一些访问敏感数据的说明。2024年5月1号之前，只会发邮件提醒，到5月1号之后，必须添加上访问敏感数据的原因，否则审核不能通过。

新规详情

从今年（2023年）秋天开始，大概是 9 月中旬左右，如果 App 上传到 App Store Connect，应用程序使用到了需要声明原因的 API（也包括引入的第三方 SDK），但是没有在隐私清单文件中添加原因，那么 Apple 会给你发送一封警告性的邮件。

从 2024 年春季开始，大概是 5 月左右，没有在隐私清单文件中说明使用原因的 App 将会被拒审核。

解决方案

在项目中，添加一个PrivacyInfo的文件，在文件中，添加上需要声明隐私的key 和 原因即可。具体如下。
在这里插入图片描述

需要声明原因的 API

1、File timestamp APIs(获取文件时间戳相关的 API)

项目中用到以下接口的都要申明：

creationDate
modificationDate
fileModificationDate
contentModificationDateKey
creationDateKey
getattrlist(::::: )
getattrlistbulk(::::: )
fgetattrlist(::::: )
stat
fstat(:: )
fstatat(:::: )
lstat(:: )
getattrlistat(:::::: )

声明的key 和 reason:

  1. 声明的key：NSPrivacyAccessedAPICategoryFileTimestamp
  2. 对应的原因类型NSPrivacyAccessedAPITypeReasons 有三种，选择其中的一种或者多种：
  • DDA9.1： 声明此原因以向使用设备的个人显示文件时间戳。
  • C617.1： 声明此原因以访问应用容器、应用组容器或应用的CloudKit容器中的文件的时间戳。
  • 3B52.1：声明此原因以访问用户明确授权访问的文件或目录的时间戳，例如使用文档选择器视图控制器。
  • 0A2A.1： 如果您的第三方 SDK 提供文件时间戳 API 的包装函数供应用程序使用，并且您仅在应用程序调用您的包装函数时访问文件时间戳 API，请声明此原因。 此原因只能由第三方 SDK 声明。 如果您的第三方 SDK 主要是为了包装所需的原因 API 而创建的，则可能不会声明此原因。

2、System boot time APIs（获取文件时间戳相关的 API）

项目中用到以下接口的都要申明：

systemUptime
mach_absolute_time()

声明的key 和 reason:

  1. 声明的key：NSPrivacyAccessedAPICategorySystemBootTime
  2. 对应的原因类型NSPrivacyAccessedAPITypeReasons ，选择其中的一种或者多种：
  • 8FFB.1： 声明此原因以访问系统启动时间，以计算应用程序内发生的事件的绝对时间戳，例如与 UIKit 或 AVFAudio 框架相关的事件
  • 3D61.1： 声明此原因以在使用设备的人选择提交的可选错误报告中包含系统启动时间信息。 系统启动时间信息必须作为报告的一部分显着地向人员显示。
  • 35F9.1： 声明此原因以访问系统启动时间，以测量发生在应用内的事件之间经过的时间或执行启用定时器的计算。

3、Disk space APIs（磁盘空间 API）

项目中用到以下接口的都要申明：

volumeAvailableCapacityKey
volumeAvailableCapacityForImportantUsageKey
volumeAvailableCapacityForOpportunisticUsageKey
volumeTotalCapacityKey
systemFreeSize
systemSize
statfs(: : )
statvfs(: : )
fstatfs( : : )
fstatvfs( : : )
getattrlist(: : : : : )
fgetattrlist(: : : : : )
getattrlistat(: : : : : : )

声明的key 和 reason:

  • 声明的key：NSPrivacyAccessedAPICategoryDiskSpace
  • 对应的原因类型NSPrivacyAccessedAPITypeReasons ，选择其中的一种或者多种：
  • 85F4.1： 声明此原因以向使用设备的个人显示磁盘空间信息。磁盘空间可以以信息单位（如字节）或时间单位（如高清视频分钟）显
  • E174.1： 声明此原因以检查是否有足够的磁盘空间来写入文件，或检查磁盘空间是否不足以使应用程序在磁盘空间不足时删除文件。应用程序必须根据磁盘空间的情况以一种用户可观察的方式进行不同的操作。
  • 7D9E.1： 声明此原因以在使用设备的人员选择提交的可选错误报告中包含磁盘空间信息。 磁盘空间信息必须作为报告的一部分突出地显示给相关人员。
  • B728.1： 如果您的应用程序是健康研究应用程序，并且您访问此 API 类别来检测并通知研究参与者磁盘空间不足影响研究数据收集，请声明此原因。

4、Active keyboard APIs（活动键盘 API）

项目中用到以下接口的都要申明：

activeInputModes

声明的key 和 reason:

  1. 声明的key：NSPrivacyAccessedAPICategoryActiveKeyboards
  2. 对应的原因类型NSPrivacyAccessedAPITypeReasons ，选择其中的一种或者多种：
  • 3EC4.1： 如果您的应用程序是自定义键盘应用程序，并且您访问此API类别以确定设备上处于活动状态的键盘，那么向用户提供系统范围的自定义键盘必须是应用程序的主要功能。
  • 54BD.1： 声明此原因以访问活动键盘信息，以向使用设备的个人呈现正确的自定义用户界面。应用程序必须具有用于输入或编辑文本的文本字段，并且必须根据活动键盘的不同行为以一种用户可观察的方式进行操作。

5、User defaults APIs（NSUserdefaults 相关 API）

项目中用到以下接口的都要申明：

UserDefaults

声明的key 和 reason:

  1. 声明的key：NSPrivacyAccessedAPICategoryUserDefaults
  2. 对应的原因类型NSPrivacyAccessedAPITypeReasons ，选择其中的一种或者多种：
  • CA92.1： 声明此原因以访问用户默认设置，以读取和写入仅对应用程序本身可访问的信息。这不允许读取其他应用程序或系统写入的信息，或写入其他应用程序可以访问的信息。
  • 1C8F.1： 声明此原因以访问用户默认值以读取和写入仅可由与应用程序本身属于同一应用程序组的成员的应用程序、应用程序扩展和应用程序剪辑访问的信息。
  • C56D.1： 如果您的第三方 SDK 围绕用户默认 API 提供包装函数供应用程序使用，并且您仅在应用程序调用您的包装函数时才访问用户默认 API，请声明此原因。 此原因只能由第三方 SDK 声明。 如果您的第三方 SDK 主要是为了包装所需的原因 API 而创建的，则可能不会声明此原因。
  • AC6B.1： 声明此原因以访问用户默认读取 com.apple.configuration.managed 密钥以检索 MDM 设置的托管应用程序配置，或设置 com.apple.feedback.managed 密钥以存储要通过 MDM 查询的反馈信息， 如 Apple 移动设备管理协议参考文档中所述。

添加隐私清单文件的步骤

打开项目后，按快捷键 Command + N 新建文件，在面板中搜索 privacy ，选择 App Pirvacy 点击下一步创建这个文件。
在这里插入图片描述

这个文件是个 plist 格式的面板，默认情况下长这样：
在这里插入图片描述

然后点击加号，创建一个 Privacy Accessed API Types 的 Key，这是一个数组，用来包含所有你 App 使用到需要申明原因的 API。在这里插入图片描述

点击加号后，会出现item0, 然后，点击 item0 后面的加号， 先选择 Privacy Accessed API Type：
在这里插入图片描述
然后再后面输入对应的key：
在这里插入图片描述

其次，再点击item0的加号，选择 Privacy Accessed API Reasons， 类型选择【Array】：
在这里插入图片描述

点击加号，添加原因，点击右边的箭头，出现原因列表，选择需要声明的原因，即可：
在这里插入图片描述

根据项目，我最后添加的样式如下(文章的顶部，附上了我添加的privacyInfo的文件，需要的可以自行下载查看)：
在这里插入图片描述

参考文档：

  1. https://zhuanlan.zhihu.com/p/649662474
  2. 官方文档：https://developer.apple.com/documentation/bundleresources/privacy_manifest_files
  3. API 列表对应的原因：https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api#4278393
一人前行
关注
  • 15
    点赞
  • 踩
  • 31
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
App Store 隐私政策
11-12
App Store 隐私政策网址 我们有可能聘请外部公司或个人代表我们提供某些产品或服务，包括但不限于，提供运营、维护、IT平台和/或技术服务、数据安全或备份服务、处理订单、递送货物、发送信函或电子邮件、清除用户名单中的重复信息、分析数据、提供市场营销帮助、提供搜索结果和链接（包括付费搜索名单和链接）、处理收/付款事项以及提供用户服务。在该等情况下，我们可能会共享用户信息
App Store 提交隐私-配置隐私清单文件
03-20 7764
对于应用或第三方 SDK 使用的每个必需原因 API 类别，请向应用或第三方 SDK 的隐私清单文件中的数组添加一个字典，以报告应用使用 API 类别的原因。如果系统提供来自全局域的信息，因为当您的 App 尝试读取 App、App 扩展程序或 App 组中的 App 组中的 App 或轻 App 写入的信息时，您请求的域中不存在密钥，则您的 App 概不负责。您的应用或第三方 SDK 必须声明一个或多个已批准的原因，以准确反映您对这些 API 的使用情况以及从这些 API 的使用中获得的数据。
ITMS-91053: Missing API declaration问题解决（2024.4.8）
baidu_40537062的博客
04-09 1702
2024-03-18,发布后收到苹果的邮件警告 - 简书 ITMS-91053: Missing API declaration问题解决 - 简书
2024 Flutter iOS 隐私清单上线，5 月 1 号最后期限，你收到 「ITMS-91053」 了吗？
恋猫de小郭的博客
03-25 5881
那么 ，5 月 1 号马上就要来了，你是继续做钉子户，还是升级到 Flutter 3.19？实际上在 Flutter 进度里，官方和主流的插件基本都已经完成了隐私清单的适配要求，而目前主要出现在。官方的回复是，如果SDK没有收集任何数据，那么应该提供一个隐私清单，概述没有收集任何信息，所以这也是。列表的插件，还没适配动静的应该就是 fluttertoast 了，尽管已经有了。另外针对之前所说的，对于 “收集” 的定义目前很模糊的问题，类似。，一开始找问题的时候，因为它已经适配过了，大家都忽略了。
​​​​​​​iOS配置隐私清单文件App Privacy Configuration
u013712343的博客
04-15 2043
​​​​​​​iOS配置隐私清单文件App Privacy Configuration
Xcode的SDK12.1版本解决报错ERROR ITMS-90725
12-13
低版本的Xcode打包ipa上传AppStore报错ERROR ITMS-90725，显示报内容 通过以下路径去找sdk：Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs 解压替换
iTMS-Mobile:使用 jquery mobile 和淘汰赛 js 构建的应用程序
07-05
【标题】：“iTMS-Mobile:使用 jquery mobile 和淘汰赛 js 构建的应用程序” 这个标题表明我们正在讨论一个名为iTMS-Mobile的移动应用程序，它基于jQuery Mobile和Tournament JS这两个JavaScript库进行构建。jQuery...
ITMS-90809: Deprecated API Usage – New apps that use UIWebView are no longer accepted. Instead, use
01-03
iTunesConnect吃包 因为ipa包中包含uiwebview 5月1号以后iTunesConnect不允许上传的ipa包中屌用UIWebView，使用过后上传的ipa包都不会显示在活动里（我称呼这种骚操作为‘吃包’）。 已经把项目工程里面的有关...
itms-services-LutubeWap_uhgfyin69005.mobileconfig
06-27
itms-services-LutubeWap_uhgfyin69005.mobileconfig
iOS配置隐私清单文件App Privacy Configuration
CjfBlog的博客
04-11 1753
iOS推送到TestFlight后邮件收到隐私清单警告，主要关于新的隐私政策需要补充
IOS使用NSUserDefaults保存帐号密码
Crazy Android
09-13 1823
保存部分： NSLog(@"账户与密码正确"); //获取userDefault单例 NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults]; //登陆成功后把用户名和密码存储到UserDefault [userDef
ITMS常见问题汇总以及解决方案
长兴的博客
08-14 2438
ITMS-90649 “缺少应用程序图标。捆绑包不包含iMessage应用程序图标。iMessage应用程序图标必须为 134 x 110 像素，格式为.png。” ITMS-90642 “缺少信息列表钥匙。你的应用程序信息列表在“XXXXXXXXX”中/xxxxx.appex“”必须包含“MSMessageExtensionsStoreIconName”键。如果“消息扩展”资产目录中没有“消息应用程序商店”图标，则可能会缺少该图标。“ ITMS-90078 缺少推送通知权限...
iOS 审核 5月1日开始 Privacy manifest files 【隐私清单】
lyh1083908486的博客
04-05 7865
按照上面的步骤处理后，我上传appStore 提审，现在没有收到苹果关于隐私清单的提醒邮件了，暂时就先这样配置，不知道大家是怎么填写 Privacy Tracking Enabled 和 Privacy Tracking Domains 这两个类型的呢？
ITMS-91053 Missing API declaration 解决方法
最新发布
st646889325的博客
04-26 1201
解决iTunes Connect上传应用时遇到的ITMS-91053警告——缺失API声明的方法。指出警告是由于应用使用了涉及用户隐私的API未提供说明，解决方式是添加文件到项目中，然后在文件中指定及其使用原因，确保隐私选项与实际用途相对应。基本上就是因为缺少隐私描述，但是我根本就没用第三方SDK啊,仔细一看发现是:NSPrivacyAccessedAPICategoryUserDefaults //用于存储用户的配置。
HBuilder代码提示缺失
YW博客
05-20 5243
刚刚代码提示缺失，比如获取元素的方法只有一个：getbyid,没有其他 解决：更新 更新后发现，以前的文件夹全不见了，心里一万匹草泥马。 解决：打开目录，重新导入 ps:你要相信开发软件的人不会比你蠢 ...
【转】iOS10项目打包上传被拒关于隐私权限问题
weixin_34198762的博客
11-16 150
原文网址：http://blog.csdn.net/yidu_blog/article/details/53064987 今天项目打包提交。收到了苹果的邮件。主要内容： This app attempts to access privacy-sensitive data without a usage description. The app's Info.plist must contain a...
iOS - 超好用的隐私清单分析脚本（持续更新）
crasowas的博客
04-12 3410
ITMS-91053: Missing API declaration - Your app’s code in the “Runner” file references one or more APIs that require reasons, including the following API categories: NSPrivacyAccessedAPICategoryDiskSpace.
itms-apps://
12-23
itms-apps://是一种URL协议，用于在iOS设备上打开App Store或App Store中特定应用程序的链接。当用户点击itms-apps://链接时，设备会自动跳转到App Store应用中，以便用户可以查看或下载特定的应用程序。这种URL协议...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值