phabricator 客戶端使用文檔

arcanist是phabricator創(chuàng)建的代碼審核輔助工具，其作用參見圖：

1.安裝

安裝Arcanist很簡單，從github上拉兩個代碼庫到本地的同一個文件夾，再配置環(huán)境變量即可

git clone https://github.com/phacility/arcanist.git 
git clone https://github.com/phacility/libphutil.git
vim /etc/profile  #添加以下內(nèi)容  #/Users/qinshixu/test/ 為arcanist所在的目錄
export PATH="$PATH:/Users/qinshixu/test/arcanist/bin"
source /etc/profile
arc help     # 查看命令幫助信息  

2.在項目中添加引用

cd your_project  #進(jìn)入項目目錄
vim .arcconfig   #增加以下內(nèi)容
{
        "phabricator.uri": "https://***/", #phabricator 訪問地址
        "editor": "vim"
}
為項目安裝證書，用于phabricator的認(rèn)證
arc install-certificate   

API Token 驗證成功

3.提交Differential

git add    
git commit -m "***"
arc diff    # 提交review request，由vim打開，填寫以下信息,wq保存退出
    Test Plan:      #必填，詳細(xì)說明你的測試計劃 
    Reviewers:      #必填，審查人的賬戶，多個使用”,”隔開；
    Subscribers:    #非必填訂閱人，多個使用”,”隔開

#提交成功后，審查人就能在Differential收到通知
#審查人將狀態(tài)修改為Accept Revision表示通過，通過后,使用
arc land <branch>  ##進(jìn)行代碼push,默認(rèn)是master分支

4.命令指南

Arcanist可以做如下的事:
?   arc help ：獲得arc中包裝的可用指令/工具
?   arc diff?：發(fā)送代碼的差異Differential功能，以便回顧(有關(guān)該指令的更多信息， 可見?Arcanist User Guide: arc diff)
?   arc list :顯示未提交修改的代碼信息 
?   arc cover ：可以找到某個代碼修改的提交人?
?   arc patch:  適應(yīng)某已修改，并在這個修改上進(jìn)行工作
?   arc export：通過Differential功能下載/導(dǎo)出一個補(bǔ)丁文件?
?   arc amend：審核Git更新提交后的信息
?   arc commit：提交SVN庫的修改
?   arc land：向服務(wù)器端推送Git 和 Mercurial庫的修改
?   arc branch：可以看到更多有關(guān)Git分支的信息

5. 分支提交

   ---

   1.git checkout 分支名
   2.git add xx
   3.git commit -m ""
   4.arc diff 分支名
   5.arc land --onto 分支名 #push到分支

   ---