Phabricator 客户端使用基本手册

前言

Phabricator 是 facebook 开源的一款工具，它是一套快速、可扩展、完全开源的，完整的开发软件工具。

它内置的应用程序，可以帮助您管理任务；审查代码；托管 Git、SVN 或 Mercurial 仓库；构建与持续集成；审查设计；在内部聊天室进行讨论等等。

要想使用 Phabricator 进行 CodeReview，我们必须要先下载 Phabricator CodeReview 工具。换句话说，以后我们在提交代码时，要使用 arc 工具来代替 git 工具了，具体的使用方法我们在下一小节中会详细介绍。

首先我们来看一下如何下载并安装 Code Review 工具。

下载并安装客户端代码

【在Ubuntu下使用的注意事项】

1：Ubuntu 版本： 16.0x 或以上版本

2：git版本 ： 2.1xx或以上版本

3：php版本: : php7.1版本或以上

php-curl : 也要选择php7.1以上版本

（千万不要选择PHP5.1可能会出问题）

{

Ubuntu低版本系统安装的时候源可能是低版本;

安装php-curl

sudo apt-get install php7.0-curl

//要选择自己已安装的php准确版本，如7.0, 5.6

执行这条命令后报错了 unable to locate package php7.0-curl

后来发现是这个源没有该curl模块，所以我们采用以下方法 帆帆帆帆帆帆帆帆帆帆       

sudo apt-add-repository ppa:ondrej/php

//更添加这个源

sudo apt-get update

sudo apt-get install php7.0-curl

//这时成功安装php7.0-curl

}

Phabricator CodeReview 工具的下载和安装非常简单，具体操作如下：

第一步，安装依赖工具

Phabricator 的 CodeReivew 工具 arc 依赖两个工具，一是 PHP，二是 Git。具体安装方法如下，在 Mac 系统下：

brew install php
brew install git

在 Ubuntu 系统下：

apt install php
apt install git

在 Windows 系统下：

https://blog.csdn.net/wgllovemother/article/details/102942315

第二步，从 github 上下载 arc 工具

mkdir /somewhere/pha # somewhere 是你自己指定目录
cd /somewhere/pha  
git clone https://github.com/phacility/libphutil.git
git clone https://github.com/phacility/arcanist.git

使用 git 下载时有时很慢，而且容易出现断连，如果遇到这种情况，建议你直接下载 zip 包。

第三步，设置环境变量

• Mac 环境

vi ~/.bash_profile
export PATH=$PATH:/somewhere/arcanist/bin/ # somewhere是你自己指定的目录

• Ubuntu 环境

vi ~/.bashrc
export PATH=$PATH:/somewhere/arcanist/bin/

设置好环境变量后，我们最后还要让环境变量生效，执行下面语句：

source ~/.bash_profile
或
source ~/.bashrc

通过上面的步骤，我们就将 Phabricator 的 CodeReview 工具安装好了，命令：arc help测下。

获取项目源码

通过 Phabricator 上托管的 git 上获取源码与从github上获取源码是类似的。我们只需要在 Phabricator 的 Repositories 中找对应的项目，并从中获取 git 地址就可以了。

拿到 git 地址后，通过下面命令获取项目源码。

这里的密码不是账户密码， 个人->设置->vcs 设置新的密码进行拷贝
git clone http://xxxx/diffusion/1/xxxx.git

配置项目

进行到你的项目源码目录下，在该目录下创建一个 .arcconfig 文件，其格式如下：

{

"phabricator.uri" : "http://yours-url/"

}

具体命令如下：

$ cd yourproject/

yourproject/ $ vim .arcconfig

{

"phabricator.uri" : "http://yours-url/"

}

安装 Arc 工具证书

凭证可让您进行身份验证。您必须先在Phabricator上拥有一个帐户，然后才能执行此步骤。

$ cd yourproject/
yourproject/ $ arc install-certificate http://yours-url/diffusion/1/project.git
...

执行上面的命令后，你需要按照说明进行操作。这步操作会将您在本地计算机上的用户帐户链接到您的Phabricator帐户上。

提效变化进行 Review

经过上面的操作后，你现在就可以提交代码，并进行 CodeReview吧。具体的命令如下：

• 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更加详细的信息

git diff 

在配置了 lint 和 unit test intergration后，可以用这些命令：

• arc lint：静态代码检查
• arc unit：单元测试

与其它工具交互：

• arc upload：上传文件
• arc download：下载文件
• arc paste：创建和查看剪贴

提交代码时字段含义

• Comment：说点什么。可以针对某行代码进行评论，直接点击行号即可
• Accept Revision：接受变更，这哥们代码写得不错，不需要改
• Request Changes：不行，还要改
• Resign as Reviewer：重新指定审查代码的人
• Commandeer Revision：字面意思是将这个Revision据为己有的意思，实际上这个时候Reviewer的身份已经变为Owner的身份了，不能再进行Review了，但是Comment还是可以的
• Add Reviewer：添加审查人
• Add Subscribers：添加订阅者，CC
• Abandon Revision：废除版本。废除后，这个版本就不需要再审核了
• Plan Changes：计划变更，我自己发现了一些问题或者需求有变，正在改
• Add Reviewer：添加其它审查人（除当前审查人外）

最后

以上就是等待毛衣为你收集整理的Phabricator 客户端使用基本手册的全部内容，希望文章能够帮你解决Phabricator 客户端使用基本手册所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。