一个code review请求,至少包括”summary”,”description”, 一些”reviewers”。一个code review请求通常包含diff文件,如果code review请求中只有附件,那个这个diff文件就更有用了。

有两种新建code review请求的方式:通过web界面或者使用rbt post工具。推荐使用后者。

使用rbt post新建code review请求

 

RBTools实际上就是一些列命令行命令,它们可以被安装在不同终端上。RBTools中有很多工具包,但是最重要的就是rbt post,它可以检测源码路径,将修改post到Reivew Board中。

使用Web界面新建Code Review请求

点击“左上角”的”New Review Request”链接,就会打开新建code review请求的页面。

新建code review请求

在这个页面中,左侧选择我们的仓库地址(这些地址是管理员在后台进行配置的)。如果仓库地址太多,可以使用搜索功能。

Pre-commit code review请求

使用Pre-commit这种review方式,代码没有真正提交到仓库。所以在新建时,我们必须创建一个diff文件。

我们提供的diff文件,必须是unified格式的,并且要有revision信息。

有了diff文件,我们选择一个仓库地址,多数情况下,这时就已经创建完毕。但是有些类型的仓库,还需要我们提供额外的信息。

Perfoce repositories
+ Change Number
Subversion repositories
+ Base Directory
这个是指生成diff文件的相对路径。例如,我们check出trunk/reviewboard这个svn地址中的代码,本地文件夹为reviewboard,这个文件夹就是我们生成diff文件的路径,那么这个base directoty就是/trunk/reviewboard

当然这个Base Directory也取决于管理员配置的repoo地址,如果有问题,联系管理员处理。

Post-commit code review请求

使用web界面也可以新建post-commit类型的code review。但是只适用于部分源码仓库。

当选择了代码仓库后,页面的下半部分会出现”New Review Request for Committed Change”,我们可以在单选框中选择”trunk”或者某个branch。选择后,下面就会列出历史版本信息。选择某个版本,Review Board就会下载diff文件,并且新建一个code review请求,我们再指定评审者,发布即可。

如果选择的代码版本已经存在评审请求,我们再选择这个代码版本,就会跳到已经存在的评审请求中,而不是重新创建一个。

附件评审

如果我们只想评审某个文件,那我们就不必再选择代码仓库了,选择”None – File attachments only”这个即可。请求创建后,我们不能添加diff文件,只能上传附件,填写必须的表单,发布。

创建请求结束

不管是通过web界面还是rbt post命令,我们post请求后,都会先产生草稿,需要发布,别人才能看到。

发布前,需要填写”summary”,”description”和”reviewers”,有些字段的自动筛选和仓库类型,使用review board的用户,和默认审批者有关。review board管理员可以在后台设置默认审批者。

如果要上传附件,可以通过update > Add File菜单添加或者直接将文件拖到浏览器页面中。

在新建请求的过程中,我们可以点击”View Diff”来查看预览diff。上传新的diff文件,来替换旧的diff文件。

完成后,点击Publish Review Request链接就可以发布出去。我们还可以点击Discard链接,来丢弃这个请求。

取决于配置,请求发布时,系统会向reviewer发送一份提醒邮件。