去年末才第一次接触的reviewboard系统,开源的代码审核,方便,快捷,当然也存在诸多开源软件的潜在bug多、说明文档不细致等特点,部署在公司的服务器上后,运行了近一年的时间,还算平稳高效,最近闲下来吧当初写给公司同事的rb系统使用说明和配置强制review的方法整理了一下发出来,希望能帮助到其他用户。
一、 工作流程
- 在本地代码做出一个修改。
- 为你新做的修改创建一个评审请求。
- 发布评审请求。
- 等到评审者的反馈。
- 评审没有问题,则在log-message中写清reviewID并提交变更至配置库,并且切换评审单状态为“submitted”。
- 评审有问题的,修改程序,需要重新更新DIFF文件(如果有),重新进行评审。
二、手动发起请求(推荐使用自动rbtools方式)
- 修改文件后,使用tortoise工具生成一个diff文件,方法是在文件或文件夹上右键点击选择
TortoiseSVN-> Create Patch
。 - 登陆系统,点击导航栏
New Review Request
,发起新的申请。 - 点击左侧你要上传的文件对应的svn库,点击右侧select上传你生成的diff文件。
- 复制或输入你修改的文件相对于svn库根目录的路径。
- 输入各项信息:
Summary
(必填):标题、总结,显示在review申请的题目上。
Description
(必填): 描述。
右侧:
Reviewers
(必填):审核人,在people
处点击,手动输入审核人的姓名或者用户名都可以,系统会在输入时自动搜索并显示提示。如果是提交给某一个组来审核,就在Groups点击进行指定,二者至少填写一项。
Bug:
本处填写bugZilla上的bug号。之后通过单击本数字可直接跳转该bug页。 - 最后可以查看request导航栏的最右侧的
Diff
,查看diff文件是否正常显示,如果所有配置项没有问题了,点击Publish
发布这个请求,你的评审人会收到指定邮件,你的评审人评审后你也会收到评审邮件,针对问题你可以进行修改,如果需要重新上传新的diff文件,请进入到该申请中,在request导航栏第二项Update
处点击Update Diff
来更新diff文件或者提交新的文件,比如截图之类的。 - 评审通过后,问题发起人应及时关闭问题,方式是在request导航栏第一项中点击
close->submitted
,手动关闭这个问题。
三、使用rbtools自动发起请求(推荐) - 安装python,安装结束后配置如下两个环境变量到系统path中,运行命令行命令“python”验证是否安装成功。(记得加分号)
C:\Python27
C:\Python27\Scripts
- 运行命令行命令
pip install rbtools
,安装rbtools工具,成功后输入命令“rbt”验证是否安装成功。 - 安装diffutil,安装后添加如下环境变量到系统path中。<