Phabricator进行CodeReview

前言

Github：​​https://github.com/HealerJean​​

博客：​​http://blog.healerjean.com​​

1、软件安装

1.1、安装Git

1.2、安装php

1.2.1、window安装

查看我的另一篇文章windows 安装php文章

1.3、安装Arcanist

1.3.1、下载

git clone https://github.com/phacility/libphutil.git #克隆工具库
git clone https://github.com/phacility/arcanist.git #克隆Arcanist

1.3.2、环境变量配置

1.3.3、配置编辑器

若显示“… was null”，则再执行一次命令：

将编辑器配置为Notepad++

arc set-config editor "\"C:\Program Files (x86)\Notepad++\notepad++.exe\" -multiInst -nosession"

将编辑器配置为Sublime Text

arc set-config editor "\"C:\Program Files\Sublime Text 3\sublime_text.exe\" -w -n"

1.3.4、 设置phabricator全局参数

配置全局参数，若显示“… was null”，则再执行一次命令：

arc set-config default https://phabricator.d.healerjean.net/

运行下面的命令，根据提示访问 ​​ https://phabricator.d.xiaomi.net/conduit/login/​​，把页面上的token复制/粘贴下来

arc install-certificate
# 以上设置存储于 ~/.arcrc 中

在~/.bashrc里添加下面两行

export EDITOR=vim
alias arc='LC_ALL=C arc'

配置生效

source

2、项目管理工具

2.1、安装arcanist前的准备工作

在安装arcanist之前，确保以下，这样才能有权限的clone基于ssh协议的远程仓库：

1、将你的ssh-key上传到了phabricator：

2、将$HOME/.ssh/id_rsa.pub文件的内容粘贴到phabricator的Setting>Personal Settings>Authentication>SSH public key中，

git clone ssh://[e-mail]/diffusion/P/youproject.git

//有机会再写一些phabricator配置性的东西

3、arcanist的使用

3.1、arcanist的作用

arcanist是phabricator创建的代码审核辅助工具，其作用参见图​​1​​：

3.2、详细使用命令

3.3.1、​​arc diff develop​​

review前开发一定要使用自己的分支，比如healerjean，因为最后合并到主分支后会删除当前分支(如果不创建会怎么办)

git checkout -b healerjean

对项目做了一些修改后，首先git add/git commit将修改放进暂存区（stage area），然后执行arc diff命令，会弹出编辑器，我的是Sublime Text， 会提示填写下面的信息：

​​title：​​

​​Summary​​：默认给的是commit的信息

​​Test Plan​​ – 必填，详细说明你的测试计划，没有就随便填个no或者skip；

​​Reviewers​​ 必填 ，执行代码审核人的账户，多个使用”,”隔开；（比如 healerjean），如果指定了多个 reviewers，则其中任何一个 review 通过就可以，不用全部 review 通过

​​Subscribers​​ – 非必填，订阅人，能够收到代码变更的邮件通知，多个使用”,”隔开

3.3.2、​​arc diff –preview:​​代码审核前，可以自己预览自己提交的代码，并且可以再网页重新发起review请求

输入以下命令，会给一个预览地址，代码审核前，可以自己预览自己提交的代码。并且可以再网页重新发起review请求

arc diff

3.3.3、 如果审核未通过，或者自己想继续追加提交

1、arc diff #继续执行这个命令，arc会自动知道是更新操作
2、arc diff　develop(预期分支名称)

3.3.4、​​arc list：​​查看review的状态

arc list
*

3.3.4、​​arc land:​​审核通过后，合并分支

如果审核通过，在本地执行arc land即可将代码push到中央仓库，并删除当前分支。自动回到push的分支 。

arc land --onto release/uat0.1 --revision D202484