最近做了一款 Xcode「合法」外掛。之所以說合法,是因為 Xcode 8 之後全面停用舊的第三方外掛機制,新外掛必須通過安全檢驗,只能改用官方的 Xcode Editor Extension 來實作。EasyCode 就是基於這套 Extension 開發的。老實說,目前 Extension 開放的 API 少得可憐,但至少 Apple 團隊跨出了羞澀的第一步。
GitHub 專案地址:https://github.com/music4kid/EasyCode-Xcode
現階段 Extension 能做的事只有一件:取得目前編輯中的檔案內容——但幸好,我們可以對內容進行修改。於是先前做 FastStub 時浮現的念頭就派上用場了:能不能用字母縮寫,快速插入一整段程式碼?
動機來自 Xcode 自動補全能力的不足。舉例來說,寫 UIViewController 時經常要敲這種東西:
- (void)viewDidLoad {
[super viewDidLoad];
}在 Xcode 8 裡,你必須先完整輸入 -(void) 才會跳出補全提示,也就是說回傳型別必須嚴格吻合,而 [super viewDidLoad]; 這種必要行也不會幫你補上。一直以來我都覺得,這裡該有個更快的輸入方式。
當然,你可以用 Xcode 自帶的 Code Snippet Library 建立捷徑,但那個流程我每次都不太順手,何況把每個常用片段都建一遍實在麻煩。寫成外掛一次搞定,更何況工程師最懂工程師要什麼。
EasyCode 的做法是:取對應函數單字的首字母來比對(取前三個單字,不足則取兩個)。
例如 viewDidLoad 拆成 view、Did、Load 三個單字,對應縮寫 vdl。在 Xcode 中透過選單或快捷鍵觸發外掛,vdl 就會被替換成完整的程式碼片段。
同理,輸入 vda 得到:
- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
}輸入 drm:
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}輸入 sio:
- (UIInterfaceOrientationMask)supportedInterfaceOrientations {
<#code#>
}輸入 htw:
- (nullable UIView *)hitTest:(CGPoint)point withEvent:(nullable UIEvent *)event {
<#code#>
}輸入 dr:
- (void)drawRect:(CGRect)rect {
<#code#>
}GCD 的幾個 API 縮寫後容易撞車,所以做了些調整。
輸入 dafm(dispatch after main queue):
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(<#delayInSeconds#> * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
<#code to be executed after a specified delay#>
});輸入 dasm(dispatch async main queue):
dispatch_async(dispatch_get_main_queue(), ^{
<#code#>
});那 dafg、dafm 又分別代表什麼?留給你自己猜一下。
還有一些單字母或短縮寫,需要一點記憶:
del:
([UIApplication sharedApplication].delegate)
v:
- (void)<#method#>
p:
@property (nonatomic, strong) <#type#> <#name#>
w:
__weak __typeof(self) wself = self;
n:
[NSNotificationCenter defaultCenter]
u:
[NSUserDefaults standardUserDefaults]
img:
[UIImage imageNamed:<#(nonnull NSString *)#>];
bun:
[[NSBundle mainBundle] pathForResource:<#(nullable NSString *)#> ofType:<#(nullable NSString *)#>];
以上都是我平常最不想敲的片段,純粹是手指運動,能自動生成之後舒暢太多。
輸入 btn:
UIButton *btn = [UIButton new]; [btn setBackgroundColor:<#(UIColor * _Nullable)#>]; [btn setTitle:<#(nullable NSString *)#> forState:UIControlStateNormal]; [btn addTarget:<#(nullable id)#> action:<#(nonnull SEL)#> forControlEvents:UIControlEventTouchUpInside]; [<#self#> addSubview:btn]; <#self.btn#> = btn;
常寫 UIButton 的人應該懂,這段東西一個字一個字敲有多無趣。
輸入 lb:
UILabel *lb = [UILabel new]; lb.text = <#text#>; lb.textColor = <#(UIColor * _Nullable)#>; lb.font = [UIFont systemFontOfSize:<#(CGFloat)#>]; lb.backgroundColor = [UIColor clearColor]; [<#self#> addSubview:lb]; <#self.lb#> = lb;
至於輸入 iv 會產生什麼,不用我說大家也猜得到。其他還有不少類似縮寫,目前收錄的都是個人覺得高頻的 API;如果不符合你的記憶習慣,fork 專案後自行配置即可。
這款外掛的目標就是讓大家少敲重複程式碼,實際用下來還算愉快,適合「既勤快(記得住 API)又愛偷懶(懶得敲完整 API)」的工程師。若日後 Apple 開放了 GUI 互動能力,它應該能變得更實用。
下載程式碼後用 Xcode 8 執行即可,執行前需用自己的開發者憑證替 Target 簽名。等 Xcode 開放更多 API,再考慮上架 App Store。
使用方式是先為 Xcode 的選單項設定快捷鍵(我自己設的是 cmd+.):

然後在縮寫字母後面按下快捷鍵:

任何問題,或想補充常用片段,都歡迎到 GitHub 提 issue。
同時也期待 Xcode 團隊開放更多 API——目前真的不夠用,想把 FastStub 遷移過來完全做不到。迫切需要的其實就兩件事:讀取整個專案檔案的權限,以及 GUI 互動能力。
文章轉自 MrPeak 技術分享