# iOS용 Unity Ads SDK 설치

> iOS 프로젝트에 Unity Ads SDK를 설치합니다. CocoaPods 또는 수동 연동을 통해 SDK를 추가하고 필요에 따라 Xcode 프로젝트를 구성합니다.

Unity Ads를 설치하려면 [UnityAds에 CocoaPods](https://cocoapods.org/pods/UnityAds)를 사용하거나 Unity Ads를 수동으로 설치할 수 있습니다.

## CocoaPods##cocoapods

UnityAds에 CocoaPods를 사용하려면 다음을 수행합니다.

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 이상을 실행하는 사용자를 대상으로 하는 프로젝트는 Information property 목록 파일((/grow/ads/ios-sdk/ios14/configure-ad-network-ids))에서 Unity Ads의 네트워크 ID를 구현해야 합니다.

## Swift##swift

SDK 버전 4.4.0부터 Unity Ads는 Swift 프로그래밍 언어를 사용하여 최적화되었습니다.

* 프로젝트에서 이미 Swift를 사용 중인 경우 추가 조치가 필요하지 않습니다.
* 프로젝트에서 Swift를 사용하지 않는 경우 **File** > **New** > **Swift file**을 선택하여 Xcode의 프로젝트에 빈 Swift 파일을 추가합니다.

> **Note:**
>
> 프로젝트가 iOS 12.4 이전 버전을 대상으로 하는 경우, Xcode에서 애플리케이션 대상의 Build 설정 아래에서 **Always embed Swift standard libraries** 설정을 `YES`로 설정해야 합니다.

### Swift 상호호환성 오류 문제 해결##troubleshooting-swift-interoperability-errors

다음 목록에는 Unity Ads SDK 설치 중에 발생할 수 있는 일반적인 Swift 상호호환성 문제가 자세히 설명되어 있습니다.

* Xcode는 많은 `Undefined symbol_swift_FORCE_LOAD$_` 오류를 생성합니다.
  * 오류를 해결하려면 **File > New > Swift file**을 선택하여 Xcode의 프로젝트에 빈 Swift 파일을 추가합니다.
* 시작 후 다음 오류와 함께 애플리케이션에서 크래시가 발생합니다. `dyld: Library not loaded: @rpath/libswiftCore.dylib`
  * 이 문제를 해결하려면 Xcode의 애플리케이션 대상의 Build 아래에서 **Always embed Swift standard libraries**를 `YES`로 설정했는지 확인하십시오.

## 다음 단계##next-steps

연동을 계속 진행하려면 [iOS에서 SDK 초기화](/grow/ads/ios-sdk/initialize-sdk.md) 기술 자료를 참조하십시오.