一个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请求的页面。
在这个页面中,左侧选择我们的仓库地址(这些地址是管理员在后台进行配置的)。如果仓库地址太多,可以使用搜索功能。
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发送一份提醒邮件。
版权声明
本站文章、图片、视频等(除转载外),均采用知识共享署名 4.0 国际许可协议(CC BY-NC-SA 4.0),转载请注明出处、非商业性使用、并且以相同协议共享。
© 空空博客,本文链接:https://www.yeetrack.com/?p=940
近期评论