iOS Xcode插件(Xcode8) 編寫一個(gè)插件自動(dòng)為屬性生成getter方法.
編寫這個(gè)插件的原因
最近項(xiàng)目比較忙. 新項(xiàng)目時(shí)間催的很緊. 用產(chǎn)品的話來講, 這個(gè)新項(xiàng)目就是把四個(gè)app合并成一個(gè).o(╯□╰)o
大多數(shù)的界面比較復(fù)雜, 控件位置經(jīng)常變化. 在不同屏幕上尺寸都不一樣, 還要求動(dòng)畫效果絢一點(diǎn)... 思來想去, 界面部分還是使用少量的storyboard配合大量的代碼來實(shí)現(xiàn).
控件太多控制器中就會(huì)有大量的類似于 [[UIView alloc] init] view.backgroundColor = [UIColor whiteColor]; 這樣的垃圾代碼.
這些代碼在調(diào)試的時(shí)候大多沒什么用. bug一般不會(huì)出現(xiàn)在這種代碼里.
對(duì)于這樣的代碼我一般會(huì)復(fù)寫這個(gè)屬性的get方法. 將這個(gè)UI控件的顏色, 字體, 這樣的代碼放進(jìn)getter里面.(懶加載...)(雖然它叫懶加載, 但是我一般在viewDidLoad中將所有控件addSubViews到父view上. 其實(shí)并沒有起到"懶"的作用.) 但是這樣可以將代碼分塊. 讓這個(gè)控制器類看起來非常清爽.
我在連續(xù)寫了幾十個(gè)getter之后, 實(shí)在是受不了了. 這樣的重復(fù), 垃圾, 沒營養(yǎng)的代碼應(yīng)該自動(dòng)生成!!!
想起來以前使用Eclipse的時(shí)候, Eclipse能夠自動(dòng)生成屬性的set和get的代碼.
我問了問同事們有沒有見過這樣的Xcode插件.他們表示似乎沒有.
而且升級(jí)Xcode8之后以前的插件都不能用了.但是蘋果提供了官方的編寫Xcode插件的方法.它叫做<h4>Xcode Source Editor Extension</h4>
Xcode Source Editor Extension
先說說Xcode8中如何編寫插件吧.
1.打開Xcode8.
2.創(chuàng)建一個(gè)macOS Application(mac系統(tǒng)桌面應(yīng)用程序)
3.創(chuàng)建一個(gè)Target
4.創(chuàng)建Xcode Source Editor Extension
5.這樣工程就創(chuàng)建好了. 接下來, 編碼.
我們主要在紅圈中的類中工作.
SourceEditorExtension.h/.m ->> 這個(gè)類可以類比于iOS中的AppDelegate.其實(shí)就是一些生命周期的回調(diào)方法.
SourceEditorCommand.h/./m ->> 這個(gè)類中默認(rèn)有下面這一個(gè)方法.
- (void)performCommandWithInvocation:(XCSourceEditorCommandInvocation *)invocation completionHandler:(void (^)(NSError * _Nullable nilOrError))completionHandler
{
// Implement your command here, invoking the completion handler when done. Pass it nil on success, and an NSError on failure.
completionHandler(nil);
}
這個(gè)方法就是點(diǎn)擊你編寫的Xcode插件的按鈕之后會(huì)執(zhí)行的方法.
恩....這里插入一點(diǎn). Xcode插件編寫好了之后其實(shí)就是在Xcode-->>Editor這個(gè)菜單中多了一行. 點(diǎn)擊你編寫的按鈕, 上面的方法就會(huì)被調(diào)用.
只有一個(gè)方法, 兩個(gè)參數(shù), 很清爽, 很簡單. 但是也意味著我們能做的操作并不多.
重點(diǎn)就是對(duì)invocation 對(duì)象做操作. 這個(gè)對(duì)象中包含了當(dāng)前文檔編輯器中的所有內(nèi)容.
通過這個(gè)對(duì)象, 你能過拿到當(dāng)前打開的編輯器中的所有代碼(文本), 包括每行代碼所在的行數(shù)等等. 更多信息可以調(diào)試的時(shí)候打印這個(gè)對(duì)象查看.
修改invocation 對(duì)象之后調(diào)用completionHander(nil); 表示插件內(nèi)容執(zhí)行完畢.
6.運(yùn)行編寫好的插件.
選擇插件所在的target. 運(yùn)行.
在這個(gè)黑色的Xcode中打開一個(gè) 代碼文件例如ViewController.m文件 此時(shí)點(diǎn)擊Editor菜單就能看到我們編寫的插件的按鈕. 按鈕的文字可以通過修改info.plist文件修改.
存在的坑及解決方案.
如果一切都像上面的一樣順利. 那么恭喜你運(yùn)氣太好了, 應(yīng)該去買彩票慶祝一下.
Xcode插件功能還不完善, 不穩(wěn)定. 但是已經(jīng)能湊合用了.
我在編寫過程中遇到的問題和解決方案列舉在這里, 希望能給你一些幫助.
- 1.在灰色的Xcode里面Editor菜單中沒有出現(xiàn)新的選項(xiàng).
請(qǐng)檢查插件是否運(yùn)行起來了.(點(diǎn)的過快有可能有問題, 請(qǐng)慢一點(diǎn)操作).
出現(xiàn)下面的界面表示插件運(yùn)行成功.
如果一直沒有出現(xiàn)上圖, 并且提示W(wǎng)aiting to Attach字樣.
請(qǐng)?jiān)诿钚兄休斎?sudo /usr/libexec/xpccachectl
重啟電腦再做嘗試.
如果還是不行, 請(qǐng)google吧. 過了這么多天, google可能能夠找到新的帖子解決這個(gè)問題.
2.運(yùn)行出現(xiàn)灰黑色的Xcode的時(shí)候Editor菜單中有我們編寫的內(nèi)容. 但是停止調(diào)試之后我們編寫好的內(nèi)容就消失了...
這是個(gè)令人沮喪的情況. WWDC中蘋果表示新的Xcode插件未來可以提交到Mac App Store中. 使用Mac App Store 開發(fā)人員可以共享插件, 但是現(xiàn)在我并沒有找到將插件發(fā)布出去的方法.
也就是, 我現(xiàn)在沒有找到方法將插件編譯打包. 分享給別人.
如果有人找到打包插件的方法, 請(qǐng)一定告訴我.謝謝.3.我們開發(fā)的Xcode插件崩潰會(huì)不會(huì)對(duì)Xcode產(chǎn)生影響?
答曰: 不會(huì)產(chǎn)生影響, 插件運(yùn)行在一個(gè)單獨(dú)的線程, 崩潰不會(huì)影響Xcode.
再次啟動(dòng)Xcode, 插件又會(huì)被重新啟動(dòng).
為屬性生成getter方法的代碼.
其實(shí)這個(gè)才是重點(diǎn)!
我用了大概3個(gè)小時(shí)寫了150行代碼, 為文件中的@property屬性生成簡單的getter方法.代碼很簡陋, 但是對(duì)我來所湊合夠用了.
https://github.com/ddyd369/CreateGetterMethod.git
我僅僅編寫了最基本的功能. 注釋, block, IBOutLet不會(huì)被生成getter方法.
其余沒有做處理.
接下來有時(shí)間需要添加
1.已經(jīng)有g(shù)etter方法的屬性不要被重復(fù)生成getter方法.
2.插入代碼的位置. 從@end所在行的上方. 修改為光標(biāo)所在行.
3.哪些屬性需要被生成getter方法. 哪些不需要. 這個(gè)可以由用戶指定.例如加注釋標(biāo)記. 或者仿照解釋型語言的方式,在上面一行加裝飾器
4.生成的代碼可以是多樣性的. 例如UIView自動(dòng)帶上背景色的代碼. UIButton不使用alloc init 使用system類型的枚舉創(chuàng)建UIButton
這些功能有時(shí)間再去編寫.
結(jié)尾再次附上代碼鏈接
https://github.com/ddyd369/CreateGetterMethod.git
