腾讯云客户端性能分析移动端监测iOS接入步骤
移动端监测-iOS接入步骤
SDK 集成
- 下载最新版Xray_iOS_v3.0.2.zip
-
下载完成后包含如下两个文件
CrashReporter.framework# Crash 收集框架Xray.framework # Xray 性能统计框架
-
将 SDK 添加到工程
将两个framework 拖至 Xcode 工程内,并勾选Copy items if needed在 Build Settings 搜索 Other Linker Flags,添加 -ObjC 标识在 Build Phases 的 Link Binary With Libraries 中添加系统库文件 libz.tbd、CoreTelephony.framework、SystemConfiguration.framework、WebKit.framework
SDK 初始化
-
导入头文件
在工程的AppDelegate.m文件中导入头文件
#import <Xray/Xray.h>
-
初始化SDK
在application:didFinishLaunchingWithOptions:方法中加入如下代码初始化SDK:
[Xray startWithAppKey:@"YourAppKey"];
YourAppKey为在阿里云平台申请的AppKey。 Clean Project 后编译并运行你的工程,即可拥有Xray的性能数据收集上报功能。
注:如果你的项目中引用了其它同类产品,并且想使用 Xray 的 Crash 收集功能,我们强烈建议你把它们的错误收集功能关闭,并且将Xray的初始代码放在同类产品后面
高级功能
Crash 收集
-
发生Crash后在回调中添加自定义信息,首先遵守代理协议
@interface AppDelegate () <XrayCrashDelegate>
-
设置代理对象
[Xray setCrashCallBackDelegate:self];
-
实现回调方法,添加自定义信息
- (void)crashCallBack { [Xray addCrashAttachLog:@"value1" forKey:@"key1"]; [Xray addCrashAttachLog:@"value2" forKey:@"key2"]; [Xray addCrashAttachLog:@"value3" forKey:@"key3"]; //do other thing...}
-
假如只想统计Objective-C层面的 Crash,则需要添加以下代码:
[Xray setOnlyCollectUncaughtExceptionEnable:YES];
其他配置
-
SDK log 开关,默认为关
[Xray setLogEnable:YES];
-
设置APP版本号,默认为CFBundleShortVersionString
[Xray setAppVersion:@"1.0.0.1"];
-
上传APP启动时间
[Xray uploadStartUpTime:@3];
-
设置仅在WiFi下采集和上传数据,默认为 NO
[Xray setUploadDataOnlyWifi:YES];
-
设置用户名,用户 ID
[Xray setUserName:@"USER_NAME"];[Xray setCUID:@"CUID"];