> For the complete documentation index, see [llms.txt](https://platform-business.gitbook.io/adpie/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://platform-business.gitbook.io/adpie/ios/project-settings.md).

# 프로젝트 설정

### 1 : SDK 연동을 위한 준비

* Xcode 16.0 이상
* Deployment Target : iOS 12.0 이상

> 앱 스토어 커넥트에 업로드 날짜에 따른 빌드에 사용하는 Xcode 버전 요구사항은 다음과 같습니다.
>
> * 2025년 4월 24일부터: Xcode 16 이상
> * 2026년 4월 28일부터: Xcode 26 이상\
>   \
>   <https://developer.apple.com/kr/news>

### 2 : 설치

#### [`CocoaPods`](https://cocoapods.org) 사용

* AdPie SDK의 최신버전을 가져오려면 아래와 같이 프로젝트의 Podfile에 추가합니다.

```
  platform :ios, '12.0'
  use_frameworks!

  target YOUR_PROJECT_TARGET do
    pod 'AdPieSDK'
  end
```

* 터미널 실행하고 iOS 프로젝트가 있는 경로로 이동 후, 아래 명령어를 실행하여 AdPie SDK를 설치합니다.

```
  pod install --repo-update
```

#### [Swift Package Manager](https://swift.org/package-manager) 사용

* Xcode 실행 후, `Add Package Dependencies` 메뉴를 클릭합니다.

```
  Xcode > File > Add Package Dependencies....
```

* 프롬프트 창이 나타나면 아래의 Git Hub 저장소 URL를 사용하여 검색합니다.

```
  https://github.com/gomfactory/AdPie-iOS-SDK.git
```

* 설치하려는 버전을 선택하고 `Add Package` 버튼을 클릭하여 AdPie SDK를 설치합니다.

  > Swift Package Manager 를 이용하여 SDK를 설치하는 경우, AdPie SDK V1.6.3 버전부터 설치 가능.
* 아래의 `Xcode 프로젝트 설정` 내용을 참고하여 `Other Linker Flags` 설정을 완료합니다.

#### SDK 수동 설치

* SDK 및 샘플프로젝트를 [download](https://github.com/gomfactory/AdPie-iOS-SDK/archive/master.zip) 합니다.
* `AdPie-iOS-SDK-master.zip` 파일을 압축을 해제하고 `AdPieSDK.xcframework` 파일이 있는지 확인합니다.
* Xcode에서 타겟 프로젝트 선택 후, `General -> Frameworks, Libraries, and Embedded Content` 에 `AdPieSDK.xcframework` 파일을 드래그하여 추가합니다.

<figure><img src="https://1072946756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh39HnaSiiPTrGCntZMCm%2Fuploads%2FWC99VgUJWbuYsrwrhTJ2%2Fmanual_install.png?alt=media&amp;token=5f88c9cb-3b53-4b0b-aef1-3b0eea265293" alt=""><figcaption></figcaption></figure>

* 아래의 `Xcode 프로젝트 설정` 내용을 참고하여 `Other Linker Flags` 설정을 완료합니다.

#### Xcode 프로젝트 설정

* Xcode 실행 > 프로젝트 타겟 선택 > Build Settings에서 `Other Linker Flags` 에 `$(inherited)` 와 `-ObjC` 플래그가 추가되어 있는지 확인합니다.

  > 위의 플래그가 없을 경우 , 비정상 종료(Crash)가 발생할 수 있습니다.

<figure><img src="https://1072946756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh39HnaSiiPTrGCntZMCm%2Fuploads%2FEtKufjzYtCtaOf9Ev2AT%2Fother_link_flag.png?alt=media&amp;token=97d14b29-1c04-412e-aae8-c9d4c5656133" alt=""><figcaption></figcaption></figure>

### 3 : iOS 14+ 대응

* [iOS 14+ 대응](https://github.com/gomfactory/AdPie-iOS-SDK/wiki/iOS-14-%EC%9D%B4%EC%83%81--%EB%8C%80%EC%9D%91) 페이지를 통해 info.plist 와 코드를 적용합니다.
