Phabricator进行CodeReview

曾经终败给现在 2023-07-18 06:58 21阅读 0赞

**前言**

Github：[https://github.com/HealerJean][https_github.com_HealerJean]

博客：[http://blog.healerjean.com][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

![1582789692324][]

### 1.3.2、环境变量配置 ###

![1582789774962][]

![1582789794391][]

### 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/][https_phabricator.d.xiaomi.net_conduit_login]，把页面上的token复制/粘贴下来**

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

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

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

配置生效

source ~/.bashrc

# 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://git@phabricator.youdomain.com/diffusion/P/youproject.git

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

# 3、arcanist的使用 #

## 3.1、arcanist的作用 ##

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

![1582790565276][]

## 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` – 非必填，订阅人，能够收到代码变更的邮件通知，多个使用”,”隔开**

![1582797454590][]

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

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

arc diff –preview

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

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

### 3.3.4、`arc list：`查看review的状态 ###

arc list
    * Needs Review D202484: 用户登录

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

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

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

![ContactAuthor][]

[https_github.com_HealerJean]: https://github.com/HealerJean
[http_blog.healerjean.com]: http://HealerJean.github.io
[1582789692324]: /images/20230528/9474d1284d3e4e478059fc15347383c4.png
[1582789774962]: /images/20230528/4966156d4127478eb4619fbda7ccc663.png
[1582789794391]: /images/20230528/0804de7835944fe39dd41545bd1cea8b.png
[https_phabricator.d.xiaomi.net_conduit_login]: https://phabricator.d.xiaomi.net/conduit/login/
[1]: http://softlab.sdut.edu.cn/blog/subaochen/2016/09/arcanist%E7%9A%84%E7%94%A8%E6%B3%95%E7%AE%80%E4%BB%8B/#fig_arcanist___
[1582790565276]: /images/20230528/cefea9f6482d4ffbb0d2cdb6cc48ea7e.png
[1582797454590]: /images/20230528/8a6b5635f58a42998cec3a48bc4a0a7a.png
[ContactAuthor]: /images/20230528/264b30e63c1e4f0a91d26565a33de22a.png