本文以閱讀 TQRichTextViewDemo 原始碼為例,示範如何有條理地分析一個 iOS 工程。
1. 先找 AppDelegate。無論工程多複雜,入口只有一個,就是 AppDelegate 的 didFinishLaunchingWithOptions 方法。在這個 Demo 中,該方法僅建立一個 TQViewController 並設為 window 的 rootViewController。
2. 接著看 TQViewController。從初始化方法入手,沒有 initWithNib 就看 viewDidLoad。這裡只建立了一個 TQRichTextView,設定 frame、text、backgroundColor、delegate 等屬性後加到 self.view。由於 viewDidLoad 是系統最後呼叫的方法,可推測文字的解析與繪製被封裝進了 TQRichTextView。
3. 於是進入 TQRichTextView,按以下步驟閱讀:
瀏覽頭檔,了解有哪些屬性與方法;閱讀 initWithFrame,發現只是屬性初始化;尋找是否有覆寫的 setter/getter,發現 setText、setFont、setTextColor、setLineSpacing,且每次更新後都呼叫 setNeedsDisplay,代表對這四個屬性賦值後都會觸發 drawRect。
接著閱讀 drawRect,這是繪製的核心:
drawRect 首先呼叫 analyzeText,傳入 _text 並把結果存到 _textAnalyzed。analyzeText 會先清空陣列與字典,然後:
- 呼叫 TQRichTextEmojiRun 的類方法解析表情字串:若解析到表情,就建立一個 TQRichTextEmojiRun 物件(記錄 range 與 originalText),放入陣列,並把字串中的表情替換為空格後回傳。
- 呼叫 TQRichTextURLRun 的方法解析 URL:找到匹配字串後建立 TQRichTextURLRun 物件(記錄 range 與 originText),加入陣列並回傳字串。
- 遍歷 richTextRunsArray,對每個物件呼叫 setOriginalFont,傳入 self.font。這裡設定的屬性繼承自父類 TQRichTextBaseRun。
- 回傳結果,回到 drawRect 建立 NSAttributedString 並設定屬性。
之後進行文字處理,遍歷 richTextRunsArray,對每個物件呼叫 replaceTextWithAttributedString:
- TQRichTextEmojiRun 此方法在父類 TQRichTextImageRun 中:先刪除佔位空格,建立 CTRunDelegateCallbacks(寬高設為 OriginalFont 高度的 1.1 倍),建立帶 CTRunDelegateRef 的空格 NSAttributedString 插入字串,並在該 range 上以 TQRichTextAttribute 為 key、自己為 value 設定屬性。
- TQRichTextURLRun 此方法:為該段文字加上藍色字體,並呼叫 super 加上同樣的 key-value。
回到 drawRect,之後是繪製準備與繪製。重點是遍歷並取出每個 run,從其 attributes 取出 key 為 TQRichTextAttribute 的值;若存在則為特殊 run,求出其 frame 後呼叫 drawRunWithRect:
- TQRichTextEmojiRun 的 drawRunWithRect 繪製表情圖片並回傳 YES。
- TQRichTextURLRun 與 TQRichTextBaseRun 的 drawRunWithRect 回傳 NO。
接著判斷 run 的 isResponseTouch 屬性(是否響應觸摸),若為是,則在 richTextRunRectDic 加入 rect→run 的鍵值對。最後找到 TQRichTextView 覆寫的 touchesBegan 與 touchesEnded:取得觸摸點並轉換座標,遍歷 richTextRunRectDic 判斷點是否落在某 rect 內,若是則呼叫 delegate 方法。
類別結構:TQRichTextEmojiRun → TQRichTextImageRun → TQRichTextBaseRun;TQRichTextURLRun → TQRichTextBaseRun。兩個子類分別實作 analyzeText:runsArray(解析字串)、replaceTextWithAttributedString(加上屬性)、drawRunWithRect(自訂繪製並回傳是否繪製)。
整體流程:更改 TQRichTextView 屬性 → 呼叫 drawRect → 呼叫 analyzeText 解析字串 → 建立 NSAttributedString → 加上屬性 → 以 CoreText 繪製 → 呼叫 drawRunWithRect 自訂繪製 → 把 run 與 rect 存入字典供點擊判斷。
因此,若要更換表情與文字的解析規則,只需修改 TQRichTextEmojiRun 或 TQRichTextURLRun 的 analyzeText:runsArray、replaceTextWithAttributedString、drawRunWithRect 三個方法;若要實作點擊,只需把 isResponseTouch 設為 YES 並實作 TQRichTextViewDelegate。
閱讀過程中也發現兩個缺陷:一是未實作 awakeFromNib,若用 xib 拖曳則無法套用預設屬性,解法是補上 awakeFromNib 並在其中賦值;二是 sizeWithFont 與 boundingRectWithSize 計算高度時不含行間距,若 lineSpacing 不為 0 會使計算高度偏小,解法是把 lineSpacing 設為 0。