iOS SDK 集成指南
最近更新:2023-11-03
展开全部

iOS SDK 集成指南

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

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

适用版本

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

接入配置

添加 SDK 到工程中

选择 1: Cocoapods 导入

  • 通过 Cocoapods 下载地址:
pod 'JOperate'
              pod 'JOperate'

        
此代码块在浮窗中显示

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

  • 如果需要安装指定版本则使用以下方式(以 2.0.0 版本为例):
pod 'JOperate', '2.0.0'
              pod 'JOperate', '2.0.0'

        
此代码块在浮窗中显示

选择 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>
              <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

        
此代码块在浮窗中显示

配置 scheme

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

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

image.png

接入代码

添加头文件

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

// 引入 JOPERATEService.h 头文件 #import "JOPERATEService.h" // 如果需要使用 idfa 功能所需要引入的头文件(可选) #import <AdSupport/AdSupport.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];
          [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
          JIGUANG | D - [JIGUANG] history cuid: (null), current cuid: 10100400011

        
此代码块在浮窗中显示

数据校验模式

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

更多 API

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

运行 Demo

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

技术支持

邮件联系:support@jpush.cn

文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开