phabricator 客戶端使用文檔

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

1.安裝

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

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

2.在項目中添加引用

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

API Token 驗證成功

3.提交Differential

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

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

4.命令指南

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

5. 分支提交

   ---

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

   ---