解析 crash 堆栈

本文介绍了如何解析 iOS 的 crash 堆栈,分别使用了 symbolicatecrash 来自动解析整个堆栈,以及使用 atos 来解析单个地址的符号。
在 iOS 开发中,解决 crash 问题是比较常见的工作。其中能够解析出符号当然是定位问题的开始。
实际工作中,也有看到很多人其实会卡在解析符号这里,遇到这种情况,可以按照本文中的做法解决。

使用 symbolicatecrash 解析堆栈

symbolicatecrash 是 Xcode 自带的 crash 符号解析工具,可以自动搜索本地符号表,解析整个 crash 堆栈。

确认 Xcode 环境

首先,需要确认 Xcode 的环境,执行以下代码,获取当前 Xcode 的目录。

1
/usr/bin/xcode-select -print-path

结果应该是:

1
/Applications/Xcode.app/Contents/Developer/

如果结果不是上述的路径,则指定一下路径:

1
sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer/

准备好解析堆栈符号的工具:symbolicatecrash

需要先找到 symbolicatecrash 所在的路径,以 Xcode 7.3 版本为例,执行:

1
find /Applications/Xcode.app -name symbolicatecrash -type f

将会返回:

1
/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash

可以做一个快捷方式:

1
alias symbolicatecrash='/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash'

需要先配置好 DEVELOPER_DIR,否则会报错。如下:

1
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer/

开始解析

准备好 dSYM 文件和 app 文件,可以存放在任何位置,只要 mac 系统的 spotlight 能够找到就行。
接着执行

1
symbolicatecrash xxx.crash

就可以解析符号了。

找不到符号的解决方法

首先,需要确认一下符号表是不是正确的。可以通过以下方式看看符号文件和堆栈是否是对应的 (判断 uuid 是否相同):

1
2
3
dwarfdump --uuid MyApp.app/MyApp
dwarfdump --uuid xxx.app.dSYM/Contents/Resources/DWARF/Resources/MyApp
grep "0x.*com.wison.xxx .*<" NoSymbolsTestxxx.crash

如果不一样,那么说明崩溃堆栈和符号文件对应不上,很可能是搞错版本,或者打包的时候有问题导致符号文件生成不正确。
如果输出一样的 uuid,那么就是对应的,此时 symbolicatecrash 应该可以正常解析符号。
如果还是不能正确解析,那么很可能是 mdfind 自动查找的问题。
Xcode 找符号文件的时候,是通过 mdfind 来找的,比如:

1
mdfind 'com_apple_xcode_dsym_uuids = *'

该命令会把当前环境下的所有符号文件找出来。
如果你的符号文件不在此列表中,说明 mdfind 找不到我们的符号,

那么就在执行 symbolicatecrash 的时候显式指定dSYM文件的路径:

1
symbolicatecrash xxx.crash xxx.dSYM/Contents/Resources/DWARF/MyApp

如果还是不能解析,试一试把 App 文件也指定:

1
symbolicatecrash xxx.crash xxx.dSYM/Contents/Resources/DWARF/MyApp MyApp.app/MyApp

使用 atos 解析单个符号

有时候我们需要解析单个地址的符号,比如 lr 寄存器的地址对应的符号,就需要用到 atos
用法如下:

1
atos  -arch [armv7 or arm64] -o [BinaryFile or dSYMFile] -l loadAddress address

其中
-arch 指定二进制的架构,比如 armv7,armv7s,arm64 等等。
-o 指定符号文件,可以是 dSYM 文件,也可以是包含了符号表的可执行文件。
-l 是加载地址,由于 Xcode 默认打开 PIE 选项,所以加载地址每次都不一样,所以需要指定,可以在 crash 堆栈的 Binary Image 那段看到应用的加载地址。
最后一个参数是需要解析符号的地址。