安装适用于 iOS 的 Unity Ads SDK

要安装 Unity Ads,您可以使用 CocoaPods for UnityAds,或者您可以手动安装 Unity Ads。

CocoaPods

要使用 CocoaPods for UnityAds,请遵循以下步骤:

  1. 将以下内容添加到项目的 Podfile 中:

    pod 'UnityAds'

  2. 运行以下命令:

    pod install

手动安装

要手动安装 Unity Ads,请遵循以下步骤:

注意:此集成方法要求您在 Build(构建)设置中设置 Framework Search Paths(框架搜索路径)和 Header Search Paths(标头搜索路径)属性。

  1. 从首选 SDK 版本的 **Assets(资源)**部分下载 Unity Ads 框架。建议下载最新的 SDK,以确保获得最好的可用支持。
  2. 将 Unity Ads 框架拖放到工作区中。

重要:针对运行 iOS 14 或更高版本用户的项目,必须在信息属性列表文件 (Info.plist) 中实现 Unity Ads 的网络 ID

Swift

从 SDK 4.4.0 版开始,Unity Ads 已经通过使用 Swift 编程语言进行了优化。

  • 如果您的项目已经使用了 Swift,那么就不需要进一步的操作了。
  • 如果您的项目不使用 Swift,在 Xcode 中通过选择 **File(文件)> New(新建)> Swift file(Swift 文件)**将一个空的 Swift 文件添加到您的项目中。

注意:如果您的项目是针对低于 12.4 的 iOS 版本,请确保在 Xcode 中将您应用程序目标的 Build(构建)设置下的 Always embed Swift standard libraries(始终嵌入 Swift 标准库) 设置为 YES

排除 Swift 互操作性的故障

下面的列表详细说明了在安装 Unity Ads SDK 期间可能发生的常见 Swift 互操作性问题:

  • Xcode 会发出许多 Undefined symbol_swift_FORCE_LOAD$_ 错误。

    • 为了解决这个问题,在 Xcode 中通过选择 **File(文件)> New(新建)> Swift file(Swift 文件)**将一个空的 Swift 文件添加到您的项目中。
  • 应用程序启动后崩溃,并出现以下错误:dyld: Library not loaded: @rpath/libswiftCore.dylib

    • 为了解决这个问题,确保在 Xcode 中将您应用程序目标的 Build(构建)设置下的 Always embed Swift standard libraries(始终嵌入 Swift 标准库) 设置为 YES

后续步骤

请参阅关于在 iOS 中初始化 SDK 的文档以继续您的集成。