Posted on 2014 年 7 月 19 日

一个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发送一份提醒邮件。