SVN客户端使用手册资料.doc

《SVN客户端使用手册资料.doc》由会员分享，可在线阅读，更多相关《SVN客户端使用手册资料.doc（17页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、Good is good, but better carries it.精益求精，善益求善。SVN客户端使用手册-SVN客户端使用手册1 20070823文档目的本手册意在说明在日常工作或软件开发过程中，如何使用SVN来进行文档版本的控制及与他们协同工作。2 目标读者IT软件开发部全体员工参与IT软件开发部所负责项目的其他人员3 模拟环境现假设有一项目名为：test服务端版本库：testsvn:/10.220.0.120/app/projects/test开发人员：devA，devBtest有子目录public和private两个子目录并分别有doc、soc和deva、devb两个子目录，即版

2、本库目录结构：testpublic（公共目录）private（私人目录）docsocdevadevb4 基本操作4.1 安装客户端4.2 下载TortoiseSVN-1.4.1.7992-win32-svn-1.4.2.msi安装程序，双击直接安装即可。安装成功后，在桌面空白处单击鼠标右键，弹出右键菜单会多出两个选项，分别是SVNcheckout和TortoiseSVN。如下图：建立工作区在项目或某项工作开始之前，需首先在本地硬盘上创建一个工作目录，工作目录的名称随意，此处用workspace。4.3 下载版本库现假设devA具有test项目的所有权限，则他就可将本地的workspace目录配

3、置为与svn:/10.220.0.120/app/projects/test目录匹配，具体做法是：在workspace文件夹上，单击鼠标右键。选择SVNcheckout，会出现如下窗口图1在URLofrepository中输入版本库地址，svn:/10.220.0.120/app/projects/test，在Checkoutdirectory中系统会自动添加第二步所创建的工作区目录。在Revision中，选中HEADrevision，这样将会下载到版本库的最新版本。如果想下载库中的旧版本文件，可选中Revision，然后填入版本号即可。如果不想下载整个版本库，而是只想下载自己负责的那部分模块

4、，可以在URL后添加模块名，例如svn:/10.220.0.120/app/projects/test/private/deva。单击OK。如果有弹出窗要求输入用户名和密码，请输入SVN管理员提供的您的用户名与密码。若假设devB只具有该项目下的public(公共目录)下的所有权限以及private/devB下的所有权限，则应在第二步中的workspace下再创建两个子目录public和devb，因此，workspace/public与svn:/10.220.0.120/app/projects/test/public匹配workspace/private/devb与svn:/10.220.0

5、.120/app/projects/test/private/devb匹配只要分别做一次“SVNCheckout”即可。如图：上述操作若执行正确，则与SVN匹配的目录上会有绿色的勾出现。如：或，其下的文件或子目录也会带有绿色的勾。同时，若再次在该目录上再次单击鼠标右键，会发现右键菜单已发生变化，“SVNCheckout”选项消失了，并多出了“SVNUpdate”和“SVNCommit”选项。如图：4.4 提交工作结果如果对本地工作目录中的某一个文件进行了修改，系统会自动为这个文件和这个文件所在的各级父文件夹加上红色叹号，代表该文件或目录已经在本地被修改，如图当所有对版本库的修改操作完毕后，右键

6、单击工作区文件夹，选择“SVNCommit”提交新版本，输入密码后系统将把修改后的版本库上传到服务端，即完成一次对版本库的更新。提交后，红色感叹号会恢复成绿色的勾。切记：新版本提交之后，其他拥有写权限的用户也许会重复以上几步的操作，完成对版本库的再一次更新。所以，每次在工作区文件夹下修改本地版本库之前，必须首先对本地版本库执行一次更新（右键单击工作区，选择“SVNUpdate”），将最新的版本下载到本地，然后再进行修改操作。5 高级操作在日常的软件开发过程中，除了以上介绍的下载，提交，更新操作外，还有另外几种常用操作。5.1 比较文件的不同之处5.2 当对文件做了修改之后，文件会出现红色叹号，

7、表示已经修改，如果想查看修改后的文件与修改前有何不同，可以右键单击此文件，选择Diff，如图：对于一般文本文件（比如JAVA源程序），系统会弹出一个窗口，窗口分为两个部分，左边为更改之前的版本，右边为更改之后的版本，并在不同之处作出标记和说明。如图：如果是word文档的话，选择Diff之后，系统会打开一个word文档，并在其中以Word修订的形式标出修改后的版本与修改前有何不同。如图：查看日志5.3 如果想查看一个文件的日志，右键单击这个文件，选择showlog，系统会弹出一个窗口，并在窗口中显示该文件的各个版本的log。查看版本树5.4 如果想查看文件的版本树，右键单击该文件，选择Revis

