ios Bugly使用简介

• 
  

  转载地址：http://www.jianshu.com/p/846412365179

  初始化

  初始化需要一个AppId，在Bugly上新建一个应用就可以获取对应的AppId了；初始化Bugly也很简单:

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 改成你的AppId
    [Bugly startWithAppId:Bugly_ID];
    return YES;
  }

  到此，你就可以正式使用Bugly啦！！！
  但是我们就这样使用Bugly是不是太可惜了，我们来看看Bugly还有什么功能；查看头文件，会发现Bugly有三个类暴露出来，分别是Bugly、BuglyConfig和BuglyLog。

  1.自定义初始化

  BuglyConfig类主要用于个性话配置Bugly类，由一些属性和BuglyDelegate代理组成。
  属性：BuglyConfig大部分属性有设有默认值，一般不用更改，但是关于卡顿监控的属性确是默认关闭的：

  /**
  *  卡顿监控开关，默认关闭
  */
  @property (nonatomic) BOOL blockMonitorEnable;
  /**
  *  卡顿监控判断间隔，单位为秒
  */
  @property (nonatomic) NSTimeInterval blockMonitorTimeout;

  如果需要上报卡顿，只需要将blockMonitorEnable设为true，给blockMonitorTimeout设置一个合理的值即可；
  代理：BuglyConfig可以设置一个代理，来自定义上传崩溃的附属信息；

  @protocol BuglyDelegate <NSObject>
  
  @optional
  /**
  *  发生异常时回调
  *  @param exception 异常信息
  *  @return 返回需上报记录，随异常上报一起上报
  */
  - (NSString * BLY_NULLABLE)attachmentForException:(NSException * BLY_NULLABLE)exception;
  @end

  这个时候我们的初始化就可以写成：

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
    // 启动Bugly
    [Bugly startWithAppId:Bugly_ID config:^{
        BuglyConfig *config = [[BuglyConfig alloc] init];
        config.blockMonitorEnable = YES;
        config.blockMonitorTimeout = 2;
        config.consolelogEnable = YES;
        config.delegate = self;
        return config;
    }()];
    return YES;
  }
  
  - (NSString *)attachmentForException:(NSException *)exception {
    return @"Do you want to do...";
  }

  2.上传打印日志

  BuglyLog类主要用于打印日志，有6种级别:

  typedef NS_ENUM(NSUInteger, BuglyLogLevel) {
    BuglyLogLevelSilent  = 0,
    BuglyLogLevelError   = 1,
    BuglyLogLevelWarn    = 2,
    BuglyLogLevelInfo    = 3,
    BuglyLogLevelDebug   = 4,
    BuglyLogLevelVerbose = 5,
  };

  BuglyLog除了控制台打印，还有一个重要功能就是上报打印内容，内容将在崩溃时一同被上报;但是这个功能是默认不上报的，需要配置BuglyConfig的reportLogLevel属性；如config.reportLogLevel = BuglyLogLevelWarn，将会上报BuglyLogLevelWarn和BuglyLogLevelError级别的打印日志。

  3. 自定义上报异常

  我们再回到Bugly类，除了初始化Bugly的方法外，还有一些其他的方法：

• 关键值上报

  /**
  *  设置关键数据，随崩溃信息上报
  */
  + (void)setUserValue:(nonnull NSString *)value
              forKey:(nonnull NSString *)key;

• 自定义上报错误

  /**
  *  上报自定义异常
  *  @param exception 异常信息
  */
  + (void)reportException:(nonnull NSException *)exception;
  /**
  *  上报错误
  *  @param error 错误信息
  */
  + (void)reportError:(NSError *)error;

  这个功能可以说十分有用，可以让我们定位到一些没有引起崩溃的问题，我们可以在一些关键操作和网络请求处上报一些异常信息，以此优化我们的程序；这些错误信息在错误分析可以被查看到。

• 上传符号表

  当我们到Bugly查看崩溃信息的时候，会发现堆栈信息打印了一堆地址，特别是信号量出错的情况下，很难有效的定位到崩溃原因，这个时候就需要符号表了。

  • 什么是符号表
    符号表是内存地址与函数名、文件名、行号的映射表。符号表元素如下所示：
    <起始地址> <结束地址> <函数> [<文件名:行号>]
  • 为什么要配置符号表？
    为了能快速并准确地定位用户APP发生Crash的代码位置，Bugly使用符号表对APP发生Crash的程序堆栈进行解析和还原。

  符号表可以在我们的工程中配置sh脚本快速上传，手动上传的话麻烦一点，详细请看官方文档.

• 
  

自己使用的例子：

//Bugly记录圈存初始换返回信息

BuglyConfig * config = [[BuglyConfig alloc] init];

// 设置自定义日志上报的级别，默认不上报自定义日志

config.reportLogLevel = BuglyLogLevelWarn;

config.delegate = self;

NSError *error = [NSError errorWithDomain:rechargeInfo code:10043 userInfo:@{@"B4":@"QC"}];

[Bugly reportError:error];