本文是投稿文章,作者:everettjf
代碼:https://github.com/everettjf/XBookmark
效果
menu
使用方法
首先要安裝插件管理器 Alcatraz ,搜索XBookmark並安裝,重啟Xcode後就可以在Edit菜單中找到以下功能啦。
對應代碼行,按F3可增加、刪除書簽
Shift+F3,可顯示書簽列表
Command+F3,下一個書簽
Shift+Ctrl+F3,上一個書簽
背景
初入iOS開發,發現自己以前在Visual Studio中常用的書簽功能,Xcode中竟然沒有。網上找了一陣子,大概有以下替代方法:
使用斷點(Disabled Breakpoint)
使用插件XToDo,增加標簽BOOKMARK,並在想加書簽的代碼行增加注釋 BOOKMARK
使用插件XcodeBookmark(不是本文說的XBookmark),但此插件貌似不支持Xcode7,而且原理仍然是輔助增加斷點。
目前找到了這3種方法,但感覺都不理想。沒法快速進行上一個書簽、下一個書簽切換,沒法增加書簽注釋。
於是,想自己開發一個,就叫做 XBookmark 吧。
預習文章
開發中大概看了以下幾篇文章。
Xcode插件的文章:
http://studentdeng.github.io/blog/2014/02/21/xcode-plugin-fun/
http://www.poboke.com/study/write-a-xcode-plugin-to-auto-select-all-targets.html
http://www.onevcat.com/2013/02/xcode-plugin/
Mac開發的文章:
http://www.raywenderlich.com/17811/how-to-make-a-simple-mac-app-on-os-x-10-7-tutorial-part-13
還看了幾個插件的源碼。
開發步驟簡要總結
安裝模板、創建工程
在 Alcatraz 中的 Templates 中搜索 Xcode Plugin。安裝後從此模板創建工程。
增加菜單
NSMenuItem *menuItem = [[NSApp mainMenu] itemWithTitle:@"Edit"]; if (menuItem) { [[menuItem submenu] addItem:[NSMenuItem separatorItem]]; { NSMenuItem *actionMenuItem = [[NSMenuItem alloc] initWithTitle:@"Toggle Bookmark" action:@selector(toggleBookmark) keyEquivalent:f3]; [actionMenuItem setKeyEquivalentModifierMask:0]; [actionMenuItem setTarget:self]; [[menuItem submenu] addItem:actionMenuItem]; } //...
獲取書簽位置
IDESourceCodeEditor* editor = [XcodeUtil currentEditor]; NSTextView* textView = editor.textView; if (nil == textView) return; NSRange range = [textView.selectedRanges[0] rangeValue]; NSUInteger lineNumber = [[[textView string]substringToIndex:range.location]componentsSeparatedByString:@"/n"].count; // length of "file://" is 7 NSString *sourcePath = [[editor.sourceCodeDocument.fileURL absoluteString] substringFromIndex:7]; XBookmarkEntity *bookmark = [[XBookmarkEntity alloc]initWithSourcePath:sourcePath withLineNumber:lineNumber]; [[XBookmarkModel sharedModel]toggleBookmark:bookmark]; //...
增加書簽列表
發布到 Alcatraz
挺簡單,修改配置文件,創建一個 Pull Request 就可以。
見 https://github.com/supermarin/alcatraz-packages 的README。
結語
目前僅是完成了基本功能,還有幾個需要優化和完善的地方。
定位代碼行。(代碼來自XToDo的代碼,但有些情況下定位速度慢。需要查找原因解決)
書簽標識。代碼行前面顯示書簽符號,對號之類的。
注釋功能。(增加書簽注釋功能)
Mnemonic 書簽。(模仿 IntelliJ 系列)