腾讯云客户端性能分析移动端监测iOS接入步骤

移动端监测-iOS接入步骤

SDK 集成

1. 下载最新版Xray_iOS_v3.0.2.zip

2. 下载完成后包含如下两个文件

   CrashReporter.framework# Crash 收集框架Xray.framework # Xray 性能统计框架

3. 将 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 初始化

1. 导入头文件

   在工程的AppDelegate.m文件中导入头文件

   #import <Xray/Xray.h>

2. 初始化SDK

   在application:didFinishLaunchingWithOptions:方法中加入如下代码初始化SDK：

   [Xray startWithAppKey:@"YourAppKey"];

   YourAppKey为在阿里云平台申请的AppKey。 Clean Project 后编译并运行你的工程，即可拥有Xray的性能数据收集上报功能。

注：如果你的项目中引用了其它同类产品，并且想使用 Xray 的 Crash 收集功能，我们强烈建议你把它们的错误收集功能关闭，并且将Xray的初始代码放在同类产品后面

高级功能

Crash 收集

1. 发生Crash后在回调中添加自定义信息，首先遵守代理协议

   @interface AppDelegate () <XrayCrashDelegate>

2. 设置代理对象

   [Xray setCrashCallBackDelegate:self];

3. 实现回调方法，添加自定义信息

   - (void)crashCallBack { [Xray addCrashAttachLog:@"value1" forKey:@"key1"]; [Xray addCrashAttachLog:@"value2" forKey:@"key2"]; [Xray addCrashAttachLog:@"value3" forKey:@"key3"]; //do other thing...}

4. 假如只想统计Objective-C层面的 Crash，则需要添加以下代码：

   [Xray setOnlyCollectUncaughtExceptionEnable:YES];

其他配置

1. SDK log 开关，默认为关

   [Xray setLogEnable:YES];

2. 设置APP版本号，默认为CFBundleShortVersionString

   [Xray setAppVersion:@"1.0.0.1"];

3. 上传APP启动时间

   [Xray uploadStartUpTime:@3];

4. 设置仅在WiFi下采集和上传数据，默认为 NO

   [Xray setUploadDataOnlyWifi:YES];

5. 设置用户名，用户 ID

   [Xray setUserName:@"USER_NAME"];[Xray setCUID:@"CUID"];