iOS集成Bugly异常上报
腾讯Bugly,为移动开发者提供专业的异常上报和运营统计,帮助开发者快速发现并解决异常,同时掌握产品运营动态,及时跟进用户反馈。
Bugly是一套强大的异常上报SDK,包含异常上报、运营统计、内测分发、热修复等功能,实在是定位、修复生产上bug的必备良品😁。Bugly
-
集成
建议使用CocoaPods集成Bugly,如果不会使用pod建议问一下度娘。
Pods代码:pod 'Bugly'
-
初始化
初始化需要一个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只暴露了三个类就完成异常日志收集工作,是不是心痒痒想自己写一个呢?我劝你还是别撒了,有个这么强大而且免费的SDK,折腾自己干嘛!!!好吧,也不是不能实现,研究一下NSException就会有些收获;细心的你可能发现了一条有用的API:
typedef void NSUncaughtExceptionHandler(NSException *exception);
FOUNDATION_EXPORT NSUncaughtExceptionHandler * _Nullable NSGetUncaughtExceptionHandler(void);
FOUNDATION_EXPORT void NSSetUncaughtExceptionHandler(NSUncaughtExceptionHandler * _Nullable);
看到这里你可能想说,这不是就可以搞了吗?但是NSSetUncaughtExceptionHandler这个函数在信号量出错的情况下是不会回调的,他不能捕获信号量异常,如果你还不想放弃可以看一下这篇博文。
推荐@chenfanfang关于NSException的文章:
iOS被开发者遗忘在角落的NSException-其实它很强大
iOS runtime实用篇--和常见崩溃say good-bye!