iOS SDK 集成指南

本文是JOperate iOS SDK 标准的集成指南文档。

• 如果您想要快速地测试、请参考本文在几分钟内跑通Demo。
• 极光认证文档网站上，有相关的所有指南、API、教程等全部的文档。包括本文档的更新版本，都会及时地发布到该网站上。

适用版本

v2.0.0 及以后版本，目前 SDK 只支持 iOS 10 以上版本的手机系统。

接入配置

添加 SDK 到工程中

选择 1: Cocoapods 导入

• 通过 Cocoapods 下载地址：

              pod 'JOperate'

        

注：如果无法导入最新版本，请执行 pod repo update master 这个命令来升级本机的 pod 库，然后重新 pod 'JOperate'

• 如果需要安装指定版本则使用以下方式（以 2.0.8 版本为例）：

              pod 'JOperate', '2.0.8'

        

选择 2：手动导入

• 在极光官网下载最新 SDK
• 请在自己的工程中导入 libs 文件夹下的 SDK 文件:
  • JOPERATEService.h
• 为工程添加相应的 Frameworks，需要为项目添加的 Frameworks 如下
  • AdSupport.framework（获取 IDFA 需要；如果不使用 IDFA，请不要添加）
  • CoreLocation.framework
  • CFNetwork.framework
  • CoreFoundation.framework
  • libresolv.tbd
  • libz.tbd
  • libc++.1.tbd
  • CoreTelephony.framework
  • SystemConfiguration.framework
  • Security.framework
  • CoreGraphics.framework
  • jcore-ios-x.x.x.a  jcore 版本 3.0.0 及其以上
  • joperate-ios-x.x.x.a 其中  jcore-ios-x.x.x.a  、joperate-ios-x.x.x.a 在 libs 文件夹下

工程配置

配置 -ObjC

设置工程 TARGETS -> Build Settings ->Other Links Flags， 设置 -ObjC

配置支持 Http 传输

右键打开工程 plist 文件，加入以下代码

              <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

        

配置 scheme

在工程 Target -> Info -> URL Types，填写你的 URL Schemes。

注意：必须与控制台的 scheme 保持一致。

接入代码

添加头文件

请将以下代码添加到引用 JOPERATEService.h 头文件的的相关类中

          // 引入 JOPERATEService.h 头文件
#import "JOPERATEService.h"
// 如果需要使用 idfa 功能所需要引入的头文件（可选）
#import <AdSupport/AdSupport.h>

        

初始化代码

请将以下代码添加到合适的位置：

          [JOPERATEService initializeSDK];
JOPERATEConfig *config = [[JOPERATEConfig alloc] init];
config.appKey = @"your appkey";
config.advertisingId = idfaStr;
[JOPERATEService operationStart:config];

        

验证集成结果

集成完成后，如果输出以下日志则代表您已经集成成功。

          JIGUANG | D - [JIGUANG] history cuid: (null), current cuid: 10100400011

        

数据校验模式

若需要查看实时上报可以扫码进入数据校验模式，详情参考 数据校验文档。

更多 API

其他 API 的使用方法请参考接口文档：iOS SDK API

运行 Demo

压缩包附带的 demo 是一个 API 演示例子。你可以将它导入到你的工程，并将你的 AppKey 填入到 demo 的 AppDelegate 中，设置上 BundleID 然后直接运行起来测试。

技术支持

邮件联系：support@jpush.cn