KSCrash的基本使用
KSCrash是 iOS 平台最强大的崩溃收集开源库之一。支持多设备的崩溃收集(Mac\iPhone\Apple Watch\TV),最新的好像在支持Android。
KSCrash 能够收集以下类型的异常:
- Mach kernel exceptions
- Fatal signals
- C++ exceptions
- Objective-C exceptions
- Main thread deadlock (experimental)
- Custom crashes (e.g. from scripting languages)
基本使用
支持Hockey、QuincyKit、Victory、Email四种日志发送方式,也可以增加自己的发送接口。Hockey/QuincyKit/Victory几乎用不到,邮件方式或者发送到自己后台才是大多数的选择
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
let installation = makeEmailInstallation()
installation.install()
/* Crash移除策略 KSCDeleteBehavior
* KSCDeleteNever 从不移除
* KSCDeleteOnSucess 发送成功之后移除
* KSCDeleteAlways 总是移除
*/
KSCrash.sharedInstance().deleteBehaviorAfterSendAll = KSCDeleteOnSucess
// 发送成功后的处理
installation.sendAllReports { (reports, completed, error) -> Void in
if(completed) {
print("Sent \(String(describing: reports?.count)) reports")
} else {
print("Failed to send reports: \(String(describing: error))")
}
}
return true
}
- 邮件形式
// 发送邮件
func makeEmailInstallation() -> KSCrashInstallation {
let installation = KSCrashInstallationEmail.sharedInstance()!
installation.recipients = ["YOUR EMAIL"]
installation.subject = "Crash Report"
installation.message = "This is a crash report"
//.gz格式---会对report.crash文件进行压缩,如果不以.gz的格式导出,那么导出的会是乱码
// report.crash可以随便命名
installation.filenameFmt = "report.crash.gz"
/* crash上报类型
* KSCrashEmailReportStyleJSON json类型
* KSCrashEmailReportStyleApple apple类型(Xcode上看到的类型)
*/
installation.reportStyle = KSCrashEmailReportStyleApple
// 弹框提示
installation.addConditionalAlert(withTitle: "Crash Detected",
message: "The app crashed last time it was launched. Send a crash report?",
yesAnswer: "Sure!",
noAnswer: "No thanks")
return installation
}
邮件的发送,是第二次启动的时候发送,无法在crash之后就发送,会存在问题。
- 上传到自己的服务器
// 上传到自己的服务器
func makeStandardInstallation() -> KSCrashInstallation{
let url = URL(string: "http://put.your.url.here")
let standard = KSCrashInstallationStandard.sharedInstance()!
standard.url = url
return standard;
}
3.其他的不常用的形式,可以去Github上查看
4.源码的分析可参考:KSCrash源码分析
虽然KSCrash支持堆栈符号化,但是比较受限。
Symbolicatecrash
symbolicatecrash是Xcode自带的一个分析工具,可以通过崩溃日志和应用的.dSYM文件定位发生崩溃的位置,把crash日志中的一堆地址替换成代码相应位置。
Xcode->Window->Devices and Simulators->真机->View Device Logs看到的crash日志,就是通过symbolicatecrash分析出来的
使用过程:
新建日志文件夹 eg: Crash
终端输入命令
find /Applications/Xcode.app -name symbolicatecrash -type f
获取symbolicatecrash的文件路径,然后通过路径找到symbolicatecrash工具,copy到Crash文件夹-
获取.dSYM文件
2.
1.Xcode->Archive 会将工程打包
3.
4.
5.将.dSYM文件copy到Crash文件夹 将KSCrash获取到的崩溃文件(eg: 邮件形式KSCrashEmailReportStyleApple类型获取的report.crash,我调试时是用这种形式)copy到Crash文件夹
- 终端执行:
cd到Crash文件夹
export DEVELOPER_DIR=/Applications/XCode.app/Contents/Developer
-
./symbolicatecrash ./*.crash ./*.app.dSYM > symbol.crash
解释:-
./*.crash
是当前目录下的.crash
文件,这里指report.crash
,这个不是固定的,可以根据你的崩溃文件来修改(eg: 如果你导出崩溃文件命名为xxx.log
,那这里就应该是./*.log
) -
symbol.crash
是解析后的日志文件,也可以自定义命名
3.
*
是泛指,上面这种一种通用的形式,不用特定指定具体的名字 -
符号化前后对比:
注意:我个人在调试中发现: KSCrash只收集真机下的crash,并且用这种方式符号化崩溃日志,如果是Debug环境下的日志,是解析不了的,所以在Run真机的时候,我改成了Relese环境