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:添加其它审查人(除当前审查人外)
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章