拿到一份 Crash log 卻只看到一堆十六進位位址,是每個 iOS 開發者都遇過的窘境。符號化(symbolication)就是把這些位址還原成檔名與行號的過程。網路上流傳的某些做法已經失效,以下是可以實際跑通的腳本。
整個流程其實只需要對齊兩件事:
dwarfdump --uuid 取得 dSYM 的 UUID。把堆疊位址減去 base address 得到相對位移,再交給 atos 搭配 dSYM 查詢,就能還原成 ClassName method + 行號。
UUID 必須完全一致,符號化才會成功。如果 dSYM 是重新編譯產生的(即使原始碼沒改),UUID 也會不同,那就永遠對不上。這也是為什麼必須保存每個上線版本的 dSYM。
echo "dSYM uuid:" xcrun dwarfdump --uuid $2.app.dSYM/Contents/Resources/DWARF/$2 echo "crashlog uuid:" grep "$2'" armv7 $1 | tr -s " " echo "baseaddress:" grep "$2'" armv7 $1 | tr -d " " | cut -f 1 -d"-" echo "CallStack:" grep "$2" $1 | grep 0x | tr -s " " | \ cut -f 3 -d" " | tr -s "[\n"]" " " | \ xcrun atos -l `grep "$2'" armv7 $1 | tr -d " " | cut -f 1 -d"-"` \ -arch armv7 -o $2.app.dSYM/Contents/Resources/DWARF/$2 2>&1 | tee ./$1.CallStack
用法:./symbolicate.sh CrashLogFile AppName,結果會輸出到同目錄的 .CallStack 檔。
腳本各行的意圖:先印出 dSYM 的 UUID 供人工比對,接著從 log 中抓出對應的 armv7 行取得 UUID 與 base address,最後把堆疊中的位址整理成 atos 能吃的格式,一次還原並存檔。

armv7,若你的 App 已改為純 arm64,必須把腳本中的 armv7 換成 arm64,否則抓不到對應的 log 行。