当前位置:首页 > 精品收藏 > 正文内容

产品管理工具Phabricator VS Arcanist

Z先生9年前 (2016-04-11)精品收藏8476

具体说来, 由于我的project稍微有点特殊,所以我这一年在facebook工作的时候一直在用两套Code Review工具: Facebook的Phabricator 和 Google的Gerrit (他们都是开源). 我觉得两个工具都很快,很稳定,然后都有效地提供了code review必备的功能:比如比较任意两个不同版本, 对任意一行代码来写评语, 以及可以很方便地导入和导出代码到本地机器. 


用了将近一年的时间,如果我要给自己的公司选一个工具的话,我会选择Phabricator. 主要是觉得这个界面很干净, 然后配色非常好看, 整个感觉比Gerrit要现代化不少. 另外一个方便地地方,就是Gerrit上面只能看到版本做的修改,而无法直接展开整个文件(除非下载), 而这点Phabricator完成得比较好. 还有就是Phabricator上面可以发各种图片,显得气氛比较轻松. 具体你可以在http://Phabricator.com上面注册一个账户,然后去看看eprisetley的diff, 就可以大致了解这个工具的功能和特点. 


最后要说的是: 这个工具现在已经开源, 并不属于Facebook, 而且开发它的首席工程师也已经离开Facebook自己创业. 


在加上 AladdinZ 张超 在评论里面说的亮点: (credit属于他,而且的确也是我用后觉得有很大差别的地方)

1. Phabricator将所有文件的比较直接展开,然后放在一起,方便人阅读. 而Gerrit只有一个文件列表,然后用户需要点每一个文件,才能看到具体的修改; 

2. admin的权限设置问题. 


另外我还想到一点Phabractor比较人性化的地方: 

Phabricator还可以捆绑unit test和以及格式检查和规范的工具(e.g. JSLint), 然后用户在上传diff的时候, phab会自动用新版本的代码去跑unit tests,以及运行JSLint, 然后在code review里面就可以看到unit tests有几个failure和error,以及JSLint的报警信息. 对于Gerrit, 不知道能否类似配置一下.


从 12 年公司老东家成立创新产品团队开始到目前,Phabircator 已经从只有我们团队使用到现在老东家全面投入使用。刚开始由于是创新产品团队,不用受制于公司大环境的束缚,可以自由发挥的空间更多。由于个人比较喜欢玩工具,比如 Trac 和 Redmine 以及 Bugfree 都用过很长时间(当然从来没有觉得很满意),正当总是不满意的时候 Phabricator 进入了视线,经过一些使用和研究,我们决定将传统的 Subversion + ReviewBoard + Jenkins 切换到 Git + Phabricator 的平台上,暂时抛弃了持续集成部分,轻装简从开始了我们新的工具时代。

Phabricator 最早是 Facebook 的内部审查工具,看过王淮的《打造 Facebook》都应该知道,Facebook 最厉害的工程师都需要进入工具部门去锻炼深造,所以质量就不明觉历了吧。据说后期 Phabricator 在 Facebook 资助下专心做这个,迭代和更新速度都很快,整体界面和 Facebook 的风格简直是如出一辙(就觉得 Facebook 的传统风格太像是工具了)。


作为资深使用用户有资格发表点对使用 Phabricator 的一些看法:

首先,Phabricator 是基于 PHP + Mysql 的,但是配置起来也不麻烦。个人也曾经贡献过一些 Bug fix,从代码上来说 Phabricator 虽然不是我的风格,但风格和写法上非常不错。所有的开发都是面向 OOP,资源的管理是分离的很清楚的,配置的管理是多重的(数据库,文件,默认)等等。高手写的代码都值得追随和拜读。所以,如果你在做 PHP 建议来读一读。

其次,传统的概念上,项目、仓库和任务都是以项目为主绑定在一起的。而在在 Phabricator,所有这些都不是耦合在一起的。项目就是项目,仓库就是仓库,任务就是任务。但所有的东西都是以项目作为线索连接在一起的。一个任务可以属于多个项目,仓库的 commit 和 review 只有在提交任务的时候,可以结合进去。如果要想更好的使用仓库,比如自动 Review,审查 commit,还需要用到 Owners,根据配置,所有人会拥有仓库的审查权限,所有仓库的提交也都有 Owners 来进行审核。这种松散的组合,想必和 Facebook 内部开放协作的项目态度是有关的,对于开放的团队来说非常有好处。


再者,代码仓库的支持很完整。Git,Svn,HG 一个都不落下(什么,你说 CVS,那是什么)。对于仓库,Phabricator 有很好的自动检测和拉取机制,你推的代码,很快它就能收到,根据你定制的规则去指派给相应的人去审核。除了可以审核,查看代码也非常方便,甚至它本身支持了 ctags 的导入,如果你导入了 ctags ,在代码中甚至可以用 IDE 中快速定位的方式去查找代码源自哪里?高亮自然就不用说了,没有一种语言不支持的,估计新版本连自己的 Haske Lang 都支持。


