(C) 2010-2011 Alibaba Group Holding Limited.
|
|
|
6 在SVN资源历史记录中Post-Commit Request 8
7.1 强制刷新Groups、People、Repository的相关缓存 8
Tao-ReviewBoard V1.0.0使用手册
1 Tao-ReviewBoard插件解决的问题
为了使用ReviewBoard,用户不得不安装一系列软件,且安装过程非常繁琐和复杂;在使用ReviewBoard提交和更新Request时,用户必须使用复杂的命令来执行相关的操作。
Tao-ReviewBoard是在eclipse上开发的一款ReviewBoard插件。它很好的解决了安装和操作等问题,使reviewboard的使用更加方便。该插件目前支持ReviewBoard1.6及以上版本。现在,你已经不再需要在本地安装任何其它额外软件(甚至无需安装Subversion),也不再需要记住任何脚本和命令;在Eclipse中安装ReviewBoard插件后,提交和更新Request的操作将非常便捷,你只需要选中需要提交的代码或目录,然后右键Team进行相关操作即可完成Request的提交和更新(且支持Pre-Commit和Post-Commit方式)。Tao-ReviewBoard插件后续还将提供展示diff等诸多功能。
Tao-ReviewBoard插件的功能还在持续地丰富中。如果您在使用过程中有任何问题,或者有更好的建议,请联系淘宝:配置管理中心:千丫(qianya@taobao.com)。如果您希望与我们进行技术交流,可以联系淘宝:技术产品:智清(zhiqing.ht@taobao.com)、银时(yinshi.nc@taobao.com)。Tao-ReviewBoard插件(开源版)的官方网址是:http://code.taobao.org/p/tao-reviewboard/wiki/index/。您可以在该网站了解Tao-ReviewBoard插件的最新动态、发行报告、FAQ、安装和使用说明等。Tao-ReviewBoard插件的源代码地址是:http://code.taobao.org/svn/tao-reviewboard/,或直接访问如下网址浏览源代码:http://code.taobao.org/p/tao-reviewboard/src/。感谢Markus Knittig,Tao-ReviewBoard插件中Core模块功能的部分代码借鉴并摘录了Markus Knittig的ereviewboard插件(官方网址:https://github.com/mknittig/ereviewboard);感谢Subclipse项目团队,Tao-ReviewBoard插件目前暂时只支持Subclipse插件管理的Eclipse Project。
2 安装Tao-ReviewBoard插件
2.1 如何安装Tao-ReviewBoard插件
(2)安装完Subclipse Eclipse插件后,便可以安装Tao-ReviewBoard插件了。安装方法是(如下两种方法任选一种即可):
(2.1)离线安装。您也可以将源代码目录的/updatesite/plugins目录下的所有jar文件拷贝至Eclipse的dropins目录(或plugins目录),然后重新启动Eclipse即可。或者参考http://code.taobao.org/p/tao-reviewboard/wiki/index/ 页面相关说明下载离线安装包。
(2.2)在线安装。我们推荐您使用在线安装方式,这将极大方便您今后的在线升级。官方安装地址:http://abs.taobao.org/updatesite/,请通过Eclipse的Help > Install New Software直接安装,安装前请先勾选需要安装的模块(请勾选所有模块)。注意:在Help > Install New Software页面,请不要勾选 Contact all update sites during install to find required software。如果勾选了该项,插件安装将是一个漫长的等待过程。
2.2 如何卸载Tao-ReviewBoard插件
(1)离线安装后的卸载方法:直接在Eclipse的dropins目录(或plugins目录)删除Tao-ReviewBoard插件的jar即可。
3 配置ReviewBoard服务器并保存常用属性
使用ReviewBoard插件之前,您必须首先在首选项中配置服务器信息。
3.1 使用首选项配置服务器信息
可以通过"Windows->Preferences->Tao-ReviewBoard配置"打开首选项配置窗口对常用属性进行配置。
Server:如果配置了多台ReviewBoard服务器,则需要在这里指定提交Request时具体会使用哪一台服务器。注意:Server的格式必须形如http://reviews.your-domain.org,以http或https开头。User ID和Password请使用你的域账号和密码。
Groups、Peoples:如果设置了这些项,那么提交和更新Request时,无需每次都输入相关项的值。
3.2 功能高级配置
可以通过"Windows->Preferences->Tao-ReviewBoard配置->功能高级配置"定制一些高级功能。
Post-commit模式自动获取start版本。插件会通过svn的路径和文件和目录的版本自动获取文件/目录的创建版本。
分支路径下post-commit模式自动获取start版本:如果svn路径中包含branches路径,则在post-commit模式,自动获取start版本为分支创建版本。
3.2 页面显示高级配置
4 Pre-Commit方式提交或修改Request
图:Pre-commit方式提交或更新Request(页面显示高级配置中开启所有功能后的界面)
注:Tao-ReviewBoard插件已经支持多文件或文件夹跨越了多个不同Project的情况。如果是多Project提交,请确保这些项目的SVN Repository Root是同一个SVN地址。
在需要提交Request的代码处右键->Team->Pre-Commit Request To ReviewBoard,即可以Pre-Commit方式提交和修改Request。
可以指定比较版本(选填项)。未指定比较版本时,表示希望本地修改后的代码与SVN最新版本的代码比较;否则,表示希望本地修改后的代码与SVN仓库中的指定版本进行比较。
此外,您在提交Request之前,可以使用代码比较功能,使用方法是:双击界面中待比较的文件的文件即可。
5 Post-Commit方式提交或修改Request
图:Post-commit方式提交或更新Request(页面显示高级配置中开启所有功能后的界面)
注:Tao-ReviewBoard插件已经支持多文件或文件夹跨越了多个不同Project的情况。如果是多Project提交,请确保这些项目的SVN Repository Root是同一个SVN地址。
在需要提交Request的代码处右键->Team->Post-Commit Request To ReviewBoard,即可以Post -Commit方式提交和修改Request。
Post-Commit方式时,需要指定Start和Stop版本号。如果选中了多个文件和文件夹,插件会为所有选中的文件和文件夹生成diff文件并上传到ReviewBoard服务器。
Tao-ReviewBoard插件在处理用户手工填写的Start和Stop版本号时,插件的容错性非常智能化;如果填写的版本号过高或过低,插件将自动查找正确的版本号。
此外,您在提交Request之前,可以使用代码比较功能,使用方法是:双击界面中待比较的文件的文件即可。(目前暂时只支持文件比较,不支持文件夹比较功能)。
6 在SVN资源历史记录中Post-Commit Request
更多的时候,你可能希望在SVN资源历史记录处以Post-Commit方式提交或修改Request。具体方法是:
选中需要操作的代码或代码目录,右键Team->显示资源历史记录,即出现代码修改的历史日志记录。
或:直接从Eclipse的SVN资源库中打开的历史记录,也同样支持 Post-Commit Request。
选中需要对比的两个版本号(也可以只选中一个版本号,待弹出提交界面后,手动修改Start和Stop版本号),即可以使用Post-Commit的方式提交或修改Request。如下图所示:
图:资源历史记录中Post-commit方式提交或更新Request
7 其它技巧
7.1 强制刷新Groups、People、Repository的相关缓存
"Windows->Preferences->Tao-ReviewBoard配置->功能高级配置"打开首选项配置窗口,点击"重置"按钮即可重置配置的所有服务器的缓存信息。
8 常见问题答疑
1.安装Tao-ReviewBoard插件后,右键Project Properties,找不到相应的菜单项,这是怎么回事?
非Subclipse关联的Project不会出现Tao-ReviewBoard的任何菜单。如果右键后,找不到功能菜单,可能是因为您的项目不是SVN检出的项目。
3.无法提交request,提交后报异常,或者diff有乱码无法正常展示?
以我们的经验,提交Review后插件提示错误信息;或者并未提示错误信息,但是浏览diff时显示乱码,一般来说,是由于如下原因中的某种或某几种:
3.1.请确认您在首选项中正确地配置了服务器信息、用户名和密码;且您确保ReviewBoard服务器正在正常运行。
3.2.请先检查您的代码所在的SVN路径或Eclipse的当前workspace、project所在目录是否存在中文。如果存在,请更改为英文。
3.5.如果还是出现diff无法正常展示,请通过首选项指定本次提交的编码格式(假设你已经明确知道本次提交文件的编码格式)。
3.6.如果还是存在乱码,请打开Eclipse的window->preferences->Team->SVN;更换一个SVN接口(SVNKit或JavaHL)试下。推荐使用JavaHL接口。如下图: