Arcanist 安裝及使用

Arcanist是Phabricator的命令行接口.

安裝:

# sudo apt-get install php5 php5-curl   # ubuntu 系統
# sudo yum install php5 # centos 系統

# cd /usr/local/bin    # 安裝目標路徑, 如目錄不在PATH, 則將 export PATH=$PATH:/usr/local/bin 加入 .bashrc
# git clone https://github.com/phacility/libphutil.git
# git clone https://github.com/phacility/arcanist.git
# ln -s arcanist/bin/arc arc # 建立軟連接, 使arc命令位於PATH中
在.bashrc加入下面一行, 使arc命令能夠自動補全:
source /usr/local/bin/arcanist/resources/shell/bash-completion

(或用 npm 安裝: npm install -g arcanist , 無需配置, 參見 https://www.npmjs.com/package/arcanist)

配置:

在git庫目錄建立 .arcconfig, 內容以下:

{
  "phabricator.uri" : "https://你的phabricator網站的域名"
}

安裝證書:

# arc install-certificate

會提示你用瀏覽器打開一個連接，獲取一個Token，複製該 Token, 粘貼到終端便可

使用:

arc help --full # 查看詳細幫助
arc diff  # 提交默認的diff
arc diff xxx --preview  # 提交針對某個分支的commit，並只生成diff文件，不在web端建立revision
arc which # 查看arc diff 會提交哪一個範圍的diff
arc land  # 提交代碼，刪除該分支 或 使用 git push
arc list  # 查看有哪些revision和其狀態

工做流程:

1. 運行 git commit -am "修復了 XX BUG" ，commit你的改動
2. 運行 arc diff ，提交Differential，它會提醒你填寫一些信息：

   Test Plan - 必填，詳細說明你的測試計劃；
   Reviewers - 必填，審查人的帳戶，多個使用","隔開；
   Subscribers - 非必填訂閱人，多個使用","隔開。

3. 提交成功後，審查人就能在Differential收到通知
4. 若是 review 沒有經過，你須要在原來的基礎上修改，修改完並 commit 以後須要執行 arc diff --update D(id) 繼續 review
5. 若是 review 經過了，只須要運行 arc land， arc 會將你當前分支合併的 master 上，並刪除當前分支

參考:

http://share.zuijiao.net/?p=22

https://secure.phabricator.com/book/phabricator/article/arcanist/

https://secure.phabricator.com/book/phabricator/

https://www.npmjs.com/package/arcanist