Phabricator使用笔记

codereview工具Phabricator使用笔记

arc交互命令

Arcanist - 命令交互
我们用这个工具提交变更和审查请求，对变更做出更改，或者在通过审查后发布到远程仓库分支中。
常用的命令有：
arc diff：发送变更详情和审查请求
arc land：推送变更（Git and Mercurial），当通过审查后使用这个命令
arc list：显示变更处理的情况
arc cover：查找最有可能审查变更的人
arc patch：给版本打补丁
arc export：从Differential下载补丁
arc amend：更新Git commit
arc commit：提交变更（SVN）
arc branch：查看Git branches更加详细的信息

使用Phabricator做为Code Review工具
https://www.jianshu.com/p/b1a75a14638c

常用交互命令

指定和master做diff：
arc diff master

和指定分支做diff：
arc diff branch-name

指定和master做diff，新建diff：
arc diff master --create

在指定commit上做diff：
arc diff commit_id(8位commit id)

在pha上一个已有的revision（编号Dxxxx）上做增量
arc diff --update Dxxxx

git与phabricator
https://www.jianshu.com/p/e8d520f65916

phabricator：关于如何使用 arc 提交一个分支的 diff (规则git:HEAD^)
https://blog.csdn.net/GW569453350game/article/details/50825424

Phabricator命令行工具Arcanist安装配置

不用在本地安装Phabricator，一般部门有自己的已经安装好的

Arcanist安装

Arcanist是用PHP编写的，所以如果你还没有安装PHP，你需要先安装它。 Arcanist应该运行在 PHP 5.2 和 更新版本之上。 如果您没有安装 PHP，您可以从 http://www.php.net/ 下载。
要安装 Arcanist，请选择一个安装目录并从 GitHub 克隆代码：
some_install_path/ $ git clone https://github.com/phacility/libphutil.git
some_install_path/ $ git clone https://github.com/phacility/arcanist.git
你应该有一个这样的目录结构：
some_install_path/ # 你需要要安装的目录
arcanist/ # Arcanist 相关的代码和类库
libphutil/ # Arcanist 的共享库依赖
现在添加 some_install_path/arcanist/bin/ 到你的 PATH 环境变量。
输入 “arc”, 应该看到如下信息:
Usage Exception: No command provided. Try ‘arc help’.
看到这个输出代表你的安装是正确的。

Phabricator命令行工具Arcanist的基本用法
https://blog.sezina.io/2013/07/16/phabricatorming-ling-xing-gong-ju-arcanistde-ji-ben-yong-fa/

Arcanist 用户指南
https://phabricator.webfuns.net/book/phabricator/article/arcanist/

.arcconfig中配置Phabricator地址

.arcconfig 文件是一个放置在项目的根目录的 JSON 文件。
Arcanist 使用 .arcconfig 文件自定义一些它的行为。 您可能要配置的第一件事是您的 Phabricator 安装的 URI。 一个简单有效的文件看起来像这样：

.arcconfig
{
  "phabricator.uri" : "https://phabricator.example.com/"
}

Arcanist 用户指南: 配置新项目
https://phabricator.webfuns.net/book/phabricator/article/arcanist_new_project/

首次使用时arc install-certificate认证

第一次使用时提示

MBC02WG0BXG8WN:uds-common si.ma$ arc diff
Usage Exception: YOU NEED TO AUTHENTICATE TO CONTINUE
You are trying to connect to a server (phabricator.nevint.com) that you do not have any credentials stored for.
To retrieve and store credentials for this server, run this command:
      $ arc install-certificate

执行arc install-certificate命令，按照提示，打开一个Phabricator页面，把其中的token拷贝下来填到命令行中即可认证成功。

arc diff提交Differential

修复项目的Bug(也就是对你的项目做一些改变)。
运行git commit -am “修复了 XX BUG” ，commit你的改动
运行arc diff，提交Differential，它会提醒你填写一些信息：

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

提交成功后，审查人就能在Differential收到通知。
审查人将状态修改为Accept Revision表示通过，通过后，作者就可以将代码push到代码库里面去了。

phabricator
https://blog.csdn.net/liangliang103377/article/details/73497640