Xcode隐私协议适配

1. Privacy manifest files

1.1 简介

自己App或三方SDK（通过XCFrameworks|Swift packages|Xcode projects集成的）需要包含一个隐私清单文件（privacy manifest）叫作 PrivacyInfo.xcprivacy。它是一个属性列表，记录了App或三方SDK收集数据的类型以及使用收集数据Api的原因，放置在bundle文件里。帮助开发者了解三方SDK中使用的Api以及数据收集的一些信息。

重要：

如果集成的三方SDK在下面的列表中，则需要三方SDK里面包含这样的隐私清单 Upcoming third-party SDK requirements.
如果集成的三方SDK没有在上面的列表中，但是它使用了需要说明使用原因的Api，最好也包含下

1.2 Create a privacy manifest

File > New File->App Privacy，然后选择target，这里的target可以是三方SDK，也可以是自身App的，如果更新三方SDK成本太大，或者最新版本的也没有提供隐私清单，可以通过这个方法，手动给三方SDK添加。每个三方SDK都是单独的，都需要单独添加

默认名字 PrivacyInfo.xcprivacy，不建议更改

在PrivacyInfo.xcprivacy字典里，添加下列的键：

NSPrivacyTracking
- bool值，表示App或者三方SDK是否使用了App Tracking Transparency framework下的数据 User Privacy and Data Use.
NSPrivacyTrackingDomains
- string数组，表示App或者三方SDK在tracking时，链接的域名，如果用户没有统一跟踪的权限，请求这些域名就会失败，并收到一个error，如果NSPrivacyTracking=true，则至少需要设置一个NSPrivacyTrackingDomains
NSPrivacyCollectedDataTypes
- 一个字典数组，表示App或者三方SDK收集的数据类型Describing data use in privacy manifests.
NSPrivacyAccessedAPITypes
- 一个字典数据，表示App或者三方SDK，访问了哪些需要说明访问原因的api Describing use of required reason API.
- 只需要在iOS, iPadOS, tvOS, visionOS, watchOS上为App或者三方SDK上提供这个

1.3 Describing data use in privacy manifests

链接：Describing data use in privacy manifests | Apple Developer Documentation

需要注意的点：

data type不能自定义key-value，只能使用列表中列出来的

1.4 Describing use of required reason API

大体上包括以下几类：

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

1.5 需要包含隐私清单和签名的三方SDK

Abseil
AFNetworking
Alamofire
AppAuth
BoringSSL / openssl_grpc
Capacitor
Charts
connectivity_plus
Cordova
device_info_plus
DKImagePickerController
DKPhotoGallery
FBAEMKit
FBLPromises
FBSDKCoreKit
FBSDKCoreKit_Basics
FBSDKLoginKit
FBSDKShareKit
file_picker
FirebaseABTesting
FirebaseAuth
FirebaseCore
FirebaseCoreDiagnostics
FirebaseCoreExtension
FirebaseCoreInternal
FirebaseCrashlytics
FirebaseDynamicLinks
FirebaseFirestore
FirebaseInstallations
FirebaseMessaging
FirebaseRemoteConfig
Flutter
flutter_inappwebview
flutter_local_notifications
fluttertoast
FMDB
geolocator_apple
GoogleDataTransport
GoogleSignIn
GoogleToolboxForMac
GoogleUtilities
grpcpp
GTMAppAuth
GTMSessionFetcher
hermes
image_picker_ios
IQKeyboardManager
IQKeyboardManagerSwift
Kingfisher
leveldb
Lottie
MBProgressHUD
nanopb
OneSignal
OneSignalCore
OneSignalExtension
OneSignalOutcomes
OpenSSL
OrderedSet
package_info
package_info_plus
path_provider
path_provider_ios
Promises
Protobuf
Reachability
RealmSwift
RxCocoa
RxRelay
RxSwift
SDWebImage
share_plus
shared_preferences_ios
SnapKit
sqflite
Starscream
SVProgressHUD
SwiftyGif
SwiftyJSON
Toast
UnityFramework
url_launcher
url_launcher_ios
video_player_avfoundation
wakelock
webview_flutter_wkwebview

签名：

或者更准确地说，代码签名（Code Signing），是一种用于确认应用或软件包来源的安全技术，同时确保自签名之后代码未被篡改。代码签名通过使用数字证书和加密技术来实现。这个过程为软件或应用附加了一个数字签名，当用户下载或运行软件时，操作系统或其他软件可以验证这个签名，以确认软件的真实性和完整性。

1.6 总结

三方SDK在上面的列表中，分为两种情况：
- 以二进制集成（framework），需要包含签名和隐私清单，从目前来看，三方SDK都更新了
- 以源码集成，只需要包含隐私清单，如果三方SDK最新版SDK里面包含了，拿过来用即可，更不更新SDK都行，如果三方SDK最新版也没有包含，可以不用管
三方SDK不在上面的列表中：
- 签名和隐私文件有没有都行，最好有
自己的App里面，只需要包含本身App里用到的隐私Api说明