Phabricator程式碼審查使用方法(mac版)
Phabricator是一個程式碼審查管理,Arcanist是Phabricator配套的Code Review工具,需要配合本地git使用。
首先先貼上參考部落格:
Phabricator命令列工具Arcanist的基本用法
Arcanist用法簡介
確認PHP是否已經安裝
Mac OS X應該已經預設安裝了PHP環境。在終端中輸入php -v檢查是否已安裝了PHP環境。
安裝Arcanist在計劃安裝目錄簽出Arcanist程式碼倉庫
git clone https://github.com/phacility/libphutil.git
git clone https://github.com/phacility/arcanist.git
(這時候直接用scourceTree 裡面的終端直接clone就可以了,時間可能有點長,耐心等待。)
配置arc的環境變數
開啟bash_profile 檔案 輸入命令列:open -e .bash_profile 會自動彈出 .bash_profile 檔案的編輯視窗,在配置檔案的末尾加上這一句
export PATH=${PATH}:/路徑/arcanist/bin/
輸入命令列:source .bash_profile 更新更配置的環境變數。
然後輸入命令:arc –help 檢視配置是否成功。
配置專案
開啟終端,切換到專案所在目錄,執行arc install-certificate,按提示新增訪問token
程式碼審查流程
在本地獨立開發分支提交改動程式碼。有對應的Manifest Task時,改動需要在同名分支下提交。
執行arc diff。第一次執行時需要配置預設的比較目標,預設為origin/master,可以按需修改為origin/develop,或執行arc diff [分支名]來顯示指定
在彈出的文字編輯器中填寫Title、Summary和Reviewer,儲存並關閉
等待審查通過,如果審查失敗的話,可修改程式碼並重新執行arc diff
如果審查通過,制定arc land –onto=分支名合併程式碼並提交,提交後開發分支將被刪除
流程
git checkout -b feature_xxx — 建立一個新分支,並修改程式碼
git add . && git commit -m tt — 將該提交的都提交上去
arc diff [last_commit]此命令會將 last_commit 到最新的 commit 之間的改動的所有程式碼傳送到phabricator 平臺,並建立一個 revision;
如果沒有指定 last_commit,則會使用 master 分支來作為 last_commit 的起點。執行命令後會彈出一個編輯面板,在此面板中你需要指定 reviewers,即指定一個或多個給你 review code 的人 如果指定了多個reviewers,則其中任何一個 review 通過就可以,不用全部 review 通過
另外編輯面板中也有一個 test plan 選項,國外人一般每個專案都有測試,所以此項是必填的,如果沒有測試,我們只需要隨便設定一個欄位即可,比如設定成 no 或 skip如果覺得指派reviewer的用法不太方便,可以執行arc diff –preview根據生成的diff頁面進入配置,生成revision.
以上操作之後,系統會發送郵件通知 reviewers 去 review 你的程式碼,你也可以通過 arc list 來檢視當前 review 的狀態
如果 review 沒有通過,你需要在原來的基礎上修改,修改完並 commit 之後需要執行 arc diff [last_commit] –update D(id) 繼續 review