iOS crash报告分析

相关概念

什么是 dSYM 文件

Xcode编译项目后,我们会看到一个同名的 dSYM 文件,dSYM 是保存 16 进制函数地址映射信息的中转文件,我们调试的 symbols 都会包含在这个文件中,并且每次编译项目的时候都会生成一个新的 dSYM 文件,位于 /Users/<用户名>/Library/Developer/Xcode/Archives 目录下,对于每一个发布版本我们都很有必要保存对应的 Archives 文件 ( AUTOMATICALLY SAVE THE DSYM FILES 这篇文章介绍了通过脚本每次编译后都自动保存 dSYM 文件)。

dSYM 文件有什么作用

当我们软件 release 模式打包或上线后,不会像我们在 Xcode 中那样直观的看到用崩溃的错误,这个时候我们就需要分析 crash report 文件了,iOS 设备中会有日志文件保存我们每个应用出错的函数内存地址,通过 Xcode 的 Organizer 可以将 iOS 设备中的 DeviceLog 导出成 crash 文件,这个时候我们就可以通过出错的函数地址去查询 dSYM 文件中程序对应的函数名和文件名。大前提是我们需要有软件版本对应的 dSYM 文件,这也是为什么我们很有必要保存每个发布版本的 Archives 文件了。

如何将文件一一对应

每一个 xx.app 和 xx.app.dSYM 文件都有对应的 UUID,crash 文件也有自己的 UUID,只要这三个文件的 UUID 一致,我们就可以通过他们解析出正确的错误函数信息了。

1.查看 xx.app 文件的 UUID,terminal 中输入命令 :

dwarfdump –uuid xx.app/xx (xx代表你的项目名)

2.查看 xx.app.dSYM 文件的 UUID ,在 terminal 中输入命令:

dwarfdump –uuid xx.app.dSYM

3.crash 文件内第一行 Incident Identifier 就是该 crash 文件的 UUID。

上述内容原文地址:错误统计iOS :什么是 dSYM 文件和UUID


以下以友盟为例,分析crash报告

iOS crash报告分析

上图就是一份crash报告,第一个红框提示我们是数组越界了,但是是哪里到文件,哪个数组越界了上面并没有显示,而且错误的地方都是16进制地址,我们根本看不懂,怎么办呢?
前面提到 dSYM 文件 ,该文件是一份地址映射信息的中转文件,我们现在要通过这个文件拿到映射后的函数方法等,定位到出错到地方

⚠️注意

每一个 xx.app 和 xx.app.dSYM 文件都有对应的 UUID,crash 文件也有自己的 UUID,只要这三个文件的 UUID 一致,才可以通过他们解析出正确的错误函数信息

dSYM在哪里?

Xcode Window->Organizer->Archives->crash对应版本->show in find ->显示包内容->xx.app.dSYM

解析地址

下载xx.app.dSYM文件后双击(默认终端打开)

输入

cd Contents/Resources/DWARF

进入DWARF文件夹下

输入

atos -arch CPUType -o appName address

例如上图是CPUType为 arm64 项目名为GuDaShi,随便取项目的一个地址0x100250210

atos -arch arm64 -o GuDaShi 0x100250210

解析的结果为

iOS crash报告分析

由此可知,0x100250210的地址为我自定义的函数requestRealDetail:success:的回调,这样一路解析项目的地址,追踪到闪退的问题


如果你觉得还是很麻烦的话,你也可以使用友盟提供的解析工具umcrashtool使用方法

使用步骤:

1、下载错误报告

iOS crash报告分析

2、下载对应的dSYM和umcrashtool,可将umcrashtool和错误报告放到同一个文件夹下

使用终端cd进入到分析工具和csv所在的文件夹目录下

输入以下命令

./umcrashtool xxx_错误分析_错误详情_110013.csv

如果出现下面的错误,就需要你将之前下载的dSYM文件放到 ~/Library/Developer/Xcode/. 目录下

iOS crash报告分析

如下图所示

iOS crash报告分析

再次运行 命令

./umcrashtool xxx_错误分析_错误详情_110013.csv

结果

iOS crash报告分析

上面依此解析出来16进制地址映射出来的函数方法名,执行顺序一目了然