相关概念
什么是 dSYM 文件
Xcode编译项目后,我们会看到一个同名的 dSYM 文件,dSYM 是保存 16 进制函数地址映射信息的中转文件,我们调试的 symbols 都会包含在这个文件中,并且每次编译项目的时候都会生成一个新的 dSYM 文件,位于
/Users/<用户名>/Library/Developer/Xcode/Archives
对于每一个发布版本我们都很有必要保存对应的 Archives 文件。
dSYM 文件有什么作用
当我们软件 release 模式打包或上线后,不会像我们在 Xcode 中那样直观的看到用崩溃的错误,这个时候我们就需要分析 crash report 文件了,iOS 设备中会有日志文件保存我们每个应用出错的函数内存地址,通过 Xcode 的 Organizer 可以将 iOS 设备中的 DeviceLog 导出成 crash 文件,这个时候我们就可以通过出错的函数地址去查询 dSYM 文件中程序对应的函数名和文件名。大前提是我们需要有软件版本对应的 dSYM 文件,这也是为什么我们很有必要保存每个发布版本的 Archives 文件了。
如何将文件一一对应
每一个 xx.app 和 xx.app.dSYM 文件都有对应的 UUID,crash 文件也有自己的 UUID,只要这三个文件的 UUID 一致,我们就可以通过他们解析出正确的错误函数信息了。
- 查看 xx.app 文件的 UUID
terminal 中输入命令 :
$ dwarfdump --uuid xx.app/xx
- 查看 xx.app.dSYM 文件的 UUID
$ dwarfdump --uuid xx.app.dSYM
- crash 文件的 UUID
crash 文件内第一行 Incident Identifier 就是该 crash 文件的 UUID。
上述内容原文地址:错误统计iOS :什么是 dSYM 文件和UUID
分析crash报告
以下以友盟为例,分析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
解析的结果为
由此可知,0x100250210 的地址为我自定义的函数 requestRealDetail:success:
的回调,这样一路解析项目的地址,追踪到闪退的问题。
解析工具 umcrashtool
如果你觉得还是很麻烦的话,你也可以使用友盟提供的解析工具umcrashtool , 使用方法。
使用步骤:
1、下载错误报告
2、下载对应的dSYM和 umcrashtool,可将 umcrashtool 和错误报告放到同一个文件夹下
使用终端cd进入到分析工具和csv所在的文件夹目录下后,输入以下命令
$ ./umcrashtool xxx_错误分析_错误详情_110013.csv
如果出现下面的错误,就需要你将之前下载的dSYM文件放到 ~/Library/Developer/Xcode/. 目录下
如下图所示
再次运行 命令
$ ./umcrashtool xxx_错误分析_错误详情_110013.csv
结果
上面依此解析出来16进制地址映射出来的函数方法名,执行顺序一目了然。