> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/sdk/ios/ios-3.1.0+/undefined/cocoapod.md).

# CocoaPod 설치

CocoaPod을 이용한 설치 방법 입니다.

### SDK 사양

* iOS 14.0 이상 (SDK 2.11.1 부터 최소 지원 사양 14.0으로 변경. 기존 11.0)
* Xcode 11 이상

## SDK 설치

### 1) CocoaPods 설치 및 초기화

CocoaPods가 설치되어 있지 않다면 Mac OSX 의 터미널을 실행하여 CocoaPods를 설치합니다.

```
$ sudo gem install cocoapods
```

설치가 완료된 후 CocoaPods를 초기화합니다.

```
$ pod setup
```

### 2) Podfile 생성 및 편집

CocoaPods 를 적용할 Xcode 프로젝트 파일이 있는 폴더로 이동하여 Podfile를 생성합니다.

```
$ pod init
$ cd /path/to/MyXcodeProject
$ touch Podfile
```

터미널에서 vi 에디터를 실행하여 Podfile 의 내용을 다음과 같이 수정한 뒤에 ESC, Shift+Z(2번)를 연속으로 눌러 종료합니다.

```applescript
platform :ios, '15.0'

target 'AdPopcornSSP_CocoaPod_Test' do
  use_frameworks! :linkage => :static       #  3rd party SDK가 static xcframework 이므로 필수

  # APSSPSDK 코어 (필수)
  pod 'APSSPSDK', '3.4.2'

  # 미디에이션 Adapter (사용할 업체만 추가)
  pod 'APSSPMediationAdMob'
  pod 'APSSPMediationADOP'
  pod 'APSSPMediationGAM'
  pod 'APSSPMediationAdForus'
  pod 'APSSPMediationAppLovin'
  pod 'APSSPMediationAppLovinMax'
  pod 'APSSPMediationVungle'
  pod 'APSSPMediationUnityAds'
  pod 'APSSPMediationPangle'
  pod 'APSSPMediationFBAudienceNetwork'
  pod 'APSSPMediationMintegral'
  pod 'APSSPMediationFyber'
  pod 'APSSPMediationNAM'
  pod 'APSSPMediationAdFit'            # CocoaPods 최종 버전: 3.18.3 (이후 SPM만 지원)
  pod 'APSSPMediationMezzo'
  pod 'APSSPMediationInMobi'
  pod 'APSSPMediationMaio'
  pod 'APSSPMediationCSJ'
  pod 'APSSPMediationMoloco'
  pod 'APSSPMediationFluct'
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
    end
  end
end

```

{% hint style="info" %}
platform 의 값 중 '12.0' 의 값은 Xcode 프로젝트에서 지원하는 최소 iOS OS 버전을 의미합니다.
{% endhint %}

### 3) SDK 설치 및 설치 확인

다음 명령어를 입력하여 SDK를 설치합니다.

```
$ pod install
```

다음의 명령어를 실행하여 프로젝트에 설치된 SDK를 확인할 수 있습니다.

```
$ open MyXCodeProject.wcworkspace
```

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FFUVIuLOHrpKC7bPBWNdj%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-05-19%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2012.13.01.png?alt=media&amp;token=fe10cfa8-3033-4606-8205-cade606d32cb" alt=""><figcaption></figcaption></figure>

### 4) SandBox 설정&#x20;

**Build setting -> user script Sandboxing = No** 설정

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FZSZonXe3CzHQWDEYljth%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-05-19%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2012.10.10.png?alt=media&amp;token=117d13d8-992a-4b0a-97a4-878857230f49" alt=""><figcaption></figcaption></figure>