問題描述

在Xcode中斷點調(diào)試時，鼠標(biāo)停留在變量上，就能看到變量的信息。但對于自定義對象，通常Xcode提供的直接信息非常有限，像這樣

想要了解這個對象具體的內(nèi)容，需要展開左邊的箭頭

當(dāng)開發(fā)者想要知道該對象具體某個成員(很可能也是一個對象，即對象的成員的成員.....)的值時，就不得不反復(fù)展開多個箭頭，平添了不少debug時的焦躁=。=

解決方案

其實LLDB的設(shè)計者并非沒有考慮到這種情況，他們設(shè)計了一種機制，允許在浮動窗口和變量窗口中顯示自定義類型對象的概覽，稱之為summary。

沒錯，就是浮動窗口上***一行顯示的summary，我們再看一次

Summary的原理很簡單，就是保存一個"對象類型->概覽"的映射表，在調(diào)試時查表進(jìn)行顯示。在console中輸入

type summary list 

可以查看當(dāng)前LLDB支持的所有語言/平臺的所有類型的summary，比如OC下的NSArray

type summary list NSArray 

輸出的結(jié)果里，可以找到

和平常使用過程中的情況一致。

LLDB支持為自定義類型添加summary。

解決示例

直觀起見，這里將寫一個簡單的對象并為之添加summary，下面請演員入場

@interface Rectangle : NSObject 
{ 
    NSInteger _width; 
    NSInteger _height; 
} 
 
@property (nonatomic, assign) NSInteger width; 
@property (nonatomic, assign) NSInteger height; 
 
@end 

對于這個矩形類的實例，我希望能夠直接看到它的面積。

Summary可以簡單地設(shè)置對象的概覽為靜態(tài)字符串，也可以設(shè)置為動態(tài)的如正則表達(dá)式，甚至可以設(shè)置為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ā)組的成員共享:)

接下來導(dǎo)入到LLDB中

command script import /Users/XXX/Desktop/TypeSummaryTest/TypeSummaryTest/summarys.py 

P.S:這個命令目測只支持full path，請允許我在這里可恥地匿了=。=

然后將導(dǎo)入的function指定為映射即可

type summary add Rectangle -F summarys.Rectangle_summary 

這時再次查看變量，Summary已經(jīng)有內(nèi)容啦:)

[[117605]]

假如有多個自定義類型的summary，都可以如法炮制。進(jìn)一步地，可以讓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在啟動時自動導(dǎo)入這個文件。在~/下新建一個.lldbinit文件，并在其中寫入command script import來導(dǎo)入summary文件

command script import /Users/XXX/Desktop/TypeSummaryTest/TypeSummaryTest/summarys.py 

.lldbinit這個技巧來自于Facebook的chisel，是一個FB擴展的LLDB命令集

That's all for today, have fun~

[[117606]]

參考資料

LLDB Tutorial

LLDB Data Formatters

Advanced Debugging with LLDB

LLDB Python Reference