集成指南
一、Cocoapods集成
在工程
Podfile
文件中添加pod 'BonreeSDK/RUM'
在
Podfile
文件所在路径执行pod install
二、手动集成
- 解压
BonreeSDK_TDEM_iOS.tar.gz
,将BonreeCore.xcframework
,BonreeBusiness.xcframework
,BonreeRUM.xcframework
加入到项目中,如图所示:
BonreeCore.xcframework
,BonreeBusiness.xcframework
若已集成过,则无需重复添加.
在BuildPhass -> Link Binary With Libraries中添加
BonreeCore.xcframework
,BonreeBusiness.xcframework
,BonreeRUM.xcframework
添加以下依赖库:
- libresolv.tbd(必须引入)
- libc++.tbd(必须引入)
- webKit.framework(如果项目支持iOS8之前版本需要添加)
- 在Build Setting中搜索Other Linker Flags, 添加编译标志-ObjC。如图所示:
SDK接入
在mPaaS框架启动BonreeSDK,需要在DTFrameworkInterface
分类中实现- application:beforeDidFinishLaunchingWithOptions:
方法,在该方法中调用start.
- 引入头文件:
#import <BonreeRUM/BonreeRUM.h>
- 调用start方法:
运行后控制台输出BonreeSDK config succeeded
,即表示嵌码成功.如下所示:
2020-12-03 16:17:21.391 [BonreeSDK] [CONFIG] BonreeSDK Config Succeeded.
移动网关功能支持
1. 网络数据支持
在+ startWithAppID:
方法前调用+ useMpaas:
方法并传YES.示例如下:
开启mPaaS开关后,网络数据会依据http响应头内的result-status
字段的值判断网络请求是否正确,并将错误码等相关信息上报至平台展示.
注: 该功能仅支持原生代码发起的请求.
2. 移动网关业务字段捕获
在+ startWithAppID:
方法前调用+ setCustomBusinessHeaders:
方法并将Operation-Type
(以实际请求头传值为准)以字符串数组的形式传入.示例如下:
传入业务头部字段后,网络请求头内与传入字段对应的值会以query的形式拼接在URL内,以便您可以在平台区分不同业务的网络请求数据.