8、iongraph，系统将会打开一个窗口，并在窗口中显示该文件的版本树。如图：图6下载某个文件的旧版本如果想要得到某个文件的旧版本，只需在该文件上单击右键，选择Updatatorevision即可。系统会提示输入版本号。例如要下载上述文档的1479版本，只需填入1479即可。如下图。查看完版本1479的内容后，如果想再次回到最新版本，只需要对该文档执行“SVNUpdate”即可。5.5 重名名和删除文件如果要删除一个文件或重名名一个文件，注意：不要在windows下直接操作。只需右键单击该文件，选择SVN菜单的Rename或Delete，SVN系统便会完成操作。在workspace中将文件重命名

9、或删除后，服务端的文件结构不会变化，只有当提交新版本库后，即执行“SVNCommit”后，服务端的文件结构才会被更新。如果误删除了文件，在没有提交版本库之前，可以通过在该目录下空白处单击鼠标右键执行“SVNUpdate”将文件重新下载到本地的工作目录，也可以通过revert恢复（参考第八条）。如果文件删除，并且已经提交，那么要找回文件只能通过下载旧版本库来完成，参考（4）。注意：在做任何恢复前，必须把本次已修改但不想恢复的文件先单独做一次提交。5.6 创建分支版本库中最初的文件都是主干文件。如果想要为某个文件创建一个分支，只需右键单击，选择Branch/Tag，系统会弹出一个窗口，在窗口中，F

10、romURL表示要创建的这个分支的原始文件（不能修改）。在ToURL中，一定要更改一下文件名，如在文件名后加一个标志即可，例如“_branch”，路径不需要更改。在Creatcopyintherepositoryfrom中，一般选第一个选项即可，即从数据库中最新的版本复制。最后填写日志，选择OK。如图：分支创建完毕，执行“SVNUpdate”版本库，系统会将主干文件和分支文件同时下载到本地目录，然后即可在分支文件上进行操作。5.7 合并分支当需要把分支文件合并到主干文件时，右键单击主干文件，选择Merge，会弹出一个窗口，如图：在From输入框中填入主干的URL，在To输入框中填入分支的URL

11、（之前要先把“UseFromURL”的勾去掉）。在From和To中，都有两个选项HEADRevision和Revision，表示要进行合并的是哪个版本，一般选HEADRevision即可。合并之后主干文件会标注红色叹号，表示已被修改，并可以提交。如果合并后文件标注的是黄色感叹号，表示文件有冲突，处理方法见第6章“异常处理”。5.8 撤销修改当对一个文件进行了修改并保存后（注意此处并没有进行提交），如果对修改不满意，想要重新修改，可以右键单击修改过的文件（带红色叹号的那个），然后选择revert，前面的一系列修改便会被撤销，恢复到Update之后的状态。如果一个文件被误删除，也可通过右键单击该文

12、件所在的目录，选择revert来恢复（注意，如此操作会影响到该目录下的所有文件）。6 异常处理此处所说的异常主要是指文件发生冲突。以用户devA和用户devB为例，当两个用户同时下载了最新的版本库，并对库中同一个文件test进行修改提交时，首先提交的用户devA不会发生异常，第二个提交的用户devB便会出现无法提交的现象。因为服务端的版本库已经被devA更新，devB用户在Commit时，系统会提示出错。出错信息如：ModifiedD:戴IT部工作20070312：质量控制功能区SVN使用workspacepublictest.txtErrorCommitfailed(detailsfollo

13、w):ErrorYourfileordirectorytest.txtisprobablyout-of-dateErrorTheversionresourcedoesnotcorrespondtotheresourcewiththetransaction.在这种情况下，devB用户需要首先对修改的文件进行Update文件操作。如果两个用户修改了test.txt文件的同一个地方，则在devB用户执行Update后，系统会将本地的test.txt与从服务端下载test.txt合并到一个文件上，并在该文件图标上标上黄色叹号，表示文件出冲突。在文件中通过“”标识冲突位置和冲突内容。devB用户只有与devA协商，将该冲突手工处理，之后单击右键，选择Resolve，冲突标记消除，才能够再次提交，否则无法提交。文件标记冲突的格式：.r15绿色部分表示本地文件的修改蓝色部分表示服务端版本库中的最新版本与本地文件修改发生冲突的地方。紫色表示是第15个版本发生了冲突-