iOS 集成文档

1. 获取appid

登陆个推开发者中心，进入个像产品页，按照步骤提示注册应用，可获得 appid。

请确保在个像开发者中心正确配置 BundleId。

2. 打开项目工程

启动 Xcode, 打开您之前创建的 Xcode 项目工程

3. 配置个像 SDK

3.1 CocoaPods 集成方式

3.1.1 安装 CocoaPods

安装方式简单 , Mac 下都自带 ruby，使用 ruby 的 gem 命令即可下载安装：

$ sudo gem install cocoapods
$ pod setup

3.1.2 准备 Podfile

使用时需要新建一个名为 Podfile 的文件（若已存在该文件不需要重新创建），如下格式，将依赖的库名字依次列在文件中即可：

target 'YourTargetName' do
    platform :ios, "8.0"
    pod 'GInsightSDK'
end

3.1.3 完成 GInsight 导入

将编辑好的 Podfile 文件放到你的项目根目录中，执行如下命令即可：

$ cd "<path/to/project>"
$ pod install

3.2 Xcode 集成方式

前往SDK下载中心下载对应资料包

3.2.1 导入 GInsight SDK 和相应 Framework

添加需要用到的Framework

注意事项：集成GInsight SDK需要使用到IDFA所以必须添加AdSupport.framework,并且为了审核通过需要勾选如图：

初始化

在您应用的启动入口application:didFinishLaunchingWithOptions:方法中调用GInsight SDK初始化方法

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [GInsightSDK startSDK:kGIAppID channel:@"channel" onSuccess:^(NSString *giUid) {
        NSLog(@"giuid : %@",giUid);
    } onFail:^(NSString *failInfo) {
        NSLog(@"GInsightSDKDidReceiveError %@",failInfo);
    }];
}

4. SDK 接口类说明

SDK 功能接口，用于调用 GInsight 相关功能

方法详细资料

初始化

+ (void)startSDK:(NSString *)appId channel:(NSString *)channel onSuccess:(GISuccessCallback)success onFail:(GIFailCallback)fail;

参数：

appId - 您的appid

channel - 渠道

onSuccess - 初始化成功回调

onFail - 初始化失败回调

示例：

[GInsightSDK startSDK:kGIAppID channel:@"channel" onSuccess:^(NSString *giUid) {
        //code
    } onFail:^(NSString *failInfo) {
        //code
    }];

获取SDK版本号

+ (NSString *)version;

返回：

SDK版本号

示例：

NSString *version = [GInsightSDK version];