svn安装与使用.doc

1、软件下载下载Subversion服务器程序。/servlets/ProjectDocumentList?folderID=91【注意】如果之前已经安装了Tortoise SVN客户端，必须选择与之配套的SVN服务端版本，否则会出现各种问题，可以从Tortoise SVN的About菜单中看到与之对应的Subversion版本！下载Subversion的Windows客户端TortoiseSVN及简体中文语言安装包【根据个人爱好而定】/downloads我安装的服务器是Setup-Subversion-1.6.6.msi（1.6版本）。客户端是TortoiseSVN-6974-win32-svn-1.6.5.msi（1.6版本）。安装包都已下载完毕。2、服务器和客户端安装服务器安装，直接运行安装程序，根据提示安装即可（一般都安装在默认路径下：C:Program FilesSubversion），这样我们就有了一套服务器可以运行的环境。安装TortoiseSVN，同样直接运行安装程序，按照提示安装即可，不过最后完成后会提示是否重启，其实重启只是使svn工作拷贝在windows中的特殊样式生效，与所有的实际功能无关。重启完毕后安装简体中文语言包, 然后在随便一个目录右击, 就会发现多出了一些SVN相关菜单, 选择其中的TortoiseSVN, 再选择子菜单Settings, 设置Language为中文(简体)。3.svn的右键菜单及图标介绍 第一次从服务器下载数据（含历史信息）查看服务器上版本库内容从服务器下载数据（不含历史信息）在服务器上创建新的版本库（限服务器上操作）导入新版本库的目录结构（不推荐使用）从服务器上下载最新版本将本地的修改上传到服务器查看修订历史信息标记冲突已经被解决取回之前的某个版本放弃本次进行的修改SVN控制下的改名和删除创建分支或标记合并分支将新文件纳入SVN的控制4在Windows下面建立SVN的版本库（ svn Repository）？ 当安装完前面所提及的TortoiseSVN这套软件后，现在先告诉您如何用自己的硬盘或是随身碟当作SVN Repository的存放地点。 假设您的要放置Repository的地方是E槽。您需要先建立一个空的目录。以下面的例子而言，我们在E槽下面建立了一个名为svn_repo的目录。 SVN并没有限定Repository目录名称。您可以建立任何您自己喜欢的名称。但是，强烈建议勿使用非英文的档名(如中文或日文)。 透过您的档案管理员，在E:svn_repo的Icon上面，按下鼠标右键后，选择TortoiseSVN-Create repository here。 接着，您会看到如下的一个窗口，这个窗口主要是问您，您希望使用的Repository数据库格式是FSFS还是BDB。基本上，请选择FSFS就可以了。按下OK按钮后，您将可以看到下一个画面。 这就表示您的SVN repository已经成功的建立了。接下来就是要把您的档案备份进来。日后，只要需要使用这个repository，我们就可以使用 file:/E:/SVN_REPO表示它。SVN就是透过这种URL的方式到如何与Repository取得联系。各种URL的格式如下： file:/磁盘驱动器|/repository所在目录/子目录http:/账号服务器名称/ repository所在目录/子目录https:/账号服务器名称/ repository所在目录/子目录svn+ssh:/账号服务器名称/ repository所在目录/子目录其中，http表示使用一般的超文字传输通讯协议。https表示使用加密的超文字传输通讯协议。svn+ssh表示透过SSH加密通讯的管道，进行存取。 5.建立一个Working目录（放置svn管理的项目） 所谓的Working目录其实就是您平常用来存放工作档案的地方。通常我们会等到自己的工作做的一个段落的时候再进行备份。所以我们平常都是在 Working目录下面工作，等到适当时机在commit到repository中。举例来说，我们想在D槽下面建立一个名为working的目录。首先先把这个目录建立出来。 此时，这个目录应该为空的。 在档案管理员中按下右键后(您可以在working目录的icon上按，也可进入working目录后，在空白的地方按)，选择SVN checkout。 接着您可以看到如下的画面： 首先我们要填入的是repository的位置，对于SVN来说，repository的位置都是URL。由于我们前面已经在E槽建立一个repository，因此，我们现在要在URL of repository这一栏填入file:/E:/svn_repo/。 接着，稍微看一下Checkout directory，这个字段应该要指向您的working目录。确认后，按下OK按钮，您应该可以看到如下的讯息窗口。 这样就表示动作完成。按下OK按钮后，再到您刚刚建立的目录下。您将会看到working目录下面多了一个名为.svn的目录(这个目录是隐藏的，如果您的档案管理员没有设定可以看到隐藏目录，您将无法看到它) 。 SVN会在您的工作目录下，以及其子目录下建立这个.svn的子目录。您不应该进去这个目录，尤其不应该更动这个目录下面的任何内容。否则会很可能会造成SVN无法正常运作。 由于，原来的repository是空的，所以我们现在的working目录也是空的。如果您现在checkout的是一个已经有内容的repository，您将会看到working目录下面现在多了许多目录及档案。 如果您要在一个已经存在的SVN Server上面checkout出上面的档案，您只需要给定正确的URL以及working目录的名称。就可以取得指定的档案及目录了。 6新增档案及目录到Repository中 假设您前面的动作都无误。现在您开始开发一个新的程序。假设您开发的程序将放在前面建立的working目录下面的my_ prj子目录。如下所示： 假设您已经编辑好档案，准备把他们放到SVN的repository中。您需要在my_prj的文件图标上面，按鼠标右键，并且选择TortoiseSVN-Add： 接着，TortoiseSVN会把准备要加入的档案及目录，显示给您看。打勾的就是等下要被加入到Repository中的。如果您有某些档案或是目录不想在这次加入，您可以让该项目不要被勾选。如此，它就不会被加入到Repository去。 按下OK后，您将会看到如下的讯息窗口： 这样就表示成功了。有一点要注意的是，这个Add的动作并未真正的将档案放到Repository中。仅仅是告知SVN准备要在Repository中放入这些档案。此时，如果您透过档案管理员查看这些档案，应该会看到一个白色红底的惊叹号在档案icon的下方。 这是表示您的working目录中的档案与Repository中的档案还没有同步。现在我们要多一个commit的动作。让这些档案真正的放入到 Repository中。您可以在my_prj目录的icon上或者是my_prj目录内的空白处按下鼠标右键，叫出如下的选单，并且选择SVN commit。 紧接着，您将会看到如下的窗口出现： 在这个窗口中，下半部会列出一个清单，让您清楚的了解到哪些档案要被commit到repository中。同样的，如果您有档案不想在这个时候commit到Repository，您可以取消选取的档案，这样他们就不会被commit到Repository中。 在档案列表的上方是Message栏，您可以在栏中输入本次commit的目的。这是十分重要的字段，当您commit的次数很多时，可以靠这个讯息知道版本与版本之间的差异。当您输入好Message，按下OK之后，就可以看到如下的窗口出现，通知您已经将指定的档案送到Repository中。 您可以到先前的folder中，确定是否所有的档案icon都有如下的绿色勾勾在上面，这样代表您的档案都正确无误的到repository中。 有时候，因为Windows本身的问题，您可能会看到有些icon没有变成绿色的勾勾。此时，多按F5几次，应该就可以解决这个问题。如果，仍然不行，表示您之前的commit动作真的有问题。请仔细检查之前的commit动作是否正确。 7.更新档案及目录 为何需要更新？由于版本控制系统多半都是由许多人共同使用。所以，同样的档案可能还有人会去进行编辑。为了确保您工作目录中的档案与Repository中的档案是同步的。建议您在编辑前都先进行更新的动作。在此，我们都先假设您已经将档案check out过一次。现在要说明的是如何在一个check out过的目录进行update。在想要更新的档案或目录icon上面按下鼠标右键。并且选择SVN Update。 正常的状况下，您可以看到如上的窗口。在这个窗口中会显示有哪些文件更新了。如果没有看到档案更新的相关信息，这表示您的目录中的档案已经是最新的，所以无须进行更新。 8.更新至特定版本 有时我们需要回溯至特定的日期或是版本，这时就可以利用SVN的Update to revision的功能。在想要更新的档案或目录icon上面按下鼠标右键。并且选择TortoiseSVN-Update to revision。 在这个Update窗口中，您可以选择更新到最新版本(HEAD)。也可以选择更新到某个指定的版本(Revision)。当然，您可能早就记不起来正确的版本号码。可能只隐约的记得大概在什么时间。没关系，按下Show log按钮，您就可以回顾历史了。 所有您曾经做过的动作，及其日期与对应的版本都会列在这个窗口上面，只要在你想要的版上面点一下，让他变成反白，然后按下OK。这个版本就会自动填入Update窗口中的Revision字段中。您只要再按下一次OK，这个版本就会被取出来到您的硬盘中。 9.第一次从服务器上检出项目“检出”用于客户端第一次从SVN服务器上下载版本库数据在客户端新建一个文件夹用于存放下载的数据在新建文件夹上点右键，选择“SVN检出”在弹出窗口的“版本库URL”处填入版本库的访问地址，如：/car点“确定”开始从SVN服务器下载数据点击确定后会看到如下的下载窗口。但下载完成后。点击确定。你会发现在目录下出现了car这个项目并标有绿色对钩。10提交修改后的文件当对项目进行修改后。项目的文件夹图标会变成有叹号标记。“提交”用于将客户端的改动上传到SVN服务器在受SVN控制的某层文件夹上（或文件夹内空白处，或某文件上）点右键，选择“SVN提交”TSVN自动检查该文件夹客户端的改动，并将其列在弹出窗口的“变更列表”栏在弹出窗口的“信息”栏写上对此次提交的注释，以便将来追溯点击“确定”将客户端的改动上传到服务器如果服务器设置了修改权限和密码。就会出现如下的验证窗口。只有正确的输入了用户名和密码才能上传修改的文件。当完成提交后会出现如下的成功提示窗口11 删除操作“删除”用于从当前版本中删除文件或文件夹在受SVN控制的文件夹中，通过Windows直接删除子文件夹或文件 或：在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN删除”“删除”仅是对客户端的文件进行操作，并不改变服务器上的内容，需要执行“提交”操作才会将删除操作上传到服务器将“删除”操作“提交”到服务器后，仅是从服务器的最新版本中删除了此文件或文件夹，在历史版本中仍可找回此文件或文件夹12改名“改名”用于在受SVN控制的状态下，对文件或文件夹改名。在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN改名”“改名”仅是对客户端的文件进行操作，并不改变服务器上的内容，需要执行“提交”操作才会将改名操作上传到服务器不要用Windows“重命名”来实现改名，因为这个操作不受SVN控制，SVN会将其理解为删除原文件、增加一个新文件，从而导致文件改名后不能跟踪到改名前的状态改名的另一种方法：在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN版本库浏览器”在弹出窗口右键点击要改名的文件夹或文件，选择“改名”由于是对服务器版本库直接操作，改名后将自动执行一次“提交”操作改名完成后需要在客户端执行一次“更新”，以下载最新状态13移动 “移动”用于在受SVN控制的状态下，移动文件或文件夹的位置在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN版本库浏览器”在弹出窗口拖动文件夹或文件到需要的位置由于是对服务器版本库直接操作，移动后将自动执行一次“提交”操作移动完成后需要在客户端执行一次“更新”，以下载最新状态不要用Windows的拖动操作或“剪切”、“粘贴”来实现移动，因为这些操作不受SVN控制，SVN会将其理解为在原位置删除文件、在新位置增加文件，从而导致文件移动后不能跟踪到移动前的状态14 更新至版本“更新至版本”用于取出文件的某历史版本在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN更新至版本”在弹出窗口中填写要取的版本号，点“确定”取回该版本。当不知道版本号时。可以点击显示日志按钮进入日志信息窗口进行选择。然后点击确定进行更新。“还原”用于放弃“增加”、“删除”、“改名”以及修改文件内容等客户端的本地操作，将客户端的数据恢复到改动前的版本状态在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVNSVN还原”在弹出窗口中查看要还原的内容，点击“确定”还原客户端数据“还原”只能用于执行“提交”操作之前，即未将客户端的改变上传到服务器之前15 复原（回滚）复原（回滚）用于将项目恢复到之前的某个版本状态，并在此版本基础上继续后面的工作在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN显示日志”在弹出的日志窗口中，右键点击要复原的版本，选择“复原到此版本”复原结束后，执行“提交”操作，将此版本作为版本库的最新版本16冲突的解决冲突的产生：当两人从同一个版本出发，修改同一份文件并提交时，这两个修改版本就会发生冲突，后提交的人会收到发生冲突的提醒，且提交失败，要求先进行更新操作发生冲突后，执行“更新”操作后：对于发生冲突的文件，TSVN会加上冲突标记如果发生冲突的文件是二进制文件（如doc文件、jpg文件），TSVN会增加2个文件，分别是起始版本和发生冲突的版本如果发生冲突的文件是文本文件（如c文件、txt文件），TSVN会将工作副本中的原文件改名增加“.mine”后缀，将两个版本的冲突写入原名文件（文件中用加以标识），并另外增加2个文件，分别是起始版本和发生冲突的版本例如：两人从第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.doc解决冲突：手工将前一版本中的修改整合到自己的文件中在冲突的文件或文件夹上点右键，选择 “Tortoise已解决的”，标记为冲突已解决（此时会自动删除多余的文件）