IGAW 공통 연동
IGAWorks의 모든 서비스는 공통 모듈 + 애드온의 형태로 제공 되고 있습니다.
따라서 애드브릭스, 애드팝콘(오퍼월,DA), 라이브옵스, 프로모션, 쿠폰, 나누 등의 서비스 이용을 위해서는 반드시 공통 연동을 먼저 진행해야 합니다.
애드브릭스 연동을 진행하실려면 애드브릭스 리마스터를 연동해 주시길 부탁드립니다.
SDK 설치방법 안내 & 다운로드
- CocoaPods 이용(권장)
- 직접 설치
최소 요구 사항
IGAWorks iOS SDK의 최소 요구 사항은 다음과 같습니다.
- Xcode 7.0 이상
- iOS SDK 8.0 이상
- Deployment Target 8.0 이상
다음 링크에서 최신 버전의 iOS SDK를 다운로드 합니다.
CocoaPods 이용
IGAWorks iOS SDK 는 CoCoaPods를 이용한 자동설치를 지원합니다.
CocoaPods를 이용하시면 보다 편리하게 SDK를 설치할 수 있습니다.
CocoaPods 설치 및 초기화
CocoaPods가 설치되어 있지 않다면 Mac OSX 의 터미널을 실행하여 CocoaPods를 설치합니다.
$ sudo gem install cocoapods
설치가 완료되면 다음과 같은 터미널 화면을 확인할 수 있습니다.
설치가 완료된 후에 CocoaPods를 초기화 합니다.
$ pod setup
초기화 이후에 다음과 같은 화면이 보이신 다면, cocoapods 설치가 완료된 것입니다.
Podfile 생성 및 편집
CocoaPods 를 적용할 Xcode 프로젝트 파일이 있는 폴더로 이동하여 Podfile를 생성합니다.
$ cd /path/to/MyXcodeProject
$ touch Podfile
터미널에서 vi 에디터를 실행하여 Podfile 의 내용을 다음과 같이 수정한 뒤에 ESC, Shift+Z(2번)를 연속으로 눌러 종료합니다.
platform :ios, '8.0'
target "myProjectName" do
pod 'IgaworksCore'
end
만약 복수개의 서비스 별 프레임워크를 설치하고자 할 경우에는 아래와 같이 pod를 추가 등록합니다.
platform :ios, '8.0'
target "myProjectName" do
pod 'IgaworksCore'
pod 'AdBrix'
pod 'AdPopcornOfferwall'
pod 'AdPopcornDA'
pod 'IgaworksCommerce'
pod 'IgaworksCoupon'
pod 'IgaworksNanoo'
pod 'LiveOps'
end
+ platform 의 값 중, '8.0' 의 값은 Xcode 프로젝트에서 지원하는 최소 iOS OS 버전을 의미합니다.
+ 일반 텍스트 에디터에서는 인코딩 문제로 오류가 발생할 수도 있습니다.
Igaworks iOS SDK 설치 및 확인
다음 명령어를 입력하여 iOS SDK를 설치합니다.
$ pod install
설치가 완료되면 아래의 명령어를 입력하여 Xcode 프로젝트에 IGAWorks iOS SDK가 정상적으로 설치된 것을 확인할 수 있습니다.
$ open MyXcodeProject.xcworkspace
추 후에 업데이트 된 IGAWorks iOS SDK를 적용하기 위해서는 아래와 같이 입력합니다.
$pod update
IGAW 공통 연동 API
설치가 완료된 후에 아래 링크로 이동하여 IGAW 공통 연동을 계속 진행합니다.
직접 설치
CocoaPod 이 아닌 수동으로 직접 SDK를 설치하기를 원하실 경우에는 아래 가이드를 참고하여 진행합니다.
서비스 별 필요사항
이용하시고자 하는 서비스에 따라서 필요한 framework, dependencies, bundles가 상이합니다.
아래 표를 참고하시어 설치를 진행합니다.
framework | service | dependencies | bundles | bundle description |
---|---|---|---|---|
IgaworksCore | Tracking Link Basic Analytics Adpopcorn CPI ADs |
libxml2.dylib iAd CoreTelephony SystemConfiguration UIKit Security CoreGraphics CoreText |
- | - |
AdBrix | Advanced Analytics |
MessageUI | - | - |
Cross Promotion | Social | AdBrix.bundle | CrossPromotion, CPI+친구초대 이용 시 | |
AdPopcornOfferwall | Adpopcorn Offerwall | ImageIO MessageUI SafariServices MediaPlayer AdSupport AVKit AVfoundation CoreMedia |
AdPopcornOfferwall.bundle | - |
AdPopcornDA | Adpopcorn Display AD | AdSupport AVKit MediaPlayer |
AdPopcornDA.bundle | - |
LiveOps | Live Operation Push & Popup | NotificationCenter UserNotifications |
LiveOps.bundle | - |
IgaworksNanoo | Nanoo Community | SafariServices | IgaworksNanoo.bundle | - |
IgaworksCoupon | Coupon | - | IgaworksCoupon.bundle | - |
IgaworksCommerce | Adbrix for Commerce | - | - |
* bundle 파일은 framework 안에 Resources 폴더 아래에 있습니다. (예: AdBrix.framework > Version > A > Resources)
* 애드팝콘 최신 버전(v2.0.8)에는 아래의 Dependencies 가 추가로 필요합니다.
- AVKit.framework
- AVfoundation.framework
- CoreMedia.framework
프레임 워크 추가
Dependencies 추가
이용하고자 하는 서비스에 따라 필수 Dependencies 목록이 다릅니다. 위 [서비스 별 필요사항] 표를 참고하시어 Dependecies를 추가합니다.
Bundle resource 추가
이용하고자 하는 서비스에 따라서 bundle resources 파일을 추가해야 합니다.
필요한 bundle 파일의 내용은 [서비스 별 필요사항] 표를 참고하시면 됩니다.
빌드 옵션 추가
Build Settings Pane -> Linking -> Other Linker Flags 섹션에 - all_load 혹은 -force_load 와 같이 빌드 옵션을 추가합니다.
+ " -force_load " 옵션을 사용할 때에는 추가한 framework 파일이 있는 Path 를 명시하여 설정합니다.
IGAW 공통 연동 API
설치가 완료된 후에 아래 링크로 이동하여 IGAW 공통 연동을 계속 진행합니다.