将 Audience Network SDK 添加到您的 iOS 应用
立即为 iOS 14.5 变更采取行动
如要针对 iOS 14.5 用户实现变现，所有发行商均须使用 Audience Network SDK 6.2.1 或更高版本。（对于 iOS 14 用户，我们也推荐使用 Audience Network SDK 6.2.1。）此版本包含 2 项要求：
- 实施 setAdvertiserTrackingEnabled 标记（无论是否使用中介），以便通知我们是否使用数据来投放个性化广告。
- 将建议的 SKAdNetwork 编号添加到 Xcode 项目的 Info.plist 中，以便广告主可以衡量广告系列成效。
详情请参阅我们的 Meta 开发者帖子
在为应用做好变现准备工作之前，请先将 SDK 升级到最新版本。
本指南介绍如何将 Audience Network SDK 添加到您的 iOS 应用，以便您调用 Audience Network API。执行这一操作的首选方法是使用 CocoaPods 来管理依赖项，但我们也提供了下载该 SDK 的位置，方便您手动实施集成。
CocoaPods（首选下载方法）
将以下代码行添加到项目的 Podfile 中。
pod 'FBAudienceNetwork'
运行以下命令。
pod install
手动下载
如果无法使用 CocoaPods，您可以从下表中的任一位置下载 Audience Network SDK。
| Package | Date | Change Log |
|---|---|---|
Oct 15, 2024 | ||
Aug 15, 2024 |
下载 Audience Network SDK 后，请按照以下步骤完成集成：
- 在 XCode 中打开项目。
-
将 FBAudienceNetwork.xcframework（位于下载的 iOS 版 Audience Network SDK 私密文件夹中的 Dynamic 文件夹）拖放到 XCode。
-
在应用程序目标设置中的 General（常规）选项卡下，为 FBAudienceNetwork.xcframework 选择 Embed & Sign（嵌入并签名）
备注
- 您也可使用下载包中提供的 Audience Network SDK 静态版本。如要执行此操作，请拖放 Static 文件夹中的 FBAudienceNetwork.xcframework
- 如要使用静态版本，请确保您的项目使用的是 Swift。如果项目未使用 Swift，请将一个空的 Swift 文件添加到项目中（在 XCode 中依次选择File（文件）-> New（新建）-> Swift）
- 如果您的项目是面向 12.4 之前的 iOS 版本，请确保在 XCode 中执行如下操作：在应用程序目标的 Build settings（构建设置）下，将 Always embed Swift standard libraries（始终嵌入 Swift 标准库）设置设为 YES（是）。
- 如要避免在手动安装后再作任何额外微调，请使用 CocoaPods。
有关 SDK 6.9.0 及更高版本的疑难解答
自 6.9.0 版起，iOS 版 Audience Network SDK 已支持 Swift。为解决最常见的 SDK 安装和 Swift 互操作性问题，请参考以下几点：
- XCode 发出如下错误：“Undefined symbol:
__swift_FORCE_LOAD_$_swiftDataDetection”与“Undefined symbol:__swift_FORCE_LOAD_$_swiftFileProvider”。这些错误意味着您使用的不是最新版 XCode。如要修复这些错误，请更新至 XCode 13 或更高版本。 - XCode 发出许多错误
Undefined symbol__swift_FORCE_LOAD_$_。这些错误意味着您未对项目启用 Swift 支持。如要修复此错误，最简单的方法便是添加一个空 Swift 文件 [在 XCode 中依次选择“File”（文件）->“New”（新建）->“Swift file”（Swift 文件）]。 - 在设备上运行时，应用程序在启动后立即崩溃并发出如下错误：“dyld: Library not loaded: @rpath/FBAudienceNetwork.framework”。此错误意味着您并未在应用中嵌入 Audience Network SDK。如要修复此错误，请前往目标设置，并在“General”（常规）选项卡中为“FBAudienceNetwork.xcframework”选择“Embed & Sign”（嵌入并签名）。
- 应用程序在启动后立即崩溃并发出如下错误：“dyld: Library not loaded: @rpath/libswiftCore.dylib”。此错误意味着您用于运行应用的 iOS 版本早于 12.4，且未将“Always embed Swift standard libraries”（始终嵌入 Swift 标准库）设置设为“YES”（是）。如要修复此错误，请确保在 XCode 中执行如下操作：在应用程序目标的“Build settings”（构建设置）下，将“Always embed Swift standard libraries”（始终嵌入 Swift 标准库）设置设为“YES”（是）。