로딩중입니다
[iOS] SDK 安装 : Native iOS
8/25/2015 12:27:37 PM

IGAW 共同集成

IGAWorks 的所有服务是以共同模板 + add-on 的形式提供。

因此使用 adbrix、adPOPcorn(积分墙,DA)、LiveOps、优惠券 等服务时,必须先集成共同模板事项。


* 更新通知 *
8月 26日更新的 iOS SDK 版本分别提供各个服务的 Framework。
原版本 : 综合 Framework (提供所有服务)
更新版本 : 单个 Framework (按服务各提供)

SDK 安装方式 & 下载

IGAWorks iOS SDK 有两种方式提供安装方式。
请选择自己的开发环境来进行 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 的 terminal(终端) 后进行安装 CocoaPods。

$ sudo gem install cocoapods

完成 CocoaPods 安装的话,可以确认如下 Terminal 界面。

CocoaPods 安装后,麻烦再次初始化。

$ pod setup

初始化后还是显示如下界面的话,这意味着 CocoaPods 成功安装。


Podfile 生成及编辑

将 CocoaPods 移动至要适用 Xcode Project File 文件夹,进行生成 Podfile。

$ cd /path/to/MyXcodeProject
$ touch Podfile


在 terminal 上启动 vi editor 后,像如下修改 Podfile 内容。vi 修完后,连续点击两次 ESC、Shift+Z  终止。

platform :ios, '8.0'
target "myProjectName" do
pod 'IgaworksCore'
end


若要安装各服务的 Framework 时,按照如下截图来进行添加 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 Project 上最低支持的 iOS OS 版本"。

+ 若在一般 text editor 上添加的话,偶尔会发生编码导致的错误。


Igaworks iOS SDK 安装及确认

请输入如下命令语,进行安装 iOS SDK。

$ pod install  

安装完成后再输入如下命令语时,会确认 Xcode Project 上正常安装的 IGAWorks iOS SDK 内容。

$ open MyXcodeProject.xcworkspace


将后更新 IGAWorks iOS SDK 时,需输入如下命令语。

$pod update


IGAW 共同集成 API

iOS SDK 安装完成后,转移到如下链接而持续进行对接 IGAW 共同模板。

[IGAW 共同集成 : iOS]



直接安装

不使用 CocoaPod 自动安装,而需手动安装 SDK 的话,请参考如下步骤。(需各添加文档里的资源)


各服务需求事项

随着想要使用服务,framework、dependencies、bundles 都有所不同。

请参考如下列表,安装 iOS SDK。

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

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)

* 最新版本的 adPOPcorn 是需要再加如下 Dependencies。

  • AVKit.framework
  • AVfoundation.framework
  • CoreMedia.framework


Framework 添加

已下载的最新版本的 iOS SDK 文件,拖进到 Xcode Project Folder Target 中。



Dependencies 添加

随着想要使用的服务,Dependencies 的目录会有所不同。请参考上述 [按服务需求事项] 列表来进行添加 Dependencies。



Bundle resource 添加

也是想要使用的服务来再添加 bundle resources 资源。

请参考上述 [按服务需求事项] 列表来进行添加 bundle resources。


Build Option 添加

Build Settings Pane -> Linking -> Other Linker Flags 上添加 - all_load 或者  -force_load Build Option。

在使用 " -force_load " 时,需指定 添加的 framework 文档的 Path



IGAW 共同集成 API

安装完成后,请转移到如下链接再次进行对接 IGAW 共同事项。

[ IGAW 共同集成 : iOS]