您的位置:首页 > 其它

SVN分支/合并原理及最佳实践

2016-06-20 14:28 363 查看
SVN是一种常用的版本控制工具,一种典型的项目代码实践方式是:

存在一个代码基线(Base Line)或称主干,不同的模块使用各自的分支进行功能开发,在开发完毕后合并回主干,准备交付。

基本概念:

变化集合(ChangeSets)

SVN使用变化集来描述和管理托管对象的版本变更,这里变更可以是文件文本内容的变化,目录树的改变或者元数据(metadata,附加信息,包含权限或自定义属性等)的修改等。整个代码仓库(Repository)使用全局的数字来标识版本(revision)。它既是代码库提交次数的统计,也是某个变化集的隐式标识。

可以通过诸如

svn log -r 9238

来获取该版本的变化信息

或者

svn diff -c 9238

来查看详细的变化记录(patch)

SVN的合并操作也是使用这些变化的信息来完成修改的合并

最佳实践:(建议使用1.6系列的最新客户端)

分支定期同步主干修改

分支定期从主干同步修改有助于提早发现冲突,同时降低分支合并回主干时的风险(与其他业务功能的冲突)

使用如下命令实现

cd my-working-branch

svn merge http://my-repo/trunk
该命令负责把从创建该branch后,trunk上所有的修改复制一份,然后应用到本branch上,因此重复进行merge会导致冲突

执行merge命令后,通过svn st可以查看文件变化状态,例如

  M     .

M      source.c

注意到当前工作目录"."也发生了变化,并且M标记在第二列,表明该目录的元数据发生了变化。这里是merge命令修改或创建了目录的svn:mergeinfo属性(可通过svn diff查看),用来记录已经合并过的代码线和版本(务必不要擅自修改该属性),以便后面再进行merge时,选定起始版本。(备注:svn:mergeinfo是SVN 1.5版本引入的特性,需要确定客户端和服务器版本支持该特性)

确定合并无误后,使用svn ci -m “merge trunk changes to branch”来提交修改

或者svn revert . -R 来回滚所有的改变

随后可以通过定期执行svn merge http://my-repo/trunk 
来获取trunk上面的更新,由于有svn:mergeinfo信息的存在,merge命令会仅合并该分支上没有的修改(不会产生冲突)

此外,执行merge命令时,可以指定--dry-run参数来预览修改(不修改任何本地目录的文件)

分支合并回基线

当分支功能开发测试完毕后,将分支代码合并回主线

cd trunk

svn up

svn merge --reintegrate http://my-repo/my-working-branch
完成从分支代码合并回trunk的操作。由于branch曾经merge过trunk的一些修改,因此branch上的变化集既包括自身branch独有的修改,也包括trunk上的修改,并且独有的修改往往不是在连续的版本区间。此时,通过--reintegrate参数,可以仅从branch上合并该branch上独有的修改回trunk,避免产生合并冲突。

完成分支合并后,一般会立即删除该分支,以避免循环合并,可以参见
http://stackoverflow.com/questions/102472/subversion-branch-reintegration-v1-5 http://stackoverflow.com/questions/3309602/subversion-branch-reintegration-in-v1-6 http://blogs.collab.net/subversion/subversion-merg
问题主要出在reintergrate到trunk后的修改如何向分支合并:如仍然向分支合并,则会出现冲突;但如果不向分支合并,则可能丢失在reintegrate时比如为解决冲突而做的一些修改

如果一定继续在分支上开发,有一种可trick的方法,需要对分支的svn:mergeinfo进行处理,手动标记reintegrate回trunk时提交的版本在该branch上为已合并(通过--record-only参数)
http://svnbook.red-bean.com/nightly/en/svn.branchmerge.advanced.html#svn.branchmerge.advanced.reintegratetwice
$ cd my-calc-branch

$ svn update

Updating '.':

Updated to revision 393.

$ svn merge --record-only -c 391 ^/calc/trunk

