-
转载地址: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];