2024 Flutter iOS 隐私清单上线，5 月 1 号最后期限，你收到「ITMS-91053」了吗？

news2024/11/27 14:29:49

2023 年底的时候，我就发过了《Flutter 上了 Apple 第三方重大列表，2024 春季 iOS 的隐私清单究竟是什么？》相关内容，如果你还对隐私清单等相关要求不了解，建议先看看前文。

如果你已经有相关了解，并且近期也提交过 App 到 App Store ，那么你可能已经收到过类似「ITMS-91053」的相关警告邮件，这就是隐私清单里的「必要理由的 API 声明」，也是隐私清单里最大家最容易遇到的问题之一，主要包括了：

File timestamp APIs
System boot time APIs
Disk space APIs
Active keyboard APIs
User defaults APIs

邮件里也写明了，最后的要求期限是 5 月 1 号，所以正如去年说的那样，春季过去后，也是时候面对隐私清单的适配要求了。

实际上在 Flutter 进度里，官方和主流的插件基本都已经完成了隐私清单的适配要求，而目前主要出现在 Upcoming third-party SDK requirements 列表的插件，还没适配动静的应该就是 fluttertoast 了，尽管已经有了 PR #489 ，但是暂时还没有相关回应。

不过问题不大，最多自己 fork 一个 merge 下。

另外针对之前所说的，对于 “收集” 的定义目前很模糊的问题，类似 webview_flutter ，webview_flutter 本身不收集任何内容，但是App 可以用来 webview_flutter 收集浏览历史记录，然后这如何在 SDK 的隐私清单里去体现？

官方的回复是，如果SDK没有收集任何数据，那么应该提供一个隐私清单，概述没有收集任何信息，所以这也是 webview_flutter 等插件目前的适配逻辑之一。

没适配的插件，也可以考虑自己 fork 过来通过类似方式兼容。

接着我们聊「ITMS-91053」，如果你收到 ITMS-91053: Missing API declaration - Your app’s code in the “Runner” file ，首先要做的就是确定你的 Flutter SDK 是否升级到了 3.19 ，因为 Engine 的适配官方是在 3.19 做的，当然，如果你就是想做「钉子户」，那么你也可以参考下方的 issue 和 pr ，自己 fork 个 engine 去适配支持：

#48951 Add xcprivacy privacy manifest to iOS framework
#131494 Find Required Reason API usage in Flutter Engine and create Privacy Manifest

另外，并不是看到 Your app’s code in the “Runner” file 就是说明是 Engine 的隐私清单有问题，因为构建方式也可能会影响到警告的提示。

Flutter 3.19 本身已经有一个合规的隐私清单，如果你在 3.19 还能遇到 ITMS-91053: Missing API declaration - Your app’s code in the “Runner” file，官方表示可能是：

引入的插件有隐私清单 ( podspec 使用了 s.static_framework = true )，但目前你使用的是旧版本，所以需要更新插件
使用的插件没有声明隐私清单，或者隐私清单不完整

对于 1 的情况，可以将插件的依赖版本升级到最新，然后不要忘了运行一次 flutter pub upgrade ，因为很多插件最近才添加清单支持，另外运行 flutter pub upgrade 的必要性在于：

例如 shared_preferences 目前是 2.2.2，其清单文件是在其依赖的 shared_preferences_foundation 上，而 shared_preferences_foundation 在其内部依赖版本是 ^2.2.0 ，但是其实包含隐私清单的包是 2.3.5 ，所以如果你不执行 flutter pub upgrade ，那么你本地的 shared_preferences 插件所使用的 foundation 依赖可能会是旧版本。

所以就算升级完插件后，查看插件里是否包含 privacy 文件也是非常重要的一个步骤。

另外，对于项目的 Podfile 构建是否使用 use_frameworks! ，也是目前「ITMS-91053」警告的主要问题之一，为了更好区分和解决「ITMS-91053」的问题，官方建议：

一般建议使用 use_frameworks! ，或者插件的 podspec 配置 static_framework = true 为强制静态链接，正常情况下可以把出现的警告指向插件，然后沟通插件方配合解决问题，至少清楚问题在哪里。
如果因为构建等原因，无法使用 1 的方式，或者说可以不使用 1 ，那么可以直接在 App 端强制创建隐私清单，然后通过 find build/ios/iphoneos -name *.xcprivacy 在的项目中运行，对于所有 <some_plugin_name>.bundle/PrivacyInfo.xcprivacy 查看它们所做的声明，然后合并复制到上面创建的文件，然后自己补充缺少的。

因为 Flutter 目前在处理「ITMS-91053」问题上，最难就是找到警告来自哪个插件，又是因为什么原因不符合，例如一开始 permission_handler_apple 插件做了隐私清单申明，但是其实少了 NSUserDefaults ，因为它设置了 static_framework = true，所以导致 NSUserDefaults 代码位于 Runner ，一开始找问题的时候，因为它已经适配过了，大家都忽略了 permission_handler ，后来才发现，目前 flutter-permission-handler #1292 已经修复了这个问题。

最后，如果你在向官方提出相关 issue 时，例如在 #145269 下提出相关问题的时候，最好是附上下列配置，以便于快速定位问题：