--- Recording mergeinfo for merge of r391 into '.':

 U   .

$ svn commit -m "Block revision 391 from being merged into my-calc-branch."

Sending        .

Committed revision 394.

其中r391为reintegrate回trunk时的提交。

一般不建议这样使用,因为一旦r391中包含了非reintegrate造成的修改,那么这个修改就会丢失。所以倒不如删除分支再建立一个同名的分支继续使用。

鉴于此,强烈不建议对svn:mergeinfo信息进行操作,除非可以确定不会造成修改的丢失

SVN合并管理机制

svn通过元数据属性svn:mergeinfo来管理分支间的合并操作

通过 svn propget svn:mergeinfo .         来获取当前目录的合并记录

此外,可以通过如下命令查看当前分支从另一分支的合并记录

cd my-repo/my-working-branch

svn mergeinfo http://my-repo/trunk
将展示如

r3

r4

r5

此外,可以通过--show-revs参数来展示其他信息,如--show-revs eligible 来显示适合从trunk合并过来的版本

如果需要,可以通过svn merge命令中的参数 --record-only 来将某些版本(通过-r指定)标记为已合并,这是一种通过工具来操作svn:mergeinfo的方法,比自己直接修改要可靠

使用svn merge来取消提交的修改

svn merge的一种极端用法是用来回滚已经提交的修改,即反向修改,例如想要取消r303的提交,可以指定--revision 303:302 或者--change -303

即:

cd trunk

svn merge -c -303 http://my-repo/trunk     来实现反向merge

确认无误后,使用svn commit来提交本地修改

注意:

假设提交后的版本是r350,那么通过r303-r349取出的仍然会是包含错误提交内容的文件(因为我们在r350进行的修改回滚),由于svn的使命是保证所有提交的信息不丢失,而且目前无法对已经提交的信息进行抹除(也许日后会提供svnadmin obliterate命令来进行永久删除操作),好在一般只关注一个文件的HEAD版本

恢复历史文件

一般来说,当一个分支完成开发并合并回trunk后,就可以删除了(svn delete URL -m "msg"),这时当需要恢复某些文件时,可以使用

svn log 

-v 输出附加信息

-l 限制输出的条目

--stop-on-copy 查看历史时不跨越不同的分支副本

当找到删除文件的revision后(包括文件修改状态为D的标识),假设在r808删除了source.c,则可以通过svn copy命令来进行恢复

cd some-working-copy

svn copy http://my-repo/trunk/source.c@807 ./source.c

通过svn st可以看到

A   +  source.c

通过这种方法,source.c会继承已删除文件原有的log(通过svn log可以持续追溯)(+表明重新加入SVN的版本调度),如果不希望再继承历史记录,则可以使用

svn cat http://my-repo/trunk/source.c@807 > ./source.c

svn add source.c

来全新添加这个文件

上述两种方式仅在本地工作副本生效(在提交之前),可以通过如下命令直接在代码仓库生效:

svn copy http://my-repo/trunk/source.c@807 http://my-repo/trunk/ -m "restore deleted file"

最后,还可以通过svn merge命令来回滚删除操作修改,通过这种方式的问题在于,如果删除文件的版本还包括其他修改,那么通过merge命令的回滚无法只对变化集的一部分进行操作(即在同一次提交中,不能只回滚其中文件删除的修改)

参考文献:
http://www.subversion.org.cn/svnbook/nightly/svn.branchmerge.basicmerging.html http://renial.iteye.com/blog/761183 http://www.cnblogs.com/cnblogsfans/archive/2011/02/16/1955808.html http://svnbook.red-bean.com/nightly/en/svn.branchmerge.advanced.html#svn.branchmerge.advanced.reintegratetwice
关于reintegrate后分支能否继续使用的讨论
http://stackoverflow.com/questions/102472/subversion-branch-reintegration-v1-5 http://stackoverflow.com/questions/3309602/subversion-branch-reintegration-in-v1-6 http://blogs.collab.net/subversion/subversion-merg
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: