本文目的
让未使用过版本控制器软件或者未使用过subversion软件的人员尽快上手。
subversion的使用技巧很多,这里只总结了最小使用集,即主要的基本功能,能够用来应付日常工作。
因此不涉及subversion服务器端的搭建和配置。
为什么要使用版本控制
当多人共同开发同一个软件时,会涉及源代码的共享以及带来的相关问题,比如追究某个代码是由谁在什么时间修改的。
下面列出版本控制带来的好处:
- 为团队提供了所有项目文档的回退按钮,个人IDE工具只能提供某个文件的回退按钮,而不能做到,比如回退到2008年6月12日下午3点10分时的所有项目文件;
- 支持多个开发人员在可控的方式下为相同的代码工作;
- 版本控制系统保存了文档在过去的各个改动,便于查找是谁,在何时,因为什么修改了文档;
- 支持在文档的主线上同时有多个版本(版本的分支和合并是版本控制的主要手段,一些开发团队仅仅是简单的共享代码主干);
- 支持查询在某个时点上项目各个文档的状态,可用于研究生产效率等(比如,统计项目哪个时期代码提交最活跃,以及每个人的代码提交频次等等),也可用于对以前的软件发行版的再发行(比如,以前构建的2.0版本的安装包丢失了,那么可以通过版本控制器记录的历史重新回溯到那个版本,然后重新构建出安装包)。
为什么使用subversion
首先,考虑的是使用免费开源和轻量级的版本控制器。
第二,要求使用比较广泛,可选的有cvs和svn。
这里选择svn,主要考虑是比较好集成apache使用,提交代码支持原子级操作(即,比如提交3个文件,如果因为网络或者其他原因,上传2个文件后中断,svn能做到服务器端回滚到提交前的状态,而cvs做不到这点,需要手工检查和恢复)。
subversion的程序构成
subversion程序,和mysql很类似,是c/s结构的,有客户端和服务器端。服务器端和客户端都是通过命令行方式启动和执行的。本文只会使用到客户端的命令。
第三方提供了各种图形界面的客户端工具,比如eclipse插件subclipse,windows图形界面工具tortoiseSVN。这些后面会提到它们的基本使用。
subversion资源
- subversion官方网站:http://subversion.tigris.org/
- subclipse官方网站:http://subclipse.tigris.org/
- tortoiseSVN官方网站:http://tortoisesvn.tigris.org/
- 使用subversion进行版本控制中文版在线版本:http://www.subversion.org.cn/svnbook/
安装subversion
有关subversion和subclise的安装暂略,因为目前提供的虚拟机开发环境已经安装和配置。
tortoiseSVN,可到官方网站上下载最新版本的windows安装包,默认安装,不需要做其他设置,安装后需要重启计算机。能在资源管理器中鼠标右键菜单看到如下图所示条目,就说明安装成功。
使用subversion
日常工作中使用subversion仅仅是几个命令或者操作,并不复杂。但是它内部的一些机制需要逐渐去理解。
检出代码
在刚开始进入一个开发队伍的时候,已经有版本控制和软件项目,使用的第一个命令往往是检出(checkout)代码。或者当使用和研究开源软件的时候,也是第一个要用到这个命令。这个命令的作用是把项目的源代码下载到用户本地,并且带有版本控制信息。
比如,执行以下命令获取一个项目的源代码:
svn cohttp://easymorse.googlecode.com/svn/trunk/vfs.demo/
这个命令将在本地当前目录建vfs.demo目录并将该服务器目录下的所有文件下载到本地,并且,会生成隐藏文件.SVN目录,用于记录版本控制信息。
tortoiseSVN有图形界面的检出操作,但是命令行方便快捷,建议使用命令行。
如果使用eclipse并安装了subclipse插件,可以通过插件导入项目。
然后,
选择或者新建资源库位置,
选择资源库中的项目目录。
然后,就可以完成(finish)了。
初始导入
何时使用初始导入,比如,对于java开发人员来说,在eclipse中编写了一个项目,并决定把项目共享到版本控制器上,这时就需要初始导入操作了。
以下以subclipse为例说明初始导入的步骤。
第一步,选择share project,共享你的项目:
选择通过svn共享项目:
填写svn提交的url:
这个url,需要subversion的管理员告知你,还有用户名和密码。如果想练习一下,google提供了免费的svn,你可以通过:http://code.google.com 申请项目,这样就会有类似我上面的url和权限。
然后可以直接点击finish,完成初始提交。选择next,可以做定制模块名和初始提交的信息,一般不需要。
如果你的svn服务器使用了https协议,需要接受一个数字证书,一般选择永久接受。
之后,会要求输入用户名和密码。建议勾选保存密码,否则会很麻烦。
这样,再看项目,会发现条目上多了问号,这时需要选择哪些目录和文件需要提交,哪些需要忽略,比如生成的class文件等。
选择需要忽略的文件或者目录,这时需要切换到导航视图下才能看到所有文件和目录:
从导航视图看到的情况:
选中需要忽略的目录和文件,操作svn:
然后提交整个项目即可。有关提交的操作见下文。
更新项目
项目在提交前,应该先做更新项目操作。比如有一个文件a.txt,已经提交到svn中,这样,可能有其他用户提交了新的改动到a.txt,你现在又修改了a.txt,准备提交你的改动。先操作更新a.txt,这样如果该文件在svn服务器已经改动,会将改动加入到当前本地的a.txt中。
在subclipse中的操作:
提交代码
提交代码,一般会级联当前目录下所有改动的内容。
删除代码
对于不再使用的代码,可以直接删除掉,比如通过windows删除文件,通过ubuntu的rm命令或者通过eclipse的delete功能,然后提交项目,subclipse会知道哪个文件被删除了,并将这个变化通知给svn服务器。
还原代码
如果代码做了改动,可以是多个文件,也可以删除了文件或者新增了文件,但是没有提交到svn服务器,可以通过还原功能恢复到改动前的样子。
版本的分支与合并
版本的分支和合并,是版本控制的核心功能。
比如,软件通过版本的分支,将项目分配给多人做分工开发,通过版本合并,将这些分工实现的代码合并到新的版本中;或者,修改代码bug的时候,可以先打出一个版本分支,保留出现bug的版本,比如分支版本名称为pre_fix_bug_2201,这里2201表示bug的代号,然后针对这个分支做修改fix这个bug,再将修改后的内容提交到一个新的分支版本,比如post_fix_bug_2201,再到适当时候将这个分支合并到代码主干中去。
以上说了一下版本分支与合并的用途,这里简单说一下svn版本分支合并的基本原理。
首先是版本分支,实际上是将当前版本“copy”到分支上,非常类似windows下,将某个目录的快捷方式复制到其他路径。这种copy,可以说是轻量级copy或者叫廉价copy,不是复制版本内容,而是做一个内部的引用。这样的copy很快,对服务器也没有空间上的开销。
版本的合并,是svn开发中的难点,当做版本合并的时候,服务器会试图智能的合并同一个文件的不同版本,可能会带来版本冲突,这需要操作者做手工的处理,消除版本冲突。合理分工的项目应该可以通过管理手段尽量避免这种情况。
以下是通过subclipse演示版本分支的操作。首先,项目文档应该已经全部提交,然后,选择
然后,填写url,一般是在tags/目录下:
然后默认选项,next即可,然后选择finish按钮。在svn的相应路径下就会有一个同名的项目。
打分支,实际上就是建立了一个项目的轻量级copy。
如何从版本的一个分支切换到另外一个分支,这也是很重要的,它能帮助你轻松在不同的项目版本中自动切换,而不必在eclipse里维持多个项目。
选择要切换的项目版本路径,或者直接输入亦可。
然后点击ok后,项目即可切换到该版本下。
在分支上做了改动,并且已经提交(一般tags目录下的项目约定是只读的,不建议改动,这里是为了举例方便),那么,可以将这个版本合并到trunk(主干)代码中,让主干也拥有最新的代码。
选择需要合并的源,比如从tags上面一个版本,合并到主干(trunk)代码中。
之后,需要设置一些合并的特性,这里默认配置即可。
执行完毕后,会有一个合并报告,可见没有出现冲突情况。
这时候看源代码,可以发现有改动,这些改动就是合并过来的代码。
改动如果没有问题,就可以提交,这样就完成了一次版本的合并工作。
“还原”已经提交的改动
如果文档没有提交,还原是很容易的,只需执行还原(revert)就可以了。有时候,已经提交了代码,结果发现了问题,需要回退到之前提交的版本,就不是很容易了。
这时候的还原,其实是将以前的某个修订本(revision)覆盖当前的本地工作拷贝。然后再提交这些改动,成为新的修订本。
下面演示一下。
首先提交了一个版本的改动,这是以后需要还原回来,这里,为了以后还原方便,要在提交的消息中说明改动了什么。(这一步在开发中是必须的,是纪律)
下面,再修改一下项目,然后提交一次,这里故意增加一个文件。
提交以后,后悔了,想恢复到前一个修订版。虽然可以通过版本号进行覆盖还原,但是一般人是无法记忆这个版本号的,另外就是实际情况往往更复杂,不会像示例中那样是相邻的两个修订版。
所以提交修订版时的注解消息就显得特别重要。
这时可以通过svn的日志功能查看到这些版本和它们的注释消息。
看到历次版本的消息内容。
这样,根据注释,我们很容易找到需要还原到以前的那个修订版。如果不放心,我们还可以根据上下文菜单,对比两个修订版的区别。
看比较结果。可以看出,增加了一个文件,另外一个文件中有一处差异。
那么,可以确定是从125修订版恢复(还原)。
更改后的项目,相当于用125修订版还原了126修订版。
可以看到126版本添加的文件不见了,另外VfsDemo.java文件也还原到125版本的内容。这时提交将成为127版本,这个版本其实就是125版本。算是还原了主干(trunk)上的代码。
刷新历史,可以看到修订版已经生效。