Java_21 完成一半题目

文章目录

• 前言
• 开发环境
• 问题描述
• 问题分析
• • 1. 隐私清单 & SDK签名
  • • 1.1. 隐私清单 - 数据使用声明
    • 1.2. 隐私清单 - 所用API原因描述
    • 1.3. SDK签名
  • 2. 即将发布的第三方SDK要求
• 解决方案
• 最后

前言

前段时间用Flutter开发的iOS App提交了新版本，结果刚过两分钟就收到了一封问题邮件，我还以为审核被拒了，结果并没有。

粗略看了看，只是出了审核新政策，2024/05/01开始才会被拒。那还早，当时我就不慌了，继续忙其他事情，直到现在才有空研究一番这个问题。

注意：文中有很多描述没有官方中文，所以可能存在翻译不够准确的情况。

开发环境

• Xcode: 15.3
• Flutter: 3.19.4
• macOS: 14.4

问题描述

审核问题邮件内容：

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 “Runner” 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 “Runner” 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 “Runner” 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.

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: 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.

问题分析

1. 隐私清单 & SDK签名

从邮件内容看，问题很明确，缺少API声明，看了看链接指向的文档，原来是新政策要求提供隐私清单，并声明所用API的原因。

更多详情请看这个视频介绍：WWDC2023 - Get started with privacy manifests，右下角字幕可以切换为简体中文。

视频可以简单概括两点：

1. App的大部分隐私情况往往取决于第三方SDK，这就可能导致App的隐私标签不够准确，所以要求第三方SDK也提供隐私清单用于生成隐私报告，帮助App开发者更准确地创建隐私标签
2. 第三方SDK以二进制文件的形式依赖时要求签名，更多详情请看视频WWDC2023 - Verify app dependencies with digital signatures

补充：隐私标签的创建位于App Store Connect的App 隐私页面。

找了找隐私清单相关的官方文档：

• Describing data use in privacy manifests
• Describing use of required reason API

结合前面的视频，可知隐私清单主要包含数据使用声明和所用API原因描述，先逐个看看都是些什么。

1.1. 隐私清单 - 数据使用声明

官方文档中的概述：

需要填写的内容：

NSPrivacyCollectedDataType列举的部分数据类型：

NSPrivacyCollectedDataTypePurposes的可选项：

不知道你有没有感觉很熟悉，如果你上架过应用，那应该不会陌生，创建隐私标签时的选项不就是这些。打开App Store Connect的App 隐私页面，找到数据类型并编辑：

上图中的选项对应着NSPrivacyCollectedDataType列举的数据类型。再看看下面这些，分别对应着NSPrivacyCollectedDataTypeLinked、NSPrivacyCollectedDataTypeTracking、NSPrivacyCollectedDataTypePurposes：

所以给App创建隐私清单后，关于数据使用声明的填写，可以参考以前创建的隐私标签，毕竟以前创建的隐私标签基本没包含第三方SDK（如果以前有包含，填写时不需要涵盖）。下面举个简单例子，更多填写细节可以参考前面的视频介绍：

项目打包后生成的隐私报告（截取部分）：

如图，如果第三方SDK有填写，也会整合在隐私报告中，以后隐私标签的创建可以直接参考隐私报告。那如果不想填数据使用声明可以吗？目前可以。

一是官方文档中没有明确声明会拒绝未填写数据使用声明的应用；二是提交审核暂时也没有收到这方面的问题邮件。隐私清单中的数据使用声明更多是为了帮助App开发者更准确的创建隐私标签。

1.2. 隐私清单 - 所用API原因描述

官方文档中的概述：

需要填写的内容：

可选API类别及原因列表：

最后更新日期：2024/03/31

可以看到，问题邮件中提到的API在这都有列出来。按道理说照着官方文档填写就能解决当前问题了，可问题是我这是Flutter项目，业务逻辑代码编译后是放在了App.framework，Flutter项目默认的主程序文件Runner被检查出用了这些API没声明，我咋知道它用来干啥了？

首先要确定Runner可执行文件中的这些API调用怎么来的，本身Flutter项目中的iOS工程就没写几行代码，所以严重怀疑是来自静态库（.a）或静态框架（设置了s.static_framework = true的framework）。

使用Shell脚本扫描项目，果然一堆静态框架使用了这些API。大致根据实际用途，在App的隐私清单中选择填写：

第三方SDK没有隐私清单暂时先不管，重新提交审核，不再收到问题邮件！由此，暂时可以得出以下两个结论：

1. 目前审核主要针对主程序文件，督促App开发者增加隐私清单
2. 由于静态库和静态框架在项目构建时会被静态链接到主程序可执行二进制文件，所以这些库的所用API原因描述需要在App的隐私清单中填写

1.3. SDK签名

根据视频介绍，个人理解这个第三方SDK要求签名的检查应该是由Xcode完成，并不是在提交审核阶段。理由如下：

1. 第三方SDK签名校验允许SDK提供者自签名，App开发者完全可以自行对第三方SDK进行签名
2. Xcode打包时会用本机的证书对这些第三方SDK进行签名，所以提交审核的包不会存在没有签名的情况
3. 第三方SDK如果已有签名，实测Xcode打包时也会用本机的证书重签名覆盖，所以提交审核的包不会存在原有签名的情况

可以通过以下命令查看框架的签名信息：

codesign -d --verbose=4 <framework-path>

当然，以上只是当前的个人理解，以后也许会有变化。

2. 即将发布的第三方SDK要求

从WWDC2023到2024年5月，苹果给了将近一年的时间给开发者适配。时间虽然足够，可是第三方SDK众多，甚至有很多已经停止更新，那该怎么办？

从前面的问题邮件可以看出，暂时还只是督促App开发者填写隐私清单，并没有指出第三方SDK的问题。更重要的是有这个即将发布的第三方SDK要求：

注意：以上只截取了部分名单，诸多Flutter的库在列（Flutter库一般是下划线命名，iOS原生库一般是大驼峰命名）。

个人理解，对于第三方SDK，目前还是以抓典型为主，不在名单内的不符合要求不一定抓。如果你用了名单内的，别担心，大部分已经适配，更新版本即可；如果不在名单内，已经适配的也尽量更新版本；如果已经停止更新，那没办法只能自己手动适配。

解决方案

新建隐私清单文件：

不要忘了勾选Targets，不然不会打包进应用程序：

参考前面的问题分析填写缺失的所用API原因描述。如果你不清楚这些API是在哪里调用的，可以使用Shell脚本扫描项目。

最后

如果这篇文章对你有所帮助，点赞👍收藏🌟支持一下吧，谢谢～

本篇文章由@crasowas发布于CSDN。