iOS 程序在真機上運行時一旦崩潰,系統會自動生成一份 crash 日誌文件,裡面記錄了程序崩潰前的運行邏輯。學會分析 crash 文件,能有效解決真機上的問題,保證應用的穩定性。
麻煩的是,crash 日誌裡大多數是內存地址和系統消息,直接看不出對應到代碼中的哪一行。要把它還原成可讀的函數名與行號,就需要「符號化」(symbolicate)。
1. crash 文件
2. symbolicatecrash 工具
3. dSYM 文件與 .app 文件
先在桌面創建一個臨時文件夾,例如名為 crash,後續所有文件都放這裡。
最簡單直接的辦法是:把設備連接到 Mac,打開 Xcode 的 Organizer(較新版本在 Window → Devices and Simulators),頂部切換到 Devices,左側列表中會顯示當前連接的設備信息。
選中設備後找到 View Device Logs / Device Logs,稍等片刻,中間列表會出現大量崩潰記錄。按時間排序找到最近一次 crash,右鍵選擇 Export Log 導出,文件名會自動保存為 .crash 或 .ips 形式,例如:
xxx_2013-08-15-200743_iPad.crash
把這個文件拷入第一步創建的臨時文件夾備用。
symbolicatecrash 是 Xcode 自帶的工具。為了方便在任意路徑下調用,可以給它做一個軟鏈接。
先在終端中查找它的真實位置:
find /Applications/Xcode.app -name symbolicatecrash -type f
一般會返回類似如下路徑:
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash
接著建立軟鏈接到系統路徑:
sudo ln -s "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash" /usr/local/bin/symbolicatecrash
不同 Xcode 版本的路徑可能略有差異,以 find 命令的實際輸出為準。
dSYM 文件存在於最後打包的那臺機器上。打開 Xcode 的 Organizer,切換到 Archives,找到對應的發包記錄,選擇 Distribute 並保存為相應的 archive 文件,右鍵 Show Package Contents,裡面就有我們需要的 .dSYM 文件。
這裡有一個至關重要的前提:dSYM 必須來自與用戶設備上安裝的那個 ipa 完全相同的構建。哪怕只改了一行代碼重新打包,符號化也會失敗或得到錯誤的行號。實務中建議在打包腳本裡自動歸檔 dSYM 並與版本號、commit 關聯保存。
app 文件用同樣的方法:Distribute 保存為 ipa,把文件擴展名改為 zip,解壓後即可得到 .app。把這兩個文件都拷入第一步創建的臨時文件夾。
在終端中進入臨時文件夾,執行:
symbolicatecrash xxx_2013-08-15-200743_iPad.crash xxxx.app.dSYM > crash.txt
分析結果會被輸出到 crash.txt 中,打開就能看到帶有類名、方法名和具體行號的可讀堆棧。
第一次使用 symbolicatecrash 時,通常會遇到這樣的報錯:
Error: "DEVELOPER_DIR" is not defined at /usr/local/bin/symbolicatecrash line 53.
解法是顯式指定 Xcode 的開發者目錄環境變量:
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
若想永久生效,把這行寫進 ~/.bash_profile 或 ~/.zshrc。
如果符號化成功但堆棧裡仍是一片十六進制地址,通常是以下幾種原因:
· dSYM 與 crash 不是同一次構建的產物;
· 打包時關閉了調試符號(需在 Build Settings 中確認 Debug Information Format 為 dwarf with dSYM File);
· 二進制在打包前經歷過 strip,導致符號缺失;
· crash 中記錄的 UUID 與 dSYM 的 UUID 不匹配,可以用 dwarfdump --uuid xxx.app.dSYM 對比確認。
把這套流程走通一次之後,後續每次遇到線上崩潰都能在幾分鐘內定位到具體代碼行,排查效率會有質的變化。