平時很少寫文章,但這次感覺有必要記錄一下。原因有兩點:
所以我把整個過程完整記錄下來——你可以把它當作一次 iOS Instruments 的逆向探秘。
最近在做 iOS 性能測試,需要監控一段時間內 App 的 CPU 佔用與網絡流量。遺憾的是,Instruments 自帶的 Activity Monitor 和 Network 模板並不能滿足需求:Activity Monitor 只給出 CPU 的瞬時值,Network 也只提供總流量,兩者都不輸出可採集的樣本序列。
由於 iOS 閉源、公開資料又少,能走的方案屈指可數:
前兩個方案都有硬傷,於是選了方案三。
老實說,一開始我也不確定 trace 文件裡到底有沒有樣本數據。但 Instruments 能通過 trace 文件還原出完整的監控柱狀圖,這給了我繼續走下去的信心。

從 trace 文件中提取樣本值,思路有兩個方向:
運氣不錯,同事發現了一個叫 TraceUtility 的開源工具,專門用來提取 Time Profiler 的樣本值(看來作者當初也遇到了同樣的困擾)。它的 Readme 提供了兩條關鍵線索:
/Applications/Xcode.app/Contents/Applications/Instruments.app/Contents/Frameworks 下的/Applications/Xcode.app/Contents/Applications/Instruments.app/Contents/PlugIns。整個項目只有兩個文件:

遺憾的是,TraceUtility 只針對 Time Profiler,無法滿足我獲取 CPU 與網絡流量樣本的需求。我要解決的問題變成兩個:
方法很簡單:在 loadDocument 之後下斷點,直接 debug 變量 trace._baseInstruments。


對比兩張圖不難看出命名規律:XRSamplerInstrument => XRSamplerRun,那麼 XRActivityInstrument => XRActivityRun、XRNetworkingInstrument => XRNetworkingRun?
在 GitHub 上的 class-dump-o-tron 項目裡,我搜到了 XRSamplerRun.h;但 ActivityPlugin.xrplugin 下並沒有 XRActivityRun.h,而是 XRActivityInstrumentRun.h(蘋果的命名兼容性真是堪憂);在 XRNetworkingPlugIn.xrplugin 下則找到了 XRNetworkingRun.h。
(1)CPU 樣本
debug 變量 run._data,樣本數據果然就在裡面。

TraceUtility 是靠私有 API 拿數據的,但我在 XRActivityInstrumentRun.h 中沒找到對應接口。既然拿不到頭文件聲明,那就直接用 runtime 反射調用吧。

至此,CPU 樣本數據獲取完成。
(2)網絡流量樣本

XRNetworkRun 與 XRActivityInstrumentRun 的屬性結構並不相同,它沒有 _data,但 _saveActivityQueries 裡有一段 SQL 語句,初步判斷這傢伙用了 local database,只是具體類型還不明顯。另外猜測 _saveInstrumentUUID 應該就是數據庫文件。
於是 cat 2A183EAD-5B9C-45DD-B2BA-D63DCD1165D4 試了一下——很多文件會在頭部寫入類型標識:

果然捕獲到一個 SQLite 文件。接下來就是分析表結構了,這部分沒什麼難度,不再贅述。至此,網絡流量樣本數據獲取完成。
整條路徑可以濃縮為:確認 Instruments 的 Run 對象 → 通過 debug 觀察內部數據結構 → 用 runtime 反射或直讀 SQLite 提取樣本。這套思路的好處是完全不改變被測 App,也不依賴越獄環境,適合做長期性能監控。當然,由於依賴私有 API 與未公開的存儲格式,它對 Xcode 版本比較敏感,升級後需要重新驗證。