SVN用户操作手册.docx
- 文档编号:3197050
- 上传时间:2023-05-05
- 格式:DOCX
- 页数:15
- 大小:249.35KB
SVN用户操作手册.docx
《SVN用户操作手册.docx》由会员分享,可在线阅读,更多相关《SVN用户操作手册.docx(15页珍藏版)》请在冰点文库上搜索。
SVN用户操作手册
SVN客户端用户使用手册
该文档将逐步教您如何在软件开发过程中使用svn客户端。
环境模拟
现有项目名称:
test
服务端版本库:
test
URL:
http:
//10.155.11.10:
81/svn
开发人员:
devA,devB
版本库目录结构:
test
Doc(word文档)Soc(源代码)
word_1word_2soc_1sod_2
一、基本操作
1)安装客户端
到\\192.168.2.248\~Software\Microsoft\应用软件\SubversionClint下,下载TortoiseSVN-1.2.0-svn-1.2.0.msi安装程序,双击直接安装即可。
安装成功后,需要重启系统。
右键单击鼠标会多出两个选项,分别是SVNcheckout和TortoiseSVN。
2)建立工作区
项目开始之前,在本地PC的硬盘上,创建一个文件夹,文件夹命名随意(例如workspace
),该文件夹即作为软件开发者在项目开发过程中的工作区。
3)下载版本库(Checkout)
假如现在开发一个项目,配置管理员会在服务端建立一个该项目的版本库test,在workspace文件夹上,右键单击鼠标。
选择SVNcheckout,会出现如下窗口,如图1:
图1
在URLofrepository中输入版本库地址,http:
//10.155.11.10:
81/svn/test,在Checkoutdir中系统会自动添加第二步所创建的工作区目录。
在Revision中,选中HEADrevision,这样将会下载到版本库的最新版本。
如果想下载库中的旧版本文件,可选中Revision,然后填入版本号即可。
如果不想下载整个版本库,而是只想下载自己负责的那部分模块,可以在URL后添加模块名,例如http:
//10.155.11.10:
81/svn/test/Doc。
单击OK,输入用户名和密码,如图2,完成后点OK键确定。
图2
4)更新版本库(Update)
右击文件或文件夹,点击SVNUpdate,从服务器中下载最新的文件,如图3:
图3
(点击
可以查看文件日志),完成后点OK键确定。
5)添加到版本库(Add)
包括添加文件和添加目录,这里以添加文件为例子,添加目录同理。
选择本地需要上传到服务器的文件,右击选择TortoiseSVN-->Add,出现对话框如图4:
图4
点击OK键后该文件显“+”加号,如图5:
图5
右击选择该文件,选择SVNCommit,出现对话框如图6:
图6
点击OK键后弹出上传窗口,如图7:
图7
完成后点OK键确定,刷新页面,该文件上会有绿色对勾出现,表示文件添加上传到服务器成功,如图8:
图8
6)修改版本库
指修改版本库中的文件内容。
所有更新到本地工作区的文件夹,即workspace上会有绿色对勾出现,工作区下的文件也会带有绿色对勾,如图9:
图9
如果对库中某一个文件进行了修改,系统会自动为这个文件和这个文件所在的各级父文件夹加上红色叹号,代表该文件或目录已经在本地被修改,如图10:
图10
当所有对文件的修改操作完毕后,右键单击所修改的文件,选择SVNCommit提交新版本,出现对话框如图11:
图11
点击OK键后弹出上传窗口,如图12:
图12
完成后点OK键确定,刷新页面,该文件上会有有绿色对勾出现,表示系统把修改后的文件版本上传到服务端成功,如图13:
图13
7)重命名和删除文件(Rename、Delete)
如果要删除一个文件或重名名一个文件,注意不要在windows下直接操作。
只需右键单击该文件,选择TortoiseSVN-->Rename或Delete,svn系统便会完成操作。
在workspace中将文件重命名或删除后,服务端的文件结构不会变化,只有当提交新版本库后,即commit后,服务端的文件结构才会被更新。
如果误删除了文件,在没有提交版本库之前,可以通过对版本库的升级将文件重新下载到本地的版本库,也可以通过TortoiseSVN-->Revert恢复。
如果文件删除,并且已经提交,那么要找回文件只能通过下载旧版本库来完成。
注意:
1)每次在工作区文件夹下修改本地版本库之前,必须首先对本地版本库执行一次更新(update),将服务器上最新的版本下载到本地,然后再进行修改操作。
2).svn隐藏目录不可进行提交,否则引起数据混乱,所以建议不要对修改文件的父文件夹进行提交,只对修改的单个或多个文件进行提交(commit)。
二、其他操作
在日常的软件开发过程中,除了以上介绍的操作外,还有另外几种常用操作。
1)比较文件的不同之处
当对soc_1做了修改之后,soc_1文件会出现红色叹号,表示已经修改,如果想查看修改后的soc_1文件与修改前有何不同,可以右键单击此文件,选择TortoiseSVN-->Diff,系统弹出一个窗口,如图14,窗口分为两个部分,左边为更改之前的版本,右边为更改之后的版本。
并在不同之处作出标记和说明。
图14
如果是word文档的话,选择Diff之后,系统会打开一个word文档,并在其中标出修改后的版本与修改前有何不同。
如图15:
图15
2)查看日志
如果想查看一个文件的日志,例如soc_1,右键单击这个文件,选择TortoiseSVN-->showlog,系统会弹出一个窗口,并在窗口中显示soc_1各个版本的log。
如图16:
图16
3)查看版本树
如果想查看soc_1文件的版本树,右键单击该文件,选择TortoiseSVN-->Revisiongraph,系统将会打开一个窗口,并在窗口中显示该文件的版本树。
如图17:
图17
之所以只显示了1、4、5、6、7五个版本,是因为选择了只显示发生过变化的版本。
即4、5、6、7每一个版本都有不同的地方,都是经过用户修改后提交的。
而2、3两个版本是与版本1相同的。
4)下载某个文件的旧版本
如果想要得到某个文件的旧版本,只需在该文件上单击右键,选择TortoiseSVN-->Updatatorevision…即可。
系统会提示输入版本号。
例如要下载soc_1的第五个版本,只需填入5即可。
如图18。
查看完版本5的文件后,如果想在此回到最新版本,只需要对soc_1运行Updata即可。
图18
5)创建分支
版本库中最初的文件soc_1,soc_2,word_1,word_2都是主干文件。
如果想要为soc_1创建一个分支,只需右键单击soc_1,选择TortoiseSVN-->Branch/Tag,系统会弹出一个窗口,如图19。
在窗口中,FromURL表示要创建的这个分支是soc_1的分支(系统会自动添加,不必更改)。
在ToURL中,需要更改一下文件名,在文件名后加一个标志即可,例如“_branch”,路径不需要更改。
在Creatcopyintherepositoryfrom中,可以选择分支文件是由soc_1的那一个版本拷贝来的。
最后填写日志,选择OK。
图19
分支创建完毕,Updata版本库,系统会将soc_1的主干文件和分支文件soc_1_branch同时下载到本地版本库,如图20,然后即可在分支文件上进行操作。
此时soc_1的版本树如图21
图20
图21
6)合并分支
当需要把soc_1_branc分支文件合并到soc_1主干文件时,右键单击soc_1,选择TortoiseSVN-->Merge,会弹出一个窗口,如图22。
图22
在From输入框中填入主干的URL,在To输入框中填入分支的URL。
在From和To中,都有两个选项HEADRevision和Revision,表示要进行合并的是soc_1的那个版本。
合并之后主干文件会标注红色叹号,表示已被修改,并可以提交。
如果合并后文件标注的是黄色叹号,表示文件有冲突,处理方法见第三部分“异常处理”。
7)撤销修改
当对一个文件进行了修改并保存后(注意此处并没有进行提交),如果对修改不满意,想要重新修改,可以右键单击修改过的文件(带红色叹号的那个),然后选择TortoiseSVN-->Revert,前面的一系列修改便会被撤销,恢复到Updata之后的状态。
如果一个文件被误删除,也可通过右键单击该文件所在的目录,选择Revert来恢复。
三、异常处理
此处所说的异常主要是指文件发生冲突。
当两个用户同时下载了最新的版本库,并对库中同一个文件soc_2进行修改提交时,首先提交的用户不会发生异常,第二个提交的用户便会出现无法提交的现象。
情况一:
当2人修改不同行,不冲突的情况下如何处理
第一个人提交后,第二个人再提交时,系统报版本不是最新的警告,如图23,第二个人必须先UPDATE再提交自己修改的文件,系统自动将多人修改的内容合并。
图23
情况二:
修改相同行,文件冲突时如何处理
第一个人提交后,其他人再提交仍报警告,要先UPDATE,Update后多出现三个文件。
如图24:
图24
三个文件分别是本地修改后的文件,本地文件修改前的版本,服务器上最新的版本,手工处理冲突内容时可以参考这些文件,然后删除本地的冲突文件,提交修改后的文件即可。
点击
,打开会出现,如图25:
图25
<<<<<<表示自己传上去的容。
>>>>>>>表示别人传上去的内容
需要手工处理后,单击右键,选择Resolve,冲突标记消除,才能够再次提交,否则无法提交。
注意把冲突文件删除,不要上传到服务器上。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- SVN 用户 操作手册