安装适用于 iOS 的 Unity Ads SDK
要安装 Unity Ads,您可以使用 CocoaPods for UnityAds,或者您可以手动安装 Unity Ads。
CocoaPods
要使用 CocoaPods for UnityAds,请遵循以下步骤:
将以下内容添加到项目的 Podfile 中:
pod 'UnityAds'
运行以下命令:
pod install
手动安装
要手动安装 Unity Ads,请遵循以下步骤:
注意:此集成方法要求您在 Build(构建)设置中设置 Framework Search Paths(框架搜索路径)和 Header Search Paths(标头搜索路径)属性。
- 从首选 SDK 版本的 **Assets(资源)**部分下载 Unity Ads 框架。建议下载最新的 SDK,以确保获得最好的可用支持。
- 将 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
。
- 为了解决这个问题,确保在 Xcode 中将您应用程序目标的 Build(构建)设置下的 Always embed Swift standard libraries(始终嵌入 Swift 标准库) 设置为
后续步骤
请参阅关于在 iOS 中初始化 SDK 的文档以继续您的集成。