一、為什么要使用SwiftFormat
我們在作為Git
預(yù)提交代碼之前對其格式進行自動化,確保代碼規(guī)范,有助于提高code review
的效率,對比了幾款針對Swift
代碼的自動格式化,發(fā)現(xiàn)SwiftFormat超越了您對代碼格式化程序的期望。除了調(diào)整空格之外,它還可以插入或刪除implicit self
,刪除多余的括號,并糾正許多其他與標準Swift
習慣用法的偏差。
二、如何安裝SwiftFormat
我們可以直接用 Homebrew 來安裝它,已經(jīng)安裝的同學可以忽略這一步:
brew install swiftformat
安裝 SwiftFormat
的 Xcode
插件:
- 打開終端輸入
brew install --cask swiftformat-for-xcode
,如【終端.jpg】圖標1
處,出現(xiàn)2
表示安裝成功; - 然后執(zhí)行
open "/Applications/SwiftFormat For Xcode.app"
,如3
。
終端.jpg
打開 SwiftFormat For Xcode.app
后,會自動安裝到Xcode
上,需要重啟Xcode
才能生效。重新打開Xcode
,在 Xcode
的 Editor
目錄下能看到 SwiftFormat
菜單就說明插件安裝成功了。
注意:你可以會遇到打開Xcode
沒看到SwiftFormat
- 這個時候注意一下
SwiftFormat -> about
中的提示:How do I install it?
image.jpg - 打開系統(tǒng)偏好設(shè)置,點開擴展勾選上
Xcode Source Editor
,再重啟Xcode
就可以看到了。
image.jpg
操作到這里,我們的代碼就可以用SwiftFormat -> Formar File
菜單來對其進行格式化了。但是每次手動并不是我們想要的最終方案,我們希望操作可以再簡化點:保存代碼的同時就自動對代碼進行格式化~~~
三、使用 Automator
添加自動化腳本
Automator
是一款系統(tǒng)軟件,中文名是自動操作。文件路徑:啟動臺 -> 其他,你也可以全局搜索??來找到。
1、打開Automator
,選擇快速操作(Quick Action
):
2、在搜索欄搜索
Script
,雙擊 選擇 運行 AppleScript
:3、用下面的腳本代碼替換上圖中的腳本:
on run {input, parameters}
tell application "System Events"
tell process "Xcode"
set frontmost to true
if menu item "Format File" of menu of menu item "SwiftFormat" of menu "Editor" of menu bar 1 exists then
click menu item "Format File" of menu of menu item "SwiftFormat" of menu "Editor" of menu bar 1
end if
click menu item "Save" of menu "File" of menu bar 1
end tell
end tell
return input
end run
該腳本將執(zhí)行以下操作:
- 檢查
Xcode
中Editor
菜單下是否存在SwiftFormat -> Format File
菜單項; - 如果存在,則自動觸發(fā)
Format File
菜單點擊,來格式化代碼; - 最后,自動點擊
Save
菜單,保存文件修改。
4、點擊Build
按鈕,里面的代碼會自動高亮:
5、接著修改 【工作流程收到】 這一項配置為【 沒有輸入】,【位于】改成 Xcode.app。
6、最后? + S
保存,將該自動操作命名為 XcodeFormatAndSave
,它會自動保存在 ~/Library/Services/
目錄下。重新打開Xcode
,我們將在 Xcode -> Services
菜單下看到它,但是目前它還是不能工作的,還需要進一步配置。
四、添加鍵盤快捷鍵
我們最終的目標是要在保存文件(? + S
)的時候,自動進行代碼格式化。
打開 系統(tǒng)偏好設(shè)置 -> 鍵盤 -> 快捷鍵
,選擇 左側(cè) App快捷鍵
這一項,添加一個新的快捷鍵,應(yīng)用程序選擇 Xcdoe
,菜單標題和剛才保存的自動操作名稱一樣:XcodeFormatAndSave
,鍵盤快捷鍵設(shè)置成 ? + S
,然后點擊 添加
按鈕。
最后,我們還需要為它配置運行權(quán)限,不然會報錯。
打開 系統(tǒng)偏好設(shè)置 -> 安全性與隱私 -> 隱私
,在左側(cè)列表中選擇 輔助功能
,授予 Xcode
控制權(quán)限。
到這里,我們在Xcode
中保存(? + S
)Swift
文件的時候,就會自動觸發(fā)代碼格式化了,非常nice ~~~