SVN基本使用
开发中的实际问题
1.1小明负责的模块就要完成了,就在即将Release之前的一瞬间,电脑突然蓝屏,硬盘光荣牺牲!几个月来的努力付之东流——需求之一:备份!
1.2这个项目中需要一个很复杂的功能,老王摸索了一个星期终于有眉目了,可是这被改得面目全非的代码已经回不到从前了。什么地方能买到哆啦A梦的时光机啊?需求之二:代码还原!
1.3小刚和小强先后从文件服务器上下载了同一个文件:Analysis.java。小刚在Analysis.java文件中的第30行声明了一个方法,叫count(),先保存到了文件服务器上;小强在Analysis.java文件中的第50行声明了一个方法,叫sum(),也随后保存到了文件服务器上,于是,count()方法就只存在于小刚的记忆中了——需求之三:协同修改!
1.4老许是一位项目经理,我会告诉你他把每一个版本都保存一份吗?我会告诉你这些工程里其实有很多文件都是重复的吗?我会告诉你老许为这事删了很多电影吗?——需求之四:多版本项目文件管理!
1.5老王是另一位项目经理,每次因为项目进度挨骂之后,他都不知道该扣哪个程序员的工资!就拿这次来说吧,有个该死的Bug调试了30多个小时才知道是因为相关属性没有在应用初始化时赋值!可是二胖、王东、刘流和正经牛都不承认是自己干的!——需求之五:追溯问题代码的编写人和编写时间!
1.6小温这两天幸福的如同掉进了蜜罐里,因为他成功的得到了前台MM丽丽的芳心,可他郁闷的是这几天总是收到QA小组的邮件,要求他修正程序中存在的Bug,可他自己本地电脑上是没有这些Bug的,“难道我的代码被哪个孙子给改了?”。是的,小温没来的时候,丽丽是QA小组小郑的女朋友啊!——需求之六:权限控制!
版本控制简介
2.1版本控制[Revision control],最初来源于工程设计领域,是维护工程蓝图的标准做法,能追踪工程蓝图从诞生一直到定案的过程。是一种记录若干文件内容变化,以便将来查阅特定版本修订情况的系统。
2.2Subversion就是一款实现版本控制的工具软件,通常也称为版本控制器,简称SVN。Subversion是Apache软件基金会组织下的一个项目。
2.3Subversion的优良特性
①目录版本控制
CVS只能追踪单个文件的历史,但是Subversion实现了一个“虚拟”文件系统,可以追踪整个目录树的修改,文件和目录都是版本控制的,结果就是可以在客户端对文件和目录执行移动和复制命令。
②原子提交
提交要么完全进入版本库,要么一点都没有,这允许开发者以一个逻辑块提交修改。
③版本控制的元数据
每个文件和目录都有一组附加的“属性”,你可以发明和保存任意的键/值对,属性也会像文件内容一样被纳入版本控制。
④可选的网络层
Subversion在版本库访问方面有一个抽象概念,利于人们去实现新的网络机制,Subversion的“高级”服务器是 Apache 网络服务器的一个模块,使用 HTTP 的变种协议 WebDAV/DeltaV 通讯,这给了 Subversion 在稳定性和交互性方面很大的好处,可以直接使用服务器的特性,例如认证、授权、传输压缩和版本库浏览等等。也有一个轻型的,单独运行的 Subversion 服务器,这个服务器使用自己的协议,可以轻松的用 SSH 封装。
⑤一致的数据处理
Subversion使用二进制文件差异算法展现文件的区别,对于文本(人类可读)和二进制(人类不可读)文件具备一致的操作方式,两种类型的文件都压缩存放在版本库中,差异在网络上双向传递。
⑥高效的分支和标签
分支与标签的代价不与工程的大小成比例,Subversion建立分支与标签时只是复制项目,使用了一种类似于硬链接的机制,因而这类操作通常只会花费很少并且相对固定的时间,以及很小的版本库空间。
2.4SVN的工作原理:采取客户端/服务器模式——在服务器的版本库中保存项目文件的各个版本,所有参与协同开发的程序员在自己本地电脑上保存一个工作副本。SVN支持程序员将本地副本更新到服务器端的最新版本,也支持将本地副本的最新改变更新到服务器端,而且后面的更新不会覆盖前面的更新,而是作为一个新的版本被保存下来——SVN甚至支持将本地工作副本恢复为服务器端保存的某一个历史版本。
2.5SVN基本操作
①检出(checkout):将一个服务器端创建好的项目整个下载到本地,这是到项目组后参与开发的第一步,只需执行一次。
②更新(update):将本地文件更新为服务器端的最新版本,通常为每天上班时或修改公共文件之前执行一次。
③提交(commit):将本地修改提交到服务器端。通常每天下班前或每实现一个功能、完成一个模块时执行一次。
Subversion安装与配置
3.1安装服务器端程序
①服务器端程序版本
目前Subversion的最新版本是 1.9.0-alpha2,这是一个测试版。官方网站推荐使用的版本是1.8.9,原话是:The best available version of Apache Subversion is: 1.8.9
②下载源码包
Apache组织自己维护更新的只是Subversion的源码,各个版本的源码包的下载地址是:http://subversion.apache.org/download/
Subversion源码是使用C语言开发的。
③下载二进制安装包
Subversion在不同平台下的二进制包是由不同组织构建实现的,Windows平台下的二进制包实现情况如下:
所以,服务器端程序的下载地址可以使用:
http://sourceforge.net/projects/win32svn/files/latest/download
下载到的文件是:Setup-Subversion-1.8.9-1.msi
④双击运行Setup-Subversion-1.8.9-1.msi
不整合Apache服务器可以忽略此选项
⑤安装程序会自动配置Path环境变量
D:\DevInstall\Subversion\bin
所以bin目录下的可执行文件可以在任意目录下运行。
⑥验证是否安装成功
在命令行输入:svn --version
看到如下信息就表示服务器端程序安装成功
3.2配置版本库
①为什么要配置版本库?
Subversion是将文件数据信息保存到版本库中进行管理的,为了满足用户的不同需求,Subversion允许用户对版本库目录进行定制。
②在一个非中文无空格目录下创建一个文件夹,作为版本库的根目录。
例如:D:\DevRepository\Subversion
③在版本库根目录下创建与具体项目对应的子目录——这样做的目的是使一个SVN服务器能够同时管理多个项目,而不是为每一个项目搭建一个SVN服务器——这显然太浪费资源了。
例如:D:\DevRepository\Subversion\CRM
D:\DevRepository\Subversion\ERP
D:\DevRepository\Subversion\OA
④创建版本库
命令格式
⑤版本库目录结构
版本库创建成功后会在指定目录下产生如下的目录结构
3.3启动服务器端程序
①SVN服务器必须处于运行状态才能响应客户端请求,帮助我们管理项目文件。所以我们必须将SVN服务器启动起来。启动SVN 服务器有两种方法,一个是命令行方式,一个是注册Windows服务。
②命令行方式
[1]命令格式
[2]验证服务是否启动
SVN服务监听3690端口,打开一个新的cmd窗口,使用netstat -an 命令查看3690端口是否被监听
[3]命令行方式的缺陷是:只要运行服务器端程序的命令行窗口一关闭,服务就停止了,很不方便,而且每次开机都需要手动启动。
③注册Windows服务
[1]将SVN服务端程序注册为Windows服务,就可以让SVN服务随系统一起启动,克服了命令行方式的不足。
[2]注册Windows服务需要利用XP、2000以上系统自带工具Service Control,执行文件是sc.exe,注意这个命令不是SVN的命令。
[3]命令格式
[4]binpath组成结构说明
[5]关于“版本库目录”
[6]最终命令举例
●在Win7及以上系统中,运行该命令需要管理员权限,否则会得到如下错误提示
●在防火墙或电脑卫士提示阻止时,选择允许
●此时查看当前系统中的服务,可以看到我们刚刚创建的服务,但此时它还没有启动,如果创建失败,需检查sc命令是否正确
●启动此服务
●打开命令行窗口运行netstat –an查看3690端口是否被监听
●如果启动失败,那很有可能是binpath中的内容有错误,此时只能将已经创建的服务删除,重新创建。
●删除服务之前,最好先停止服务。sc stop 服务名
●删除、启动、停止服务同样需要管理员权限
使用命令行模式访问SVN服务器
4.1检出
①首先进入自己的工作目录,例如:D:\DevWorkSpace\SVNSpace
②运行svn checkout命令,命令格式如下
③工作副本
运行checkout命令后进入MyERP目录,看到里面什么都没有。真的什么都没有吗?不是的。检出命令会在这一目录下创建一个隐藏目录.svn,用来保存与服务器交互的重要信息,其中包括从服务器端取回的最新版本信息、文件状态、更新时间等。SVN正是以此为依据判断当前目录中文件的状态。所以这个隐藏目录千万不要删除或修改其中的内容——完全无视它的存在吧。如果服务器端保存的文件可以视为一个“正本”,那么每个开发人员检出到本地目录的文件可以视为“副本”,通常称为工作副本。
4.2提交
①进入D:\DevWorkSpace\SVNSpace\MyERP目录
②创建一个文件test.txt
③执行svn commit命令,运行结果是
说明一个文件必须纳入版本控制才可以提交到服务器端。
④执行svn add命令,将test.txt纳入版本控制
⑤再次执行svn commit命令此时要求附加日志信息
⑥使用-m参数附加日志信息
原因是没有权限
⑦暂时先开启匿名访问权限
[1]进入对应的版本库目录下的conf目录:D:\DevRepository\Subversion\ERP\conf
[2]打开svnserve.conf
[3]将第19行的# anon-access = read改为anon-access = write,也就是去掉“# ”,将read改为write。注意前面不要留空格,一定要顶格写。
[4]不需要重启SVN服务,甚至命令行窗口都不需要重新打开。
⑧重新执行提交命令
说明提交成功了。
⑨其实svn commit命令最后可以不指定具体文件,此时表示提交当前工作副本中的所有修改。
4.3更新
①将服务器端文件检出到一个新的目录,模拟另外一个终端
②回到MyERP目录,对test.txt文件修改后提交。
③进入TomERP目录
④执行svn update命令
这样我们就可以在TomERP目录下看到MyERP目录下提交的修改。
⑤思考:更新和检出的相同点和不同点分别是什么?
工作副本中文件的几种状态
①没有修改,现行版本
本档案在工作目录中没有被修改,而且自当前版本之后,其他终端也没有任何该文件的修改被提交到服务器,即当前工作副本的版本和服务器端最新版本是一致的。对它执行svn commit和svn update都不会发生任何事。
②本地修改, 现行版本
这个文件被修改过,但这个修改还没有提交到服务器,而且自当前版本之后,其他终端也没有任何该文件的修改被提交到服务器,所以当前工作副本的版本和服务器端最新版本仍然是一致的。由于有尚未送交回去的本地修改,所以对它的 svn commit会成功提交你的修改,而 svn update 则不会作任何事。
③没有修改,过时版本
这个文件没有修改,但是版本库中有其他终端提交的修改。此时当前工作副本的版本比服务器端的版本落后了,我们称之为“过时”。对当前文件的 svn commit 不会发生任何事,而 svn update 会让工作目录中的文件更新至最新版本。
④本地修改,过时版本
服务器端存在没有更新到本地的修改,导致当前版本过时。如果这个文件在本地有未提交的修改,则无法提交,对它执行svn commit 会产生“out-of-date”错误。
此时应该先尝试更新本地文件。更新时SVN会尝试将服务器端的更新与本地文件进行合并,合并的结果有两种可能:一个是服务器端和本地修改位于文件的不同位置,合并成功;另一个是服务器端的修改正好和本地修改位于同一个位置,发生冲突。
在Eclipse中安装SVN客户端插件
方法一:Eclipse插件应用市场
在Eclipse中访问Eclipse Marketplace Client可以搜索Subversion,下载插件,按提示安装即可。
方法二:使用压缩包
如果不能联网可以使用下载好的插件压缩包eclipse_svn_site-1.10.5.zip,这个压缩包是从http://subclipse.tigris.org/网站(subclipse是这款Eclipse插件的名称)上下载的。安装方法是:
①解压eclipse_svn_site-1.10.5.zip中的features和plugins这两个目录
②将features和plugins复制到Eclipse安装目录/dropins/eclipse_svn_site-1.10.5下
③重启Eclipse
④进入Eclipse依次打开Window→Preferences→Team→SVN,看到如下界面即说明SVN插件安装成功
创建资源库位置
①切换到透视图SVN资源库研究
②创建资源库位置
此时可以查看版本库中的文件及目录结构
检出
①检出分两种情况
<1>从服务器端获取到的是一些零散的文件,不能作为项目检出
此时会弹出一个新建项目向导,之所以会这样是因为我们需要创建一个项目来保存从服务器端取回的文件
<2>从服务器端获取到的是一个完整的项目,例如
此时必须作为项目检出
项目从服务器检出后,会成为一个工作副本,根目录下会自动创建.svn隐藏目录
提交
①新创建文件后,文件图标上会以“?”标识,表示该文件尚未纳入版本控制
②在新创建的文件上点右键→Team→添加至版本控制,这样文件图标上会显示“+”,表示当前文件已纳入版本控制,但还未提交至服务器。
③在要提交的文件上点右键→Team→提交…会提交文件,在弹出的对话框中可以不填写日志。文件提交后,图标会变为“金色的圆柱体”表示当前文件的版本和服务器端一致。
④文件修改后图标会变为“*”,表示当前文件或目录包含未提交的修改。
更新
①更新整个项目时可以在项目上点右键→Team→更新
②更新某个具体的文件时,可以在文件上点右键→Team→更新
共享项目
①在Eclipse中创建的新项目想要发布到SVN服务器端,可以通过“共享”项目实现
②在项目上点右键→Team→Share Project…→选择一种版本控制工具
选择一个资源库位置
切换到Team Synchronizing透视图,选择项目中要提交的内容,通常是项目中的全部内容
回复历史版本
①在需要回复的文件上点右键→Team→显示资源历史记录→得到如下界面
②选择某一个历史记录点右键→获取内容。文件就会恢复到指定版本的状态,同时图标变为“*”。
③获取历史记录时,如果出现如下错误提示
可以通过将对应版本库中的svnserve.conf文件中的anon-access设置为none解决。
解决冲突
①什么情况下会发生冲突
<1>两个开发人员,Harry和Sally,分别从服务器端下载了文件A。
<2>Harry修改之后,A变成了A’,Sally修改之后,A变成了A’’。
<3>Harry先一步提交,使服务器端文件的版本也变成了A’
<4>Sally本地的文件A’’已经过时了,此时她已无法提交文件,服务器会要求她先进行一次更新操作。
<5>此时Sally的更新操作有两种可能
(1)Sally所做的修改与Harry不是同一个位置,更新操作尝试合并文件成功。
(2)Sally所做的修改与Harry恰好是同一个位置,更新操作尝试合并文件失败,发生冲突。
<6>发生冲突后,本地工作副本会发生如下变化
(1)文件A中的内容发生如下改变
其中,从<<<<<<< .mine到=之间是发生冲突时本地副本的内容。从=到>>>>>>> .r14是发生冲突时服务器端的最新内容。注意这里r后面的数字是发生冲突时服务器端的版本号,有可能是任何整数值,r14只是一个例子。
同时文件图标变成一个“黄色的!”。
(2)与冲突文件同目录下新增文件,扩展名为.mine,其内容是发生冲突时本地副本的文件内容。
(3)与冲突文件同目录下新增文件,扩展名为.r小版本号,例如MyCRM.java.r13,其内容是冲突发生之前,服务器端的文件内容,可以作为解决冲突的参照。
(4)与冲突文件同目录下新增文件,扩展名为.r大版本号,例如MyCRM.java.r14,其内容是冲突发生时,服务器端的文件内容。
②解决冲突
(1)在冲突文件上点右键→Team→编辑冲突…→出现如下界面
以对比的方式将本地内容与冲突内容显示出来,其中左侧为本地内容,右侧为冲突内容。其中本地内容是可以修改的。
(2)根据需要和实际情况将本地内容更正——这个过程很可能需要牵涉冲突的两位开发人员进行必要的沟通——机器与程序目前还不能完全取代人工智能。更正后文件图标会变成一个“四角形”,同时冲突文件内的<<<<<<< .mine、=======以及>>>>>>> .r14等标记都会被去掉。
(3)在冲突文件上点右键→Team→标记为解决
此时.mine文件和.r版本号文件都会被自动删除,冲突文件的图标变为“*”,表示可以提交。
(4)提交文件,文件图标变为“金色圆柱体”。
单一版本库权限配置
5.1匿名访问:前已述及。
5.2授权访问
①要设置授权访问就需要创建用户,并为用户设定权限
②打开授权访问的配置
[1]打开D:\DevRepository\Subversion\ERP\conf\svnserve.conf
[2]将第19行anon-access = write注释掉:# anon-access = write
表明该版本库不接受匿名访问
[3]将第20行# auth-access = write注释打开:auth-access = write
表明该版本库使用授权访问
[4]将第27行注释打开:password-db = passwd
表明使用同目录下的passwd文件保存用户信息
[5]将第36行注释打开:authz-db = authz
表明使用同目录下的authz文件保存权限信息
[6]打开passwd文件创建用户
[7]打开authz文件:#后面注释的是例子
<1>创建用户组
<2>指定路径,给用户和用户组授权
<3>权限的继承性:父目录设置的权限,对子目录同样有效——除非子目录进行了更为具体的设定
这个例子表示当前版本库下的subDir目录只有userOther有读写权限,其它用户无任何权限
TortoiseSVN
10.1TortoiseSVN简介
TortoiseSVN是一个Windows下的版本控制系统Apache™ Subversion®的客户端工具。
10.2TortoiseSVN的优良特性
①外壳集成
TortoiseSVN 无缝地整合进 Windows 的外壳(例如资源管理器)。
②重载图标
每个版本控制的文件和目录的状态使用小的重载图标表示,可以让你立刻看出工作副本的状态。
③图形用户界面
当你列出文件或文件夹的更改时,你可以点击任意版本查看提交注释。也可以看到更改过的文件列表 - 只要双击文件就可以查看更改内容。
提交对话框列出了本次提交将要包括的条目,每一个条目有一个复选框,所以你可以选择包括哪些条目。未版本控制的文件也会被列出,以防你忘记添加新文件。
④Subversion 命令的简便访问
所有的 Subversion 命令存在于资源管理器的右键菜单,TortoiseSVN 在那里添加子菜单。
10.3TortoiseSVN 的历史
2002年,Tim Kemp 发现 Subversion 是一个非常好的版本管理系统,但是缺乏一个好的图形界面客户端程序。做一个与 Windows 外壳整合的 Subversion 客户端程序的想法是受一个叫 TortoiseCVS 的 CVS客户端程序所启发的。Tim 研究了 TortoiseCVS 的源码并以此为 TortoiseSVN 的基础。他开始运作这个项目,注册了域名 tortoisesvn.org 并且将源码放在了网上。
就在同时, Stefan Küng 正在寻找一个好用的并且免费的版本控制系统。他找到了 Subversion 和TortoiseSVN 的源码。因为 TortoiseSVN 还不能使用,他加入了项目并开始编码。很快,他就重写了现有的大部分代码并开始添加命令和功能,到了某个时段,最初的代码已经都被改写了。
由于 Subversion 变得越来越稳定,它吸引了越来越多用户,他们同时也开始使用 TortoiseSVN 作为Subversion 的客户端程序。用户数量快速增长(并且每天还在增长)。这时候,Lübbe Onken 提出帮助项目提供精美的图标和 TortoiseSVN 的标志。现在他负责照看网站和管理多语言翻译。
10.4TortoiseSVN安装
①下载安装程序:http://tortoisesvn.net/downloads.html
Win32位:TortoiseSVN-1.8.7.25475-win32-svn-1.8.9.msi
Win64位:TortoiseSVN-1.8.7.25475-x64-svn-1.8.9.msi
Win32位语言包:LanguagePack_1.8.7.25475-win32-zh_CN.msi
Win64位语言包:LanguagePack_1.8.7.25475-x64-zh_CN.msi
②以Win32位为例