您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS Crash 日誌符號化:把內存地址還原成代碼行

編輯:iOS 開發綜合

iOS 程序在真機上運行時一旦崩潰,系統會自動生成一份 crash 日誌文件,裡面記錄了程序崩潰前的運行邏輯。學會分析 crash 文件,能有效解決真機上的問題,保證應用的穩定性。

麻煩的是,crash 日誌裡大多數是內存地址和系統消息,直接看不出對應到代碼中的哪一行。要把它還原成可讀的函數名與行號,就需要「符號化」(symbolicate)。

需要準備三樣東西

1. crash 文件

2. symbolicatecrash 工具

3. dSYM 文件與 .app 文件

先在桌面創建一個臨時文件夾,例如名為 crash,後續所有文件都放這裡。

第一步:從設備導出 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

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 與 app 文件

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 中,打開就能看到帶有類名、方法名和具體行號的可讀堆棧。

常見錯誤:DEVELOPER_DIR is not defined

第一次使用 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 對比確認。

把這套流程走通一次之後,後續每次遇到線上崩潰都能在幾分鐘內定位到具體代碼行,排查效率會有質的變化。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved