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和其状态

工作流程:

运行 git commit -am "修复了 XX BUG" ，commit你的改动

运行 arc diff ，提交Differential，它会提醒你填写一些信息：

Test Plan - 必填，详细说明你的测试计划；
Reviewers - 必填，审查人的账户，多个使用","隔开；
Subscribers - 非必填订阅人，多个使用","隔开。

提交成功后，审查人就能在Differential收到通知
如果 review 没有通过，你需要在原来的基础上修改，修改完并 commit 之后需要执行 arc diff --update D(id) 继续 review
如果 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

来源：oschina

链接：https://my.oschina.net/u/347219/blog/687170

标签

Phabricator

arcanist