iOS 快速註釋工具VVDocumenter-加強版支援Xcode 7

臭碼農發表於2017-12-14

Xcode8更新後,新增option+command+/註釋,外掛被禁止,VVDocumenter暫時無法繼續提供服務,點選跳轉最新的註釋方法。

程式碼註釋的重要性就不多講了,可讀性,可維護性,提高編碼效率……等,一個完美的專案離不開健全的程式碼註釋,在開發中,使用最多的“//”註釋,雖然簡便,但有很大侷限性,請往下看

VVDocumenter第三方Xcode外掛,他為我們提供了 /// 三斜槓快速註釋,可生成好看又好用的註釋,但斜槓註釋也有其不方便之處,在Xcode編輯視窗上方—檢視當前類所有方法,無法看到註釋,看到的只是一片方法名稱,無法快速定位,像這樣:



iOS 快速註釋工具VVDocumenter-加強版支援Xcode 7

這時候 #pragma mark 就派上用場了

#pragma mark ***註釋***  註釋可以幫助你在類中快速定位你要找的程式碼區域

那麼,怎麼快速打出 #pragma mark 呢?據我所知目前Xcode沒有這個快捷鍵,VVDocumenter也沒有提供。

VVDcoumenter-加強版是在VVDcoumenter原有///基礎上增加了自定義的 #pragma mark 註釋,輸入快捷鍵就是 ### 會自動變成 一行#pragma mark 註釋,希望能幫到大家(笑臉),當然,也可以自己修改或者增加其他快捷鍵。

使用方法:

iOS 快速註釋工具VVDocumenter-加強版支援Xcode 7

加完#pragma mark 後的程式碼:


iOS 快速註釋工具VVDocumenter-加強版支援Xcode 7

VVDocumenter-customer下載地址

NOTE:不會用VVDocumenter的同學往下看:

從Xcode 5開始,蘋果要求加入UUID證書從而保證外掛的穩定性。因此Xcode版本更新之後需要在VVDocumenter-Xcode的Info.plist檔案中新增Xcode的UUID。

步驟如下:

一、檢視Xcode的UUID

方式1

在終端執行 defaults read /Applications/Xcode.app/Contents/Info DVTPlugInCompatibilityUUID

拷貝選中的字串。

方式2

在/Applications目錄中找到Xcode.app,右鍵”顯示包內容”,進入Contents資料夾,雙擊Info.plist開啟,找到DVTPlugInCompatibilityUUID,拷貝後面的字串。

二、新增Xcode的UUID到VVDocumenter-Xcode的Info.plist檔案

方式1--外掛已經安裝完成

1、開啟xcode外掛所在的目錄:~/Library/Application Support/Developer/Shared/Xcode/Plug-ins;

2、選擇已經安裝的外掛例如VVDocumenter-Xcode,右鍵”顯示包內容”;

3、找到info.plist 檔案,找到DVTPlugInCompatibilityUUIDs的專案,新增一個Item,Value的值為之前Xcode的UUID,儲存。

iOS 快速註釋工具VVDocumenter-加強版支援Xcode 7

方式2--外掛還未安裝/重新安裝

1、從GitHub克隆倉庫到本地,在Xcode中開啟專案,選擇專案名稱,在TAGETS下選中VVDocumenter-Xcode;

2、選擇Info,找到DVTPlugInCompatibilityUUIDs的專案,新增一個Item,Value的值為之前Xcode的UUID;

3、Build專案,VVDocumenter-Xcode會自動安裝。

三、重啟Xcode

Xcode 6之後,重啟Xcode時會提示“Load bundle”、 “Skip Bundle”,這裡必須選擇“Load bundle”,不然外掛無法使用。

如果不小心點了"Skip Bundle",不要說“我次奧,完蛋了”,去上圖中的plist裡面,刪掉你新新增的那行,重新編譯執行,記得點Load Bundle。

相關文章