KSCrash+Symbolicatecrash日志分析

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
    }

1. 邮件形式

    // 发送邮件
    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之后就发送，会存在问题。

2. 上传到自己的服务器

    // 上传到自己的服务器
    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文件
  1.Xcode->Archive 会将工程打包
  

  2.
  

  Archives
  
  3.
  

  .xcarhive
  
  
  4.
  

  .dSYM
  
  5.将.dSYM文件copy到Crash文件夹

• 将KSCrash获取到的崩溃文件（eg: 邮件形式KSCrashEmailReportStyleApple类型获取的report.crash，我调试时是用这种形式）copy到Crash文件夹

Crash文件夹下的内容：

Crash

• 终端执行：

  1. cd到Crash文件夹

  2. export DEVELOPER_DIR=/Applications/XCode.app/Contents/Developer

  3. ./symbolicatecrash ./*.crash ./*.app.dSYM > symbol.crash
     解释：

     1. ./*.crash是当前目录下的.crash文件，这里指report.crash，这个不是固定的，可以根据你的崩溃文件来修改（eg: 如果你导出崩溃文件命名为xxx.log,那这里就应该是./*.log）
     2. symbol.crash是解析后的日志文件，也可以自定义命名

     3.*是泛指，上面这种一种通用的形式，不用特定指定具体的名字

符号化前后对比：

符号化前

符号化后

注意:我个人在调试中发现: KSCrash只收集真机下的crash，并且用这种方式符号化崩溃日志，如果是Debug环境下的日志，是解析不了的，所以在Run真机的时候，我改成了Relese环境