移动端监测-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. 实现回调方法,添加自定义信息(最多10条)

    - (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"];