TrackerFramework 1.0.4

TrackerFramework 1.0.4

seanios维护。



  • Sean

iOS统计SDK集成文档

Cocoapods集成

Cocoapods集成统计SDK,例如工程target名为appDemo,在项目根目录的Podfile的格式:

target 'appDemo' do
pod 'TrackerFramework'
end

TrackerFramework支持的iOS最低版本为9.0

Pod集成示例更新说明

在配置以上 Podfile 文件后,在终端使用 pod update 命令进行更新和集成。

$ cd [存放Podfile的项目路径]
$ pod update

注意:不建议加入--no-repo-update 参数,如果添加后,则只会从本地的CocoaPods库中查找SDK,不再更新线上的SDK。如果本地存在SDK会直接使用本地SDK版本(不是线上的最新版本),如果本地不存在SDK会产生错误。也不建议使用 pod install 命令,此命令不会更新最新版本的SDK。

由于 pod search 命令对新添加的项目可能出现无法找到的情况,建议直接使用 pod update 进行直接更新。

Pod常见问题

问题:运行 pod search 报错:无法找到名为

“Unable to find a pod with name, author, summary, or description matching `TrackerFramework`”

原因:新增 Pod 项目并没有实时同步到 pod search 所需的索引文件中:~/Library/Caches/CocoaPods/search_index.json

解决方案:

1、执行 pod setup,完成后再次进行 pod search 搜索

2、删除上述路径下 cocoaPods 对应的索引文件,然后执行 pod search 时重建索引即可找到相应项目

在终端输入以下命令

rm ~/Library/Caches/CocoaPods/search_index.json

手动集成framwork

从GitHub下载最新SDK https://github.com/wangxinIOS/TrackerFramework

依赖库

CoreTelephony.framework    获取运营商标识
libsqlite3.0.tbd  数据缓存

工程配置

集成步骤如下:

  1. 下载TrackerFramework。

  2. Xcode 文件 —> 将文件添加到“你的项目”,在弹出的面板中选择下载的组件包->添加。(注:选中“如果需要,复制项”)

  1. 添加依赖库,在项目设置目标 -> 选项卡通用 ->链接框架和库如下:

使用Objcetive-C作为项目主要语言时注意一下配置

在项目设置目标 -> 选项卡构建设置 ->构建选项如下:

始终嵌入Swift标准库设置为 Yes

集成说明

创建应用并获取AppId

AppId是统计后台用来标示App的唯一标识符,集成SDK前需要在创建应用并获取相应的AppId。

初始化,示例代码

let conf = TrackerConfiguration.init()
conf.debugMode = true
conf.appId = "testing"
TrackerManager.shareInststance.setup(config: conf)

TrackerConfiguration 属性的说明

/// debug模式 为true打印SDKlog信息  default:false

@objc public var debugMode: Bool



/// test模式  为true时每产生一条数据,就立即上传,不进数据库  default:false

@objc public var testMode: Bool



/// 用户ID 必须设置,default: ""

@objc public var appId: String



/// 渠道 非必须设置,default: ""

@objc public var channel: String



/// 定时上传间隔(秒) testMode=false时有效 default:20,

@objc public var duration: Int



/// 定时上传时,每次上传的最大数量 testMode=false时有效 default:50

@objc public var number: Int



/// 是否搜集View事件 default:false

@objc public var traceView: Bool

用户自定义事件上传,示例代码

TrackerManager.shareInststance.userTrick(name: "用户自定义事件,switch click", variable: ["xxx":"xxxx","bbbbb":"bbbbbbbb"])

variable必须是[Sting:Any]字典

由于SDK处于测试阶段,网络请求使用http协议,项目中需要进行以下配置