拿到一份只有記憶體位址的 crash log,等於拿到一本無字天書。本文說明為什麼會出現這種情況,以及怎麼把符號還原回函式名稱。
這個腳本的位置隨 Xcode 版本而異。Xcode 4.3 之後放在:
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/
更早的版本則在:
/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash
在 Xcode 的 Window → Organizer → Device Logs 裡可以看到已連接裝置的崩潰紀錄。要注意的是,裝置上的 crash 檔只能同步一次——一旦某台 Mac 讀取過 Device Logs,這些檔案就都搬到那台機器上了。
而當你打開日誌,會發現有些堆疊帶著清楚的函式名稱,有些卻只剩一串位址:
Thread 0 Crashed: 0 libobjc.A.dylib 0x300c87ec 0x300bb000 + 55276 1 MobileLines 0x00006434 0x1000 + 21556 2 MobileLines 0x000064c2 0x1000 + 21698 3 UIKit 0x30a740ac 0x30a54000 + 131244 ...
這裡牽涉到編譯產出的兩個檔案:MyApp.app 與 MyApp.app.dSYM。dSYM 保存了除錯符號,是把位址翻回函式名的字典。
如果崩潰程式剛好由這台 Mac 編譯,且 build 目錄下還留著對應版本的 .app 與 .dSYM,Organizer 就能自動完成符號化。反之,若那份 dSYM 已被後續編譯覆蓋或刪除,日誌裡就只剩光禿禿的位址了。
這也是為什麼對外發布的每一個版本,都必須把 .app 與 .dSYM 一併保存。用同一份原始碼重新編譯,產出的 dSYM 並不等於當初那一個,是無法用來還原舊日誌的。
只要 .app 與 .dSYM 還在,就能靠這個腳本把函式名找回來。
步驟一,開一個乾淨的工作目錄:
$ mkdir /crash
步驟二,把工具複製過去(framework 目錄在 Finder 裡進不去,得用命令列):
$ cp /Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash /crash
步驟三,把對應版本的 MyApp.app、MyApp.app.dSYM,以及待解析的 crash 檔全部放進 /crash。
步驟四,執行解析並導出結果:
$ ./symbolicatecrash MyApp_2011-xxx-iPad.crash MyApp.app.dSYM > MyApp_symbol.crash
成功後,原本只剩位址的堆疊會變成這樣:
Thread 0 Crashed: 0 libobjc.A.dylib 0x300c87ec objc_msgSend + 20 1 MobileLines 0x00006434 -[BoardView setSelectedPiece:] (BoardView.m:321) 2 MobileLines 0x000064c2 -[BoardView touchesBegan:withEvent:] (BoardView.m:349) 3 UIKit 0x30a740ac -[UIWindow sendEvent:] + 264 ...
如果解析後仍是位址,通常代表提供的 .app/.dSYM 與產生這份日誌的版本不一致,請重新確認版本對應關係。
有時候你只想知道某一個位址落在哪一行,不必解析整份日誌。先找出崩潰線程與程式自身的那一格:
Thread 0 Crashed: 0 libobjc.A.dylib 0x00003ec0 objc_msgSend + 24 1 MyApp 0x000036d2 0x1000 + 9938
其中的 0x000036d2 就是應用內部的位址。接著到 build 目錄(確認 MyApp.app.dSYM 存在),執行:
dwarfdump --lookup 0x000036d2 --arch armv6 MyApp.app.dSYM
輸出會直接告訴你對應的檔案與行號。

與其事後補救,不如在流程上就把 dSYM 歸檔:每次送審或交付前,把該次編譯的 .app 與 .dSYM 依版本號打包留存。這件事花不了幾分鐘,卻能決定線上崩潰到底能不能被查清楚。此外,越新的 Xcode 越傾向自動處理符號化,但遇到使用者從 Xcode Organizer 或第三方服務回報的日誌時,手動跑一次 symbolicatecrash 依然是最可靠的作法。