3. 项目配置

3.1 AdMob App ID

如果你启用的广告平台包含 AdMob/GAM，请将你自己的 AdMob App ID 添加到 Info.plist 中（此 ID 专属于你的应用，无法打包在 xcframeworks 中）：

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

3.2 SKAdNetworkItems

AKS 背后的广告聚合/归因平台（AppLovin、IronSource 及其下游竞价合作伙伴）需要通过 SKAdNetworkIdentifier 条目，在 ATT 框架下正确进行安装归因。参考应用包含约 48 个条目，覆盖 AppLovin、IronSource、Meta 等广告聚合合作伙伴。请从广告平台的管理后台获取最新列表（AppLovin、IronSource 和 AdMob 均有提供），不要直接复制旧列表，因为这些平台会不断新增 ID。

3.3 App Tracking Transparency（ATT）——需自行补充接入

**注意：**参考集成中既没有配置 NSUserTrackingUsageDescription，也没有调用 ATTrackingManager.requestTrackingAuthorization()。在 iOS 上，AKS 不会代你弹出 ATT 授权请求。如果你希望 AdMob/AppLovin/IronSource 广告聚合及 AppsFlyer/Adjust 归因能够使用 IDFA，就需要自行添加以下两项：

<key>NSUserTrackingUsageDescription</key>
<string>Your data will be used to deliver personalized ads.</string>

import AppTrackingTransparency

ATTrackingManager.requestTrackingAuthorization { status in
    // call this before initializing ads — see §4.4
}

如果缺少用途说明字符串，调用 requestTrackingAuthorization 会导致运行时崩溃。因此，不要在未添加 Info.plist 配置键的情况下调用此方法，也不要以为集成 SDK 后就已经自动完成了这两项配置。

3.4 GoogleService-Info.plist

按常规方式将 Firebase 的 GoogleService-Info.plist 添加到应用 target 中（拖入源代码文件夹，并确保勾选对应的 Target Membership）。此处没有 AKS 专用配置，直接按照 Firebase 的标准配置流程操作即可。

3.5 最低部署版本

AppsKit.xcframework/AKSKit.xcframework 使用 Swift 5.9（Xcode 15.2+）构建，最低支持 iOS 15.0，并设置了 BUILD_LIBRARY_FOR_DISTRIBUTION: YES 以确保模块稳定性。请将应用 target 的 IPHONEOS_DEPLOYMENT_TARGET 设置为 15.0 或更高版本。另请注意，Podfile 中的 post_install（§1.2）也会将所有 pod target 的最低部署版本强制设为 15.0，因此即使将应用级别的最低部署版本设得更低，也无法正常链接这些 pod。