reviewboard使用说明reviewboard使用说明.doc

REVIEWBOARD 使用说明 一、工作流程 Make a change to your local source tree. 在本地代码做出一个修改。 Create a review request for your new change. 为你新做的修改创建一个评审请求。 Publish the review request and wait for your reviewers to see it. 发布评审请求，评审者可以看到评审请求 Wait for feedback from the reviewers. 等到评审者的反馈。 If they’re ready for it to go in: Submit your change to the repository. Click Close ? Submitted on the review request action bar. 评审没有问题，则提交变更至配置库，并且提交评审单关闭评审任务 If they’ve requested changes: Update the code in your tree and generate a new diff. Upload the new diff, specify the changes in the Change Description box, and publish. Jump back to step 4 评审有问题的化，修改程序，需要重新更新DIFF文件（如有有的化），重新进行评审。 以上流程是PRE_COMMIT的评审方式，跟我们的实际开发方式不太一致，我们进行一些改变，具体如下： 编码人员开发完代码后，发起一个代码评审的同时需要将代码提高至配置库中，有助于评审者下载代码实际运行功能。 二、导航栏 Starred Reviews 担任过主角的评审任务 Outgoing Reviews 进行中的评审任务 Incoming Reviews 传递过来的评审任务（包含指定给自己的或者指定到自己所在的组的） To Me 指定给自己的评审任务 Watched Groups 自己监视的评审组内的评审任务 All My Requests 所有的自己的评审任务 三、补充说明 1、定制评审任务列信息 点击红色圈位置，在弹出框中进行设置。 2、 四、实际操作 1、登录 25/reviewboard/ 使用公司HOLD域中账号登陆。 2、产生差异文件 自己在客户端编写程序，编写完之后，需要生成差异文件， 注意：代码评审前不要提交新做的功能源程序，因为差异文件是基于配置库svn中版本来产生的，提交后再生成差异文件，也就没有差异了。除非重新改个文件名，当成一个新文件来产生差异。。 可以在修改的项目源代码目录点击鼠标右键-TortoiseSVN-Create Patch，见下图 出现如下界面 选中当前要评审的代码源文件，点击OK后，产生差异文件如下 注意： 产生差异文件时需要选择一个文件路径，如下图，这个文件路径可以放到本地文件系统的任意一个地方，不需要提交到配置库； 2）一旦差异文件已经生成，新做功能的源代码可以正常提交到配置库中了，已方便发布服务测试。 3、创建一个评审 选择配置库“Marzen”，填入创建patch时的相对路径，下图中填写/kyogaku_net/src/main/resources/mbis/kyogaku_net/def，也就意味着是在/kyogaku_net/src/main/resources/mbis/kyogaku_net/def目录下创建的patch，选择上一步生成的patch文件 点击上图中的Create Review Request后，出现如下界面，填写评审相关内容，重点是选择评审人，支持选择评审组，以及直接指定评审人，另外可以通过 view diff查看版本变动差异信息 最后点击PUBLISH发布这个评审 4、进行评审 使用评审人账号登陆 选择要评审的工单，点击进入下图，可以通过VIEW DIFF 查看差异变动情况 可以从上图中看出这次评审工单的所有源代码的变动情况，点击Review给出评审意见。 5、关闭或修正后重新评审 评审发起人登陆系统，在outgoging reviews栏中看到评审过的工单 点击进入 如果评审未发现问题，则SUBMITTED工单，评审完成，若有问题的化，则需要继续修改代码，重新产生diff信息，使用update diff功能更改版本差异变动信息，继续进行评审。直至关闭。 UPDATE DIFF 如下图 注意修正后重新发起评审，需要将之前的代码提交后，再进行修改，再产生