Xcode8更新後,新增option+command+/註釋,外掛被禁止,VVDocumenter暫時無法繼續提供服務,點選跳轉最新的註釋方法。
程式碼註釋的重要性就不多講了,可讀性,可維護性,提高編碼效率……等,一個完美的專案離不開健全的程式碼註釋,在開發中,使用最多的“//”註釋,雖然簡便,但有很大侷限性,請往下看
VVDocumenter第三方Xcode外掛,他為我們提供了 /// 三斜槓快速註釋,可生成好看又好用的註釋,但斜槓註釋也有其不方便之處,在Xcode編輯視窗上方—檢視當前類所有方法,無法看到註釋,看到的只是一片方法名稱,無法快速定位,像這樣:
這時候 #pragma mark 就派上用場了
#pragma mark ***註釋*** 註釋可以幫助你在類中快速定位你要找的程式碼區域
那麼,怎麼快速打出 #pragma mark 呢?據我所知目前Xcode沒有這個快捷鍵,VVDocumenter也沒有提供。
VVDcoumenter-加強版是在VVDcoumenter原有///基礎上增加了自定義的 #pragma mark 註釋,輸入快捷鍵就是 ### 會自動變成 一行#pragma mark 註釋,希望能幫到大家(笑臉),當然,也可以自己修改或者增加其他快捷鍵。
使用方法:
加完#pragma mark 後的程式碼:
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,儲存。
方式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。