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

iOS Crash 日誌符號化:用 atos 與 dSYM 還原呼叫堆疊

編輯:iOS 開發綜合

拿到一份 Crash log 卻只看到一堆十六進位位址,是每個 iOS 開發者都遇過的窘境。符號化(symbolication)就是把這些位址還原成檔名與行號的過程。網路上流傳的某些做法已經失效,以下是可以實際跑通的腳本。

符號化的原理

整個流程其實只需要對齊兩件事:

  1. 用 dwarfdump --uuid 取得 dSYM 的 UUID。
  2. 從 crash log 中取出同一個 UUID 對應的載入位址(base address)與呼叫堆疊位址。

把堆疊位址減去 base address 得到相對位移,再交給 atos 搭配 dSYM 查詢,就能還原成 ClassName method + 行號。

UUID 必須完全一致,符號化才會成功。如果 dSYM 是重新編譯產生的(即使原始碼沒改),UUID 也會不同,那就永遠對不上。這也是為什麼必須保存每個上線版本的 dSYM。

腳本(在 Mac 上執行)

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 能吃的格式,一次還原並存檔。

操作步驟

幾點實務提醒

  • arch 要對。腳本寫死 armv7,若你的 App 已改為純 arm64,必須把腳本中的 armv7 換成 arm64,否則抓不到對應的 log 行。
  • dSYM 要留好。上傳到 App Store 時勾選「Include app symbols for your app to receive symbolicated reports from Apple」,Apple 會幫你符號化;同時也該在 CI 中自動保存每個 build 的 dSYM。
  • Xcode 有內建流程。把 .crash 檔直接拖進 Xcode Organizer 的 Crashes 分頁,它會自動比對 dSYM 完成符號化,通常比手動跑腳本省事。腳本的價值在於可自動化與批次處理。
  • 記得也要符號化系統框架的堆疊。只還原自己的程式碼,往往看不出真正的崩潰原因。

參考資料

  • https://iostechblog.wordpress.com/2013/08/28/symbolicating-crash-logs/
  • https://juliusparishy.com/symbolicating-ios-8-crash-logs/
  • https://wufawei.com/2014/03/symbolicating-ios-crash-logs/
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved