YDPreventCrash
YDPreventCrash 防崩溃库介绍
YDPreventCrash 主要借鉴了@chenfanfang大神开源的 AvoidCrash。由于AvoidCrash不再维护更新,同时鉴于实际业务开发中所使用的类逐渐增加,因此YDPreventCrash在原AvoidCrash上重新开发。毕竟,一个已经发布到AppStore上的App,最忌讳的就是崩溃问题,相信作为开发者对于所产出项目的崩溃率要求都极为严格,因此YDPreventCrash库就是为此存在。同时,原维护的YDAvoidCrashKit包含的还是太重了,因此拆分出轻量级的YDPreventCrash,同时不再对YDAvoidCrashKit进行更新。
相较于原库,YDPreventCrash新增了以下功能及优化:
- 新增了其他系统类的防崩溃,目前约支持17个系统类(逐步迭代更新);
- 支持回调设置,方便应用上报;
- 新增安全线程及数据操作组件YDSafeThread;
- 新增线程池管理;
- 增加UI刷新防护,防止异步线程刷新UI导致的问题。
安装及使用方式
使用 CocoaPods 导入
pod 'YDPreventCrash'
使用方法
YDPreventCrash 防崩溃库使用
使用时引入头文件:
#import <YDPreventCrash/YDAvoidCrash.h>
随后建议在 AppDelegate 的 didFinishLaunchingWithOptions 方法中的最初始位置添加如下代码,让 YDAvoidCrash 生效,同时可以通过集成YDLogger进行日志收集,效果更加。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 可以配合YDLogger日志库进行日志收集,方便排查问题。当然,这里如果已有日志库的话可以使用自己的日志库
// 日志默认保存10天,可以在开启前通过[[YDLogService sh****ared] clearLogWithDayTime:5]设置
[[YDLogService shared] startLogNeedHook:NO];
// 设置开启的防护的文件前缀,建议可以由服务端配置
[YDAvoidCrash setAvoidCrashEnableMethodPrefixList:@[@"YD", @"NS", @"UI"]];
// 开启防护
[YDAvoidCrash becomeAllEffective];
// 接收日志信息回调
[YDAvoidCrash setupBlock:^(NSException *exception, NSString *defaultToDo, NSDictionary *info) {
// 写入日志
YDLogError(@"%@", info);
}];
return YES;
}
YDLogger 使用
如果想使用 YDLogger 日志收集自定义信息,可使用如下宏:
/**
日志记录宏,只记录到本地,使用方法和NSLog相同,引用当前文件后可直接使用
根据日志level的不同,记录的日志不同
当调用setLogLevel:设置需要记录的日志level为YDLogDebug时,那么YDLogDebug等级以下的等级(含YDLogDebug)都会被记录
默认设置为YDLogDetail
YDLogError() 记录错误信息,适用于线上/线下环境,格式:@"Erro timeStamp error"
YDLogInfo() 记录极简信息,适用于线上/线下环境,格式:@"Info timeStamp info"
YDLogDetail() 记录详细信息,适用于线上/线下环境,格式:@"Deta timeStamp [thread] func str"
YDLogDebug() 记录开发信息,适用于Debug环境,格式:@"Dbug timeStamp str"
YDLogVerbose() 记录复杂信息,适用于Debug环境,格式:@"Verb timeStamp [thread] func in file:line desc"
详细使用可参考具体宏定义
*/
同时,为了方便快速查看日志,可以用 YDLogger 自带的 YDLoggerUI。
YDLogListViewController *vc = [[YDLogListViewController alloc] init];
[self.navigationController pushViewController:vc animated:YES];
更新
v0.2.1
- 修复setframe子线程设置防护不生效
- 优化exchangeClassMethod交换方法
v0.2.0
- 完成 YDPreventCrash 防崩溃库。
写在最后的话
一个人的精力是有限的,如果你发现了哪些常用的 Foundation 中的方法存在潜在崩溃的危险,而这个框架中没有进行处理,希望你能 issue,我将添加到 YDPreventCrash 中,同时在使用过程中发现BUG或者有更好的解决方法也同样欢迎你能 issue,我将万分感谢!