SVN使用指南Windows环境版专家讲座

SVN使用指南

——Windows环境版SVN使用指南Windows环境版专家讲座第1页内容概要问题与案例SVN介绍应用环境客户端安装简单应用复杂应用SVN使用指南Windows环境版专家讲座第2页问题与案例（一）电脑发生故障，文件没有备份而丢失了因为人员离职，造成一些资料丢失了我怎么知道手头公共资料是不是最新版呢？想要追溯几个月前某个状态，却发觉那个版本文件已经被看成垃圾删除了天天要花费很多时间来向他人提供需要共享资料BackSVN使用指南Windows环境版专家讲座第3页问题与案例（二）相同应用系统，每次都重复开发，难以复用一个软件被用于多个项目，发觉其中存在一个BUG，全部这些项目都要进行修复人员分布在两地开发，版本怎样同时甲乙两人为不一样目标修改了同一份文件，乙提交在甲提交之后，造成甲修改内容丢失了客户测试发觉了BUG，开发人员却无法重现出来BackSVN使用指南Windows环境版专家讲座第4页SVN介绍（一）BackSVNSVN使用指南Windows环境版专家讲座第5页SVN介绍（二）一个开源版本管理软件可架设在Apache上，使用http或https协议访问；也可使用内置svn协议访问在Windows环境下，最惯用客户端为TortoiseSVN（简称TSVN）在Linux/Unix环境下，用命令行方式操作SVN版本号指不是某个文件状态，而是整个库状态BackSVN使用指南Windows环境版专家讲座第6页应用环境服务器端：CollabNetSVN服务器端安装包（内含Apache2.2）Windows客户端：推荐使用TortoiseSVN（以下简称TSVN）可经过TSVN进行读、写操作可经过IE浏览器进行读操作可经过各种插件与开发工具集成BackSVN使用指南Windows环境版专家讲座第7页客户端安装（一）安装文件：TSVN客户端：TortoiseSVN-9260-win32-svn-1.6.11.msiTSVN汉字语言包：LanguagePack_9260-win32-zh_CN.msi全部选择默认安装，安装完成后重启电脑TSVN经过右键菜单与Windows资源管理器集成，没有自己窗口界面BackSVN使用指南Windows环境版专家讲座第8页客户端安装（二）TSVN经过右键菜单与Windows资源管理器集成，没有自己窗口界面BackSVN使用指南Windows环境版专家讲座第9页简单应用TSVN右键菜单与图标创建版本库检出更新提交增加删除更名移动BackSVN使用指南Windows环境版专家讲座第10页TSVN右键菜单（一）Back第一次从服务器下载数据（含历史信息）查看服务器上版本库内容从服务器下载数据（不含历史信息）在服务器上创建新版本库（限服务器上操作）导入新版本库目录结构（不推荐使用）SVN使用指南Windows环境版专家讲座第11页TSVN右键菜单（二）Back从服务器上下载最新版本将当地修改上传到服务器查看修订历史信息标识冲突已经被处理取回之前某个版本放弃此次进行修改SVN控制下更名和删除将新文件纳入SVN控制创建分支或标识合并分支SVN使用指南Windows环境版专家讲座第12页TSVN图标BackSVN使用指南Windows环境版专家讲座第13页创建版本库在SVN服务器端操作在对应文件夹内新建一个文件夹，用于存放数据在新建文件夹上点右键，选择“TortoiseSVN－在此创建版本库”，TSVN会在此文件夹内建立若干控制文件BackSVN使用指南Windows环境版专家讲座第14页检出（一）“检出”用于客户端第一次从SVN服务器上下载版本库数据在客户端新建一个文件夹用于存放下载数据在新建文件夹上点右键，选择“SVN检出…”BackSVN使用指南Windows环境版专家讲座第15页检出（二）在弹出窗口“版本库URL”处填入版本库访问地址，如：5:8080/svn/XXX部门/XXXX项目/点“确定”开始从SVN服务器下载数据BackSVN使用指南Windows环境版专家讲座第16页更新“更新”用于客户端从SVN服务器下载最新版本在受SVN控制某层文件夹上（或文件夹内空白处）点右键，选择“SVN更新”，TSVN自动比较该文件夹客户端与服务器版本差异，并下载最新版本到客户端BackSVN使用指南Windows环境版专家讲座第17页提交（一）“提交”用于将客户端改动上传到SVN服务器在受SVN控制某层文件夹上（或文件夹内空白处，或某文件上）点右键，选择“SVN提交…”BackSVN使用指南Windows环境版专家讲座第18页提交（二）TSVN自动检验该文件夹客户端改动，并将其列在弹出窗口“变更列表”栏在弹出窗口“信息”栏写上对此次提交注释，方便未来追溯点击“确定”将客户端改动上传到服务器BackSVN使用指南Windows环境版专家讲座第19页增加（一）“增加”用于将新文件或文件夹纳入SVN控制之下在受SVN控制某层文件夹上（或文件夹内空白处，或新增某文件上）点右键，选择“TortoiseSVN－增加”BackSVN使用指南Windows环境版专家讲座第20页增加（二）假如“增加”是对文件夹进行操作，则会弹出窗口列出该文件夹下未受控文件，点击“确定”将其纳入SVN控制“增加”后文件图标从变成“增加”仅是对客户端文件进行标注，并不上传到服务器，需要执行“提交”操作才会上传BackSVN使用指南Windows环境版专家讲座第21页删除（一）“删除”用于从当前版本中删除文件或文件夹在受SVN控制文件夹中，经过Windows直接删除子文件夹或文件或：在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－删除”BackSVN使用指南Windows环境版专家讲座第22页删除（二）“删除”仅是对客户端文件进行操作，并不改变服务器上内容，需要执行“提交”操作才会将删除操作上传到服务器将“删除”操作“提交”到服务器后，仅是从服务器最新版本中删除了此文件或文件夹，在历史版本中仍可找回此文件或文件夹BackSVN使用指南Windows环境版专家讲座第23页更名（一）“更名”用于在受SVN控制状态下，对文件或文件夹更名在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－更名”BackSVN使用指南Windows环境版专家讲座第24页更名（二）“更名”仅是对客户端文件进行操作，并不改变服务器上内容，需要执行“提交”操作才会将更名操作上传到服务器不要用Windows“重命名”来实现更名，因为这个操作不受SVN控制，SVN会将其了解为删除原文件、增加一个新文件，从而造成文件更名后不能跟踪到更名前状态BackSVN使用指南Windows环境版专家讲座第25页更名（三）更名另一个方法：在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－版本库浏览器”在弹出窗口右键点击要更名文件夹或文件，选择“更名”因为是对服务器版本库直接操作，更名后将自动执行一次“提交”操作更名完成后需要在客户端执行一次“更新”，以下载最新状态BackSVN使用指南Windows环境版专家讲座第26页移动（一）“移动”用于在受SVN控制状态下，移动文件或文件夹位置在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－版本库浏览器”在弹出窗口拖动文件夹或文件到需要位置因为是对服务器版本库直接操作，移动后将自动执行一次“提交”操作移动完成后需要在客户端执行一次“更新”，以下载最新状态BackSVN使用指南Windows环境版专家讲座第27页移动（二）不要用Windows拖动操作或“剪切”、“粘贴”来实现移动，因为这些操作不受SVN控制，SVN会将其了解为在原位置删除文件、在新位置增加文件，从而造成文件移动后不能跟踪到移动前状态BackSVN使用指南Windows环境版专家讲座第28页复杂应用更新至版本还原复原（回滚）冲突及处理分支/标识合并锁定/解锁权限管理BackSVN使用指南Windows环境版专家讲座第29页更新至版本“更新至版本”用于取出文件某历史版本在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－更新至版本…”在弹出窗口中填写要取版本号，点“确定”取回该版本BackSVN使用指南Windows环境版专家讲座第30页还原（一）“还原”用于放弃“增加”、“删除”、“更名”以及修改文件内容等客户端当地操作，将客户端数据恢复到改动前版本状态在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－SVN还原…”BackSVN使用指南Windows环境版专家讲座第31页还原（二）在弹出窗口中查看要还原内容，点击“确定”还原客户端数据“还原”只能用于执行“提交”操作之前，即未将客户端改变上传到服务器之前BackSVN使用指南Windows环境版专家讲座第32页复原（回滚）（一）复原（回滚）用于将项目恢复到之前某个版本状态，并在此版本基础上继续后面工作在受SVN控制某层文件夹或文件上点右键，选择“TortoiseSVN－显示日志”BackSVN使用指南Windows环境版专家讲座第33页复原（回滚）（二）在弹出日志窗口中，右键点击要复原版本，选择“复原到此版本”复原结束后，执行“提交”操作，将此版本作为版本库最新版本BackSVN使用指南Windows环境版专家讲座第34页冲突及处理（一）冲突产生：当两人从同一个版本出发，修改同一份文件并提交时，这两个修改版本就会发生冲突，后提交人会收到发生冲突提醒，且提交失败，要求先进行更新操作BackSVN使用指南Windows环境版专家讲座第35页冲突及处理（一）113114115113114115Back不会造成冲突可能造成冲突SVN使用指南Windows环境版专家讲座第36页冲突及处理（三）发生冲突后，执行“更新”操作后：对于发生冲突文件，TSVN会加上冲突标识假如发生冲突文件是二进制文件（如doc文件、jpg文件），TSVN会增加2个文件，分别是起始版本和发生冲突版本假如发生冲突文件是文本文件（如c文件、txt文件），TSVN会将工作副本中原文件更名增加“.mine”后缀，将两个版本冲突写入原名文件（文件中用<<<<<<<、=======、>>>>>>>加以标识），并另外增加2个文件，分别是起始版本和发生冲突版本BackSVN使用指南Windows环境版专家讲座第37页冲突及处理（四）比如：两人从第213版开始对start.c和SRS.doc进行修改，甲先修改完成并提交形成217版，乙随即提交时发生冲突，则在乙该文件夹下将会存在七个文件：start.c：自动合并了甲和乙修改内容start.cstart.c.r213：甲乙修改前start.cstart.c.r217：甲修改后strat.cstart.c.mine：乙修改后start.cSRS.doc：乙修改后SRS.docSRS.doc.r213：甲乙修改前SRS.docSRS.doc.r217：甲修改后SRS.docBackSVN使用指南Windows环境版专家讲座第38页冲突及处理（五）处理冲突：手工将前一版本中修改整合到自己文件中在冲突文件或文件夹上点右键，选择“Tortoise－已处理…”，标识为冲突已处理（此时会自动删除多出文件），然后再次“提交”BackSVN使用指南Windows环境版专家讲座第39页分支/标识（一）分支：“分支”通惯用于在不一样线上同时工作情况“分支”通常设置为分支全部者拥有读写权限，其它人员仅有读取权限标识“标识”通惯用于版本公布、标识基线状态等情况“标识”通常设置为配置管理员拥有读写缺点，其它人员只有读取权限SVN使用一样操作进行“分支”和“标识”BackSVN使用指南Windows环境版专家讲座第40页分支/标识（二）推荐目录结构Backprojecttrunkbranchestags代码文档SVN使用指南Windows环境版专家讲座第41页分支/标识（三）案例一709XXX软件711工行版712建行版713农行版714718720726717719722727716721728715723724730710Release_V1_0725Release_V1_1tags标识trunk主干branches分支729BackSVN使用指南Windows环境版专家讲座第42页分支/标识（四）案例二711XXX软件713V1_0维护715717719…714716718720712Release_V1_01012Release_V2_0tags标识trunk主干branches分支10111013V2_0维护…BackSVN使用指南Windows环境版专家讲座第43页分支/标识（五）案例三Back712XXX软件713BUG037717718720721714715716719trunk主干branches分支722发觉BUG，编号037SVN使用指南Windows环境版专家讲座第44页分支/标识（六）创建分支在受SVN控制某层文件夹上点右键，选择“TortoiseSVN－分支/标识…”在弹出窗口“至URL”栏，填写分支存放地址，通常将其存放到branches目录下，并加上分支名称，如：5:8080/svn/软件中心/project/branches/工行版BackSVN使用指南Windows环境版专家讲座第45页分支/标识（七）创建分支在弹出窗口“从此复制到版本库”处选择从“最新版本”或“指定版本”或“工作副本”（工作副本可能是个混合版本）复制在弹出窗口“日志信息”栏填写注释信息，然后点击“确定”在对应文件夹执行“更新”操作，下载分支到客户端，之后对分支操作均在此文件夹进行BackSVN使用指南Windows环境版专家讲座第46页分支/标识（八）创建标识创建标识与创建分支类似，只是通常将其存放到tags目录下，如：5:8080/svn/软件中心/project/tags/Release_V1_0标识实际是为某个版本做了个标签，不会为另存一份而消耗服务器存放空间BackSVN使用指南Windows环境版专家讲座第47页合并（一）合并：对两个版本树进行比较，然后将区分应用到当地副本（合并后需进行“提交”操作）比如：在分支A上进行了一系列修改，现在要将这些修改合并到主干上，则可比较建立A分支版本与A分支最终版本之间差异，并将差异应用到主干上可从分支合并到主干，也可从主干合并到分支，也可从分支A合并到分支B可选择合并创建分支以来全部改变，也可选择合并创建分支以来某几个版本改变BackSVN使用指南Windows环境版专家讲座第48页合并（二）在目标文件夹上点右键，如要将“branches/工行版”分支内容合并到主干上，则在“trunk”文件夹上点右键，选择“Tortoise－合并…”在弹出窗口选择“合并一个版本范围”（惯用选择）点击“下一条”BackSVN使用指南Windows环境版专家讲座第49页合并（三）在“合并源URL”处选择要合并进来分支地址，如：5:8080/svn/软件中心/project/branches/工行版在“待合并版本范围”处填入合并版本范围，可点击边上“显示日志”选择版本点击“下一条”BackSVN使用指南Windows环境版专家讲座第50页合并（四）合并深度选择默认“工作副本”“比较空白字符”、“忽略空白字符改变”等选择用于对文本文件比较“测试合并”可在正式合并之前测试合并结果，比如是否存在冲突等点击“合并”若未发生冲突，可在合并后执行“提交”操作BackSVN使用指南Windows环境版专家讲座第51页合并（五）若合并时发生冲突，通常可在弹出窗口选择“以后处理”，在当地副本中冲突文件处将增加2个文件（对二进制文件）或3个文件（对文本文件）手动处理冲突后，使用“Tortoise－已处理”标识冲突已处理，然后执行“提交”操作BackSVN使用指南Windows环境版专家讲座第52页锁定/解锁（一）为了便于多人协作，SVN不提倡“锁定－修改－解锁”方式因为存在冲突处理机制，通常多人可对同一份文件进行修改，而不会造成严重问题但在一些情况下，比如对一张图片进行修改时，两份冲突图片文件将极难被整合到一起，这时提议用锁定/解锁方式BackSVN使用指南Windows环境版专家讲座第53页锁定/解锁（二）锁定方法一在需要锁定文件夹或文件上点右键，选择“Tortoise－属性”在弹出“属性”窗口选择“新建…”，在弹出“增加属性”窗口，选择“svn:needs-lock”属性，并点“确定”增