# 安装适用于 iOS 的 Unity Ads SDK

> 在 iOS 项目中安装 Unity Ads SDK。通过 CocoaPods 或手动集成的方式添加 SDK，并根据需要配置 Xcode 项目。

要安装 Unity Ads，您可以使用 [CocoaPods for UnityAds](https://cocoapods.org/pods/UnityAds)，或者您可以手动安装 Unity Ads。

## CocoaPods##cocoapods

要使用 CocoaPods for UnityAds，请遵循以下步骤：

1. 将以下内容添加到项目的 Podfile 中：`pod 'UnityAds'`
2. 运行以下命令：`pod install`

## 手动安装##manual-installation

要手动安装 Unity Ads，请遵循以下步骤：

> **Note:**
>
> 此集成方法要求您在 Build（构建）设置中设置 Framework Search Paths（框架搜索路径）和 Header Search Paths（标头搜索路径）属性。

1. 从首选 SDK 版本的 \*\*Assets（资源）\*\*部分下载 [Unity Ads 框架](https://github.com/Unity-Technologies/unity-ads-ios/releases)。建议下载最新的 SDK，以确保获得最好的可用支持。
2. 将 Unity Ads 框架拖放到工作区中。

> **Important:**
>
> 针对运行 iOS 14 或更高版本用户的项目，必须在信息属性列表文件 ((/grow/ads/ios-sdk/ios14/configure-ad-network-ids)) 中实现 Unity Ads 的网络 ID。

## Swift##swift

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

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

> **Note:**
>
> 如果您的项目是针对低于 12.4 的 iOS 版本，请确保在 Xcode 中将您应用程序目标的 Build settings（构建设置）下的 \*\*Always embed Swift standard libraries（始终嵌入 Swift 标准库）\*\*设置为 `YES`。

### 排除 Swift 互操作性的故障##troubleshooting-swift-interoperability-errors

下面的列表详细说明了在安装 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`。

## 后续步骤##next-steps

请参阅关于[在 iOS 中初始化 SDK](/grow/ads/ios-sdk/initialize-sdk.md) 的文档以继续您的集成。