Xcode斷點調試之變量概覽 - summary
問題描述
在Xcode中斷點調試時，鼠標停留在變量上，就能看到變量的信息。但對于自定義對象，通常Xcode提供的直接信息非常有限，像這樣
想要了解這個對象具體的內容，需要展開左邊的箭頭
當開發(fā)者想要知道該對象具體某個成員(很可能也是一個對象，即對象的成員的成員.....)的值時，就不得不反復展開多個箭頭，平添了不少debug時的焦躁=。=
解決方案
其實LLDB的設計者并非沒有考慮到這種情況，他們設計了一種機制，允許在浮動窗口和變量窗口中顯示自定義類型對象的概覽，稱之為summary。
沒錯，就是浮動窗口上***一行顯示的summary，我們再看一次
Summary的原理很簡單，就是保存一個"對象類型->概覽"的映射表，在調試時查表進行顯示。在console中輸入
- type summary list
可以查看當前LLDB支持的所有語言/平臺的所有類型的summary，比如OC下的NSArray
- type summary list NSArray
輸出的結果里，可以找到
和平常使用過程中的情況一致。
LLDB支持為自定義類型添加summary。
解決示例
直觀起見，這里將寫一個簡單的對象并為之添加summary，下面請演員入場
- @interface Rectangle : NSObject
- {
- NSInteger _width;
- NSInteger _height;
- }
- @property (nonatomic, assign) NSInteger width;
- @property (nonatomic, assign) NSInteger height;
- @end
對于這個矩形類的實例，我希望能夠直接看到它的面積。
Summary可以簡單地設置對象的概覽為靜態(tài)字符串，也可以設置為動態(tài)的如正則表達式，甚至可以設置為Python function(事實上LLDB就是使用了Python作為映射的)。
在這里，嗯。。。。。Python，就決定是你啦!
方便起見不直接在console里寫入，而是把function單獨放在一個文件里
- def Rectangle_summary (valobj,internal_dict):
- height_val = valobj.GetChildMemberWithName('_height')
- width_val = valobj.GetChildMemberWithName('_width')
- height = height_val.GetValueAsUnsigned(0)
- width = width_val.GetValueAsUnsigned(0)
- area = height*width
- return 'Area: ' + str(area)
保存成summarys.py
保存起來而不是直接在console里寫，將來就可以方便地添加其他自定義類型的summary，也可以將這個文件和開發(fā)組的成員共享:)
接下來導入到LLDB中
- command script import /Users/XXX/Desktop/TypeSummaryTest/TypeSummaryTest/summarys.py
P.S:這個命令目測只支持full path，請允許我在這里可恥地匿了=。=
然后將導入的function指定為映射即可
- type summary add Rectangle -F summarys.Rectangle_summary
這時再次查看變量，Summary已經有內容啦:)
假如有多個自定義類型的summary，都可以如法炮制。進一步地，可以讓Xcode自動加載summary。首先，把加載function這步也寫入腳本
- import lldb
- def Rectangle_summary (valobj,internal_dict):
- height_val = valobj.GetChildMemberWithName('_height')
- width_val = valobj.GetChildMemberWithName('_width')
- height = height_val.GetValueAsUnsigned(0)
- width = width_val.GetValueAsUnsigned(0)
- area = height*width
- return 'Area: ' + str(area)
- def __lldb_init_module(debugger, dict):
- debugger.HandleCommand('type summary add Rectangle -F summarys.Rectangle_summary')
然后，讓Xcode在啟動時自動導入這個文件。在~/下新建一個.lldbinit文件，并在其中寫入command script import來導入summary文件
- command script import /Users/XXX/Desktop/TypeSummaryTest/TypeSummaryTest/summarys.py
.lldbinit這個技巧來自于Facebook的chisel，是一個FB擴展的LLDB命令集
That's all for today, have fun~
參考資料
