로딩중입니다
SDK 설치 : iOS
4/3/2015 9:03:32 PM

IGAW 공통 연동

IGAWorks의 모든 서비스는 공통 모듈 + 애드온의 형태로 제공 되고 있습니다.

따라서 애드브릭스, 애드팝콘(오퍼월,DA), 라이브옵스, 프로모션, 쿠폰, 나누 등의 서비스 이용을 위해서는 반드시 공통 연동을 먼저 진행해야 합니다.


* 업데이트 안내 *
8월 26일 업데이트된 iOS SDK 버전부터 서비스별로 프레임워크가 분할됐습니다.
기존 : 통합 프레임워크 (모든 서비스 지원)
변경 : 개별 프레임워크 (각 서비스 단위 분리)

SDK 설치방법 안내 & 다운로드

IGAWorks iOS SDK를 설치는 2가지 방법으로 진행 가능합니다.
2가지 방법 중에서 원하시는 방법을 선택하여 iOS SDK 설치를 진행합니다.

  • CocoaPods 이용(권장)
  • 직접 설치


최소 요구 사항

IGAWorks iOS SDK의 최소 요구 사항은 다음과 같습니다.

  1. Xcode 7.0 이상
  2. iOS SDK 8.0 이상
  3. Deployment Target 8.0 이상

다음 링크에서 최신 버전의 iOS SDK를 다운로드 합니다.

[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 공통 연동을 계속 진행합니다.

[IGAW 공통 연동 : iOS]



직접 설치

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
MessageUI
MobileCoreServices

AVKit
AVfoundation
CoreMedia

MediaPlayer

AdPopcornDA.bundle -
LiveOps Live Operation Push & Popup - 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


프레임 워크 추가

다운로드 한 최신의 iOS SDK 파일을 Xcode 프로젝트 폴더 타겟에 드래그하여 추가합니다.



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 공통 연동을 계속 진행합니다.

[ IGAW 공통 연동 : iOS]