您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS Crash 日誌解析完整流程:讓崩潰堆疊還原成可讀的方法名

編輯:iOS 相關資訊

App 在真機上崩潰時,系統會自動產生一份 crash log,記錄崩潰前的執行軌跡。問題是這些檔案多半只顯示記憶體位址與系統訊息,無法直接看出是哪一行程式出錯。透過符號化(symbolication),就能把位址還原成檔名與行號。

一、需要準備的三樣東西

1. crash 檔本身。

2. Xcode 隨附的 symbolicatecrash 工具。

3. 對應版本的 .dSYM 與 .app。這裡最關鍵的一點是:dSYM 必須來自打包該版本的同一台機器、同一次編譯,版本對不上就無法還原。

二、從裝置匯出 crash 檔

把裝置連上 Mac,開啟 Xcode 的 Organizer,切換到 Devices 分頁,在左側清單中選中裝置,右側選擇 View Device Logs。稍候片刻,清單會列出各 App 的崩潰紀錄,依時間排序找到最近的一次,右鍵選擇 Export Log 即可。檔名形如 xxx_2013-08-15-200743_iPad.crash。先在桌面建立一個臨時資料夾(例如 crash),把檔案放進去備用。

三、建立 symbolicatecrash 的捷徑

這個工具藏在 Xcode 內部,路徑很長。先用 find 找出它:

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

接著建立 symlink,之後就能在任意路徑直接呼叫:

sudo ln -s "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash" /usr/local/bin/symbolicatecrash

四、取得 dSYM 與 app

開啟 Organizer 的 Archives 分頁,找到最後一次打包的紀錄,選擇 Distribute 並以「Save for iOS App Store Distribution」之類的方式存成 archive。在 Finder 中對 archive 顯示套件內容,就能看到 xxx.app.dSYM。

app 檔同理:用 Distribute 存成 ipa,把副檔名改成 zip 解壓,即可取得 .app。兩者都放進第一步的臨時資料夾。

五、執行符號化

cd ~/Desktop/crash
symbolicatecrash xxx_2013-08-15-200743_iPad.crash xxx.app.dSYM > crash.txt

完成後打開 crash.txt,原本滿版的位址就會變成可讀的類別與方法名稱。

六、常見錯誤:DEVELOPER_DIR 未定義

第一次執行常會看到:

Error: "DEVELOPER_DIR" is not defined at /usr/local/bin/symbolicatecrash line 53.

解法是明確指定開發者目錄環境變數:

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

想省麻煩,可以把這行寫進 ~/.bash_profile 或 ~/.zshrc。

七、更省事的方式

其實 Xcode 已經內建完整流程:把 crash 檔直接拖進 Organizer 的 Crashes(或 Devices → View Device Logs)視窗,只要該版本對應的 dSYM 已存在於 Spotlight 可搜尋的位置,Xcode 會自動完成符號化並直接顯示帶有行號的堆疊。

若要批次處理,可使用 xcrun atos:

xcrun atos -arch arm64 -o MyApp.app.dSYM/Contents/Resources/DWARF/MyApp -l 0x100000000 0x1000012a4

其中 -o 指向 dSYM 內的 DWARF 檔,-l 是該二進位的載入位址(可在 crash log 的 Binary Images 段落找到),最後一個參數是你要還原的位址。掌握這三個參數,就能自行寫腳本做大量符號化,不必反覆操作圖形介面。

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