然后,辅助工具也很丰富,对于开发之外的各种需求来说都可以满足。比如文档、图片审查、倒计时、问答、代码分享、投票、密钥管理、日历、聊天、文件共享简直是费尽心思。文档是代码开发的重要部分,Phabricator 采用了自己编写的 reMarkup 语法和Markdown 非常相似,但是多了表格,目录索引,引用自有文件任务等功能,使用上很快就能进入,基本不会有什么问题。简单说说图片审查,这块是我最没有想到的。不过也解决了一个我们设计的痛点。可以把设计稿提交上来给大家看,你我都可以圈圈点点,提交意见,最终定稿。否则,设计师这个跟开发同性质(需要被产品经理赶)的用户只能上 Phabricator 看任务。其它的就不多说了,基本都是字面意思,如果你有用到最好,用不到也无所谓,只是辅助。

接着,要说下命令行。Phabricator 提供了个命令行叫 arc (Arcanist),总之很方便。它有几个用处:操作数据(任务查看操作);开发辅助(gitflow 工作流,查看提交的 diff,代码检查,执行单元测试);辅助(文件分享下载、代码分享,升级)等等。对于开发来说,命令行再熟悉不过,用好这个命令行可以少上 Web 界面去操作,对工作效率的提升简直是大赞。

最后,Phabricator 很潮很自由。看看界面上的文字上如果你不去查查字典,估计有不少词你都不认识,应该不少是出自希腊古语。不过可以通过配置关闭使用正常点的描述。在账号系统支持上支持的很到位。Github、Facebook、Google 和公司内部的 LDAP 都能支持。Phabricator 的 API 是开放的,基于此你可以做出来很多符合自己需求的东西。Phabricator 也对邮件支持的也很到位,配置好收发邮件后,就可以像 Github 那样使用邮件来进行工作流

总之。如果你在挑选 Review 系统拿不定主意,看完就果断入了吧。这套系统是免费的开源的。就先说这么多。



Phabricator的代码评审工具是Differential,Arcanist只能说是Phabricator提交代码评审的工具,不使用Arcanist也能使用Differential进行代码评审,方法是在Differential界面点击右上角的“Create Diff”创建Diff和Revision。


Arcanist在Unix下的大致使用方法如下:

1、 arc设置

设置编辑器: arc set-config editor "vi"

设置默认Phabricator URI: arc set-config default http://your_phabricator_url/

2、 配置.arcconfig

在项目代码根目录创建.arcconfig文件,内容例如

{

"project_id" : "your_project_id",

"conduit_uri" : "http://your_phabricator_url/"

}

此文件可提交到代码库上。

3、 安装证书

cd your_project_src_root

arc install-certificate

此命令需要输入token,浏览器打开http://your_phabricator_url/conduit/token/,复制内容粘贴即可,注意使用自己的用户登录

4、 提交Differential(GBK)

默认:arc diff . --encoding GBK

修改已存在的diff: arc diff . --update D1 --encoding GBK

创建新的diff: arc diff . --create --encoding GBK

从文件提取信息创建:arc diff . --encoding GBK --create --message-file ~/arcdiff.txt

注:arc diff可支持一次创建多个目录的diff,如不指定目录则为整个库。


Phabricator的数据库使用UTF8编码(参阅User_Guide_UTF-8_and_Character_Encoding.html),使用网页提交Diff和Revision以及进行代码评审时没有问题,Arcanist也支持其它编码的代码库,国内一般使用GBK字符集,提交arc diff时必须显式指定GBK字符集编码,否则如源代码存在非UTF-8编码字符则会被保存为二进制文件;

提交diff时在命令行及编辑器中禁止输入非UTF-8编码字符,如果输入了GBK中文字符且保存信息后可能会导致Invalid UTF-8 string passed to phutil_utf8v错误,此时需要手工删除项目代码根目录下的.svn/arc/create-message文件方能继续执行;

如需arc diff 支持输入GBK字符需要修改Arcanist的arcanist.php和ArcanistDiffWorkflow.php代码文件。


不只是适用于开发,我们产品团队也将pha用于产品文档撰写和项目进度管理

pha类似markdown的语法能够很好的控制文档格式,在线编辑模式又提高了产品与技术直接文档信息同步的效率,如果很好的使用邮件订阅的功能,重要文档的修改都可以及时的告知每一个相关人员

同时,task式的任务指派模式能很好的整理产品需求,将以往Excel管理feature的模式在线化,而且由于task与wiki,code review都在一个系统中,每个task的说明能够与产品技术说明直接关联,每个人都可以看到该task的相关进度

对于产品经理or项目经理来说,phabricator也是非常好的选择


作者:代绪
链接:http://www.zhihu.com/question/19977889/answer/24122118
来源:知乎
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。


分享给朋友:
返回列表

没有更早的文章了...

下一篇:linux/centos 搬家利器

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。