SVN客户端用户常用功能使用手册

SVN客户端用户常用功能使用手册1.安装1.1安装客户端到共享文件夹下，下载TortoiseSVN-1.6.5.16974-win32-svn-1.6.5.msi安装程序，双击直接安装即可。安装成功后，右键单击鼠标会多出两个选项，分别是“SVN检出”和“TortoiseSVN”。安装完成以后可以安装中文语言包LanguagePack_1.6.5.16974-win32-zh_CN.msi，在任意一个文件夹上单击右键选择TortoiseSVN-setting可以设置成中文。1.2建立工作区项目开始之前，在本地硬盘上，创建一个文件夹，文件夹命名随意（例如workspace），该文件夹即作为软件开发者在项目开发过程中的工作区。1.3下载版本库假如现在开发一个项目，配置管理员会在服务端建立一个该项目的版本库，例如：test在workspace文件夹上，右键单击鼠标。选择SVN检出，会出现如下窗口:图1在“版本库URL”中输入版本库地址svn://192.168.3.101/nbyh，在“检出深度”中可以选择四种不同的检出方式，可以根据需要加以选择，这里选择默认的。在“版本”中，选中“最新版本”，这样将会下载到版本库的最新版本。如果想下载库中的旧版本文件，可选中“版本”，然后填入版本号即可。如果不想下载整个版本库，而是只想下载自己负责的那部分模块，可以在URL后添加模块名，例如：svn://192.168.3.101/nbyh/test设备管理。单击OK，输入用户名和密码1.4修改版本库对版本库的修改包括修改文件内容，添加删除文件，添加删除目录。经过第三步的操作，本地的工作区文件夹，即workspace上会有绿色对勾出现，工作区下的文件也会带有绿色对勾，如图2图2如果对库中某一个文件进行了修改，系统会自动为这个文件和这个文件所在的各级父文件夹加上红色叹号，代表该文件或目录已经在本地被修改，如图3图3当所有对版本库的修改操作完毕后，右键单击工作区文件夹，选择“提交”提交新版本，输入密码后系统将把修改后的版本库上传到服务端，即完成一次对版本库的更新。注意：新版本提交之后，其他拥有写权限的用户也许会重复以上几步的操作，完成对版本库的再一次更新。所以，每次在工作区文件夹下修改本地版本库之前，必须首先对本地版本库执行一次更新（右键单击工作区，选择SVN修改），将最新的版本下载到本地，然后再进行修改操作。2.其他操作在日常的软件开发过程中，除了以上介绍的下载，提交，更新操作外，还有另外几种常用操作。2.1创建文件夹创建文件夹有两种方法：一种是可以使用版本库浏览器创建文件夹（然后分别提交）。如果想创建一个层次更深的结构，先在本地磁盘中创建好文件夹结构，然后将其导入（只有一次提交）。在你的硬盘上创建一个空的文件夹。在那个文件夹下创建你想要的顶级目录－－千万不要放任何文件进去！通过在那个文件夹右键，选择TortoiseSVN®导入...将这个结构导入到版本库中。这将导入临时文件夹到版本库的根目录形成一个基本的版本库布局。注意，你所导入的那个文件夹的名字并不存在于版本库中，仅仅是它所包含的内容。比如，创建如下结构的文件夹2.2比较文件的不同之处当对soc_1做了修改之后，soc_1文件会出现红色叹号，表示已经修改，如果想查看修改后的soc_1文件与修改前有何不同，可以右键单击此文件，选择“比较差异”，系统探出一个窗口，如图3，窗口分为两个部分，左边为更改之前的版本，右边为更改之后的版本。并在.不同之处作出标记和说明。图3如果是word文档的话，选择“比较差异”之后，系统会打开一个word文档，并在其中标出修改后的版本与修改前有何不同。如图4：图42.3查看日志如果想查看一个文件的日志，例如soc_1，右键单击这个文件，选择“显示日志”，系统会踏出一个窗口，并在窗口中显示soc_1各个版本的log。如图5图52.4查看版本树如果想查看soc_1文件的版本树，右键单击该文件，选择“版本分支图”，系统将会打开一个窗口，并在窗口中显示该文件的版本树，如图6：图62.5下载某个文件的旧版本如果想要得到某个文件的旧版本，只需在该文件上单击右键，选择“更新至版本…”即可。系统会提示输入版本号。例如要下载soc_1的第五个版本，只需填入5即可。查看完版本5的文件后，如果想在此回到最新版本，只需要对soc_1运行“更新”即可。2.6重命名和删除文件如果要删除一个文件或重名名一个文件，注意不要在windows下直接操作。只需右键单击该文件，选择“改名”或“删除”，svn系统便会完成操作。在workspace中将文件重命名或删除后，服务端的文件结构不会变化，只有当提交新版本库后，服务端的文件结构才会被更新。如果误删除了文件，在没有提交版本库之前，可以通过对版本库的升级将文件重新下载到本地的版本库，也可以通过“恢复”（参考第八条）。如果文件删除，并且已经提交，那么要找回文件只能通过下载旧版本库来完成，参考（4）。2.7创建分支版本库中最初的文件soc_1,soc_2,word_1,word_2都是主干文件。如果想要为soc_1创建一个分支，只需右键单击soc_1，选择“分支/标记…”如图7：图7系统会弹出一个窗口，在窗口中，“从工作拷贝URL：”表示要创建的这个分支是soc_1的分支（系统会自动添加，不必更改）在“到URL”中，需要更改一下文件名，在文件名后加一个标志即可，例如“_branch”，路径不需要更改。在“从此复制到版本库”中，可以选择分支文件是由soc_1的那一个版本拷贝来的。最后填写日志，选择OK。分支创建完毕，更新版本库，系统会将soc_1的主干文件和分支文件soc_1_branch同时下载到本地版本库，然后即可在分支文件上进行操作。2.8合并分支当需要把soc_1_branc分支文件合并到soc_1主干文件时，右键单击soc_1，选择“合并”会弹出一个窗口，如图8：图8一是：在“起始”输入框中填入主干的URL，在“结束”输入框中填入分支的URL。在“起始”和“结束”中，都有两个选项“最新版本”和“版本”，表示要进行合并的是soc_1的哪个版本。合并。二是：在“起始”输入框中填入分支的URL，在“版本”选项中选择需要合并的版本号（按ctrl键把分支开始到分支结束的URL包括开始和结束的URL都选上，确定）。“结束”输入框的“版本”中，系统自动添加了相应的版本号。点击“合并”合并之后主干文件会标注红色叹号，表示已被修改，并可以提交。如果合并后文件标注的是黄色叹号，表示文件有冲突，处理方法见第三部分“异常处理”。2.9撤销修改当对一个文件进行了修改并保存后（注意此处并没有进行提交），如果对修改不满意，想要重新修改，可以右键单击修改过的文件（带红色叹号的那个），然后选择“svn还原..”，前面的一系列修改便会被撤销，恢复到更新之后的状态。如果一个文件被误删除，也可通过右键单击该文件所在的目录，选择“svn还原…”来恢复。2.10版本库浏览如果只是想查看版本库的结构和具体的文件名时，可以不检出项目。在任意文件夹上点击右键，选择TortoiseSVN-版本库浏览器：图9输入版本库的URL:svn://192.168.3.101/nbyh,其中nbyh为版本库名。即可以查看版本库结构。2.11检出单个文件如果只想检出某个文件夹中的单个文件，可以先使用版本库浏览器找到相应的文件所在的文件夹。先检出一个空目录，就是检出的时候检出深度选“仅此项”，然后使用版本库浏览器，找到要检出的那个文件，点右键选“更新项目至版本”，这样就可以检出单个文件了。3.异常处理此处所说的异常主要是指文件发生冲突。以用户devA和用户devB为例，当两个用户同时下载了最新的版本库，并对库中同一个文件soc_2进行修改提交时，首先提交的用户devA不会发生异常，第二个提交的用户devB便会出现无法提交的现象。因为服务端的版本库已经被devA更新，devB用户在上传时，服务器就会提示错误，在这种情况下，devB用户需要首先对修改的文件进行“更新”文件操作。如果两个用户修改了文件soc_2的同一个地方，则在devB用户执行更新后，系统会将本地的soc_2与从服务端下载soc_2合并到一个文件上，并在该文件图标上标上黄色叹号，表示文件出冲突。在文件中通过“”和“”标识冲突位置和冲突内容。devB用户只有与devA协商，将该冲突处理，之后单击右键，选择“以解决的..”，冲突标记消除，才能够再次提交，否则无法提交。