解決 crash 是 iOS 開發者的日常,而能否把堆棧還原成可讀的符號,往往就是定位問題的分水界。實務中不少同學恰恰卡在這一步。本文介紹兩條路徑:用 symbolicatecrash 自動解析整個堆棧,以及用 atos 還原單個地址的符號。
symbolicatecrash 是 Xcode 自帶的符號化工具,會自動搜索本地符號表並還原完整堆棧。
先查清當前生效的 Xcode 路徑:
/usr/bin/xcode-select -print-path
正常輸出應為:
/Applications/Xcode.app/Contents/Developer/
若指向了其他位置,重新指定:
sudo /usr/bin/xcode-select --switch /Applications/Xcode.app/Contents/Developer/
以 Xcode 7.3 為例,用 find 定位這個腳本:
find /Applications/Xcode.app -name symbolicatecrash -type f
會返回類似路徑:
/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash
為方便反覆使用,建議做个别名:
alias symbolicatecrash='/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash'
還必須配置好 DEVELOPER_DIR,否則腳本會報錯:
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer/
把 dSYM 與 .app 準備好,存放位置不限,只要 Spotlight 能檢索到即可。然後執行:
symbolicatecrash xxx.crash
符號化結果便會寫回日誌。
第一個要排查的是符號文件與堆棧是否匹配,本質上是比對 UUID:
dwarfdump --uuid MyApp.app/MyApp dwarfdump --uuid xxx.app.dSYM/Contents/Resources/DWARF/MyApp
再把 crash 日誌中 Binary Images 段落裡的 UUID 拿出來對照:
grep "0x.*com.wison.xxx .*<" NoSymbolsTestxxx.crash
如果不一致,說明符號文件與崩潰版本對不上——通常是搞錯了版本,或打包環節有問題導致 dSYM 生成異常。若 UUID 完全一致,symbolicatecrash 理論上應該能正常解析。
仍然失敗的話,問題多半出在 Spotlight 檢索上。Xcode 依賴 mdfind 查找符號文件:
mdfind 'com_apple_xcode_dsym_uuids = *'
這條命令會列出當前環境中所有可被檢索到的符號文件。如果你的 dSYM 不在其中,就說明 mdfind 找不到它。此時的繞過辦法是顯式告訴腳本 dSYM 的位置:
symbolicatecrash xxx.crash xxx.dSYM/Contents/Resources/DWARF/MyApp
若還是不行,把 App 二進制也一併指定:
symbolicatecrash xxx.crash xxx.dSYM/Contents/Resources/DWARF/MyApp MyApp.app/MyApp
有些場景只需要還原一個地址,比如 lr 寄存器裡的值,這時 atos 更合適:
atos -arch [armv7 or arm64] -o [BinaryFile or dSYMFile] -l loadAddress address
各參數含義如下:
-arch 指定二進制的架構,如 armv7、armv7s、arm64。-o 指定符號來源,可以是 dSYM,也可以是含符號表的可執行文件。-l 是加載地址。由於 Xcode 默認開啟 PIE,每次加載地址都不同,因此必須顯式指定,數值可以在 crash 堆棧的 Binary Images 段落中找到。
最後一個參數是待解析的目標地址。