SVN使用详细文档.doc

SVN使用文档第一部分 SVN与MyEclipse一.MyEclipse安装SVN1.下载SVN客户端site-1.6.12.zip(这个SVN上已经放置了解压后的文件，不需要再下载，可以从其他人处拷贝过来)2.将拷贝过来的文件夹（如下图）复制到MyEclipse的安装目录中。如下图所示：可以自己新建plugins_文件夹3.在dropins文件夹下建立svn.link和svn.link.bak文件文件内容均如下：path=D:Program FilesMyEclipseplugins_svn注意是“”4.完成上述之后，重新启动MyEclipse 启动之后打开Windows-show view,就可以看到svn的选项了。二、SVN的使用1. 接着上一个操作，选中或者双击SVN资源库，便显示在如图位置2.在上图的空白处点击鼠标右键-新建-资源库位置，显示下图，在url中填写svn的位置。此处以svn:/172.20.90.238:9999/repos/yanshi做演示，其中172.20.90.238为SVN服务器的IP，9999是端口号，repos是版本库目录，yanshi是我们当前要的版本库点击finish会出现下图所示的对话框，填写管理员为你配置的用户名和密码，选中保存密码，不然每次访问资源库都要输入。点击OK，yanshi版本库就被copy到本地了。鼠标右键点击你需要的文件-检出为，显示下图，选择“做为工作空间中的项目检出”,next-选择工作空间的位置，finish即可在项目中看到相应的检出文件，此时你便可以对此文件进行操作了。3.将本地的工程传到SVN上 右键点击本地工程名，选择team-share project,显示如图所示选择SVN，next出现如图所示界面选择资源库位置，往下操作就行。这样，再看项目，会发现条目上多了问号，这时需要选择哪些目录和文件需要提交，哪些需要忽略，比如生成的class文件等。选择需要忽略的文件或者目录，这时需要切换到导航视图下才能看到所有文件和目录：从导航视图看到的情况：选中需要忽略的目录和文件，操作SVN然后提交整个项目就成。三：常用的操作1.提交代码-一般会级联当前目录下所有改动的内容。2.删除代码对于不再使用的代码，可以直接删除，这时文件上会有一个红色的叉，然后提交项目就行。3.还原代码如果代码做了改动，可以是多个文件，也可以删除了文件或者新增了文件，但是没有提交到svn服务器，可以通过还原功能恢复到改动前的样子。 如果已经提交，结果发现了问题，需要回退到之前提交的版本，就不是很容易了。这时候的还原，其实是将以前的某个修订本（revision）覆盖当前的本地工作拷贝。然后在提交这些改动，成为新的修订本。（提示：为了以后查找以前版本的方便，提交时要养成写注释的习惯，版本管理员可以设置svn中注释的最小值来控制这一点）还原到以前的版本虽然可以通过版本号进行覆盖还原（如下图），但是一般人是无法记忆这个版本号的，这时可以通过svn的日志功能查看到这些版本和他们的注释消息。看到历史版本的消息内容。这样，根据注释，我们很容易找到需要还原到以前的哪个修订版。如果不放心，我们还可以根据上下文菜单，对比两个修订版的区别。看比较结果，便可知道两个文件的差异。那么，可以确定是从此修订版（这里是5）还原更改后的项目，相当于用此版本（5）还原了现有的修订版。可以看到原来版本添加的内容不见了，这个版本其实就是还原后的版本了（5）。提交即可。4.版本的分支与合并版本的分支和合并，是版本控制的核心功能。（1）版本分支与合并的用途比如，软件通过版本的分支，将项目分配给多人做分工开发，通过版本合并，将这些分工实现的代码合并到新的版本中；或者，修改代码bug的时候，可以先打出一个版本分支,保留出现bug的版本，比如分支版本名称为pre_fix_bug_2201,这里2201表示bug的代码，然后针对这个分支版本构成为pre_fix_bug_2201，这里2201表示bug的代号，然后针对这个分支做修改fix这个bug，再将修改后的内容提交到一个新的分支版本，比如post_fix_bug_2201，再到适当时候将这个分支合并到代码的主干中去。（2）SVN版本分支与合并的基本原理首先是版本分支，实际上是将当前版本“copy”到分支上，非常类似windows下，将某个目录的快捷方式复制到其他路径。这种copy，可以说是轻量级copy或者廉价copy，不是复制版本的内容，而是做一个内部的引用。这样的copy很快，对服务器也没有空间上的开销。版本的合并，是svn开发中的难点，当做版本合并的时候，服务器会试图只能的合并同一个文件的不同版本，可能会带来版本冲突，这需要操作者做手工的处理，消除版本冲突。合理分工的项目应该可以通过管理手段尽量避免这种情况。下面演示版本分支。首先项目文档应该全部提交，然后，选择然后填写url,一般都是在tags/目录下：然后默认选项，next即可，然后选择finish按钮。在svn的目录下便可看到这个名为yanshi_demo_1.0的项目。打分支，实际上就是建立了一个项目的轻量级copy。如何从版本的一个分支切换到另一个分支，这也是很重要，他能帮助你轻松的在不同的项目版本中自动切换，而不必在MyEclipse里维持多个项目。选择要切换的项目版本路径，或者直接输入即可。然后点击ok，项目即可且换到这个版本下了。在分支上做了改动，并且已经提交，那么可以将这个版本合并到主干（trunk）代码中，让主干也拥有最新的代码。首先切换到主干上，再进行合并。选择需要合并的源，比如从tags上面的一个版本，合并到主干代码中。之后需要设置一些合并的特性，这里默认设置即可。执行完毕后，会有一个合并报告，可见没有出现冲突情况。这时候看源代码，可以发现有改动，这些改动就是合并过来的代码。改动如果没有问题，就可以提交，这样就完成了一次版本的合并工作。四：常遇到的问题1. MyEclipse中SVN图标状态不显示问题是MyEclipse显示设置的问题，点击window-Preferences-General-Appearance-Label Decorations，好了，将其中的SVN打上勾就解决了。2. 冲突当团队协同工作的时候，多人同时操作一个文件。当有人操作完成后，将该文件提交到SVN上。这样，其他人的本地文件与SVN上的文件版本不一致。当另一人操作完成后，提交该文件时，就会出现冲突对于每一个冲突的文件，Subversion放置三个额外的未版本化的文件到你的工作拷贝：filename.mine 更新前的文件，最新更改的内容。filename.rOLDREV 更新操作以前的BASE版本文件，在上次更新之后未作更改的版本。filename.rNEWREV 服务器的版本，对应版本库的HEAD版本。（这里OLDREV是本地.svn目录中的修订版本号，NEWREV是版本库中HEAD的版本号。）编辑冲突显示本地的版本和服务器上版本的差别“手动”合并冲突文本（检查和修改文件中的冲突标志）-需要团队成员交流。如果希望取消自己的修改，直接还原得到的便是svn上的最新版本。如何避免冲突养成良好的习惯，在修改文件之前，先进行一次update操作当修改完成后，及时commit，不要在本地停留时间过长；在多人协作时，尽量修改自己撰写的部分，不要修改其他部分；多人协作时，增加交流；出现冲突很正常，可以通过前面的方法解决，不要相互覆盖。3.配置强制注释（方便以后查询）SVN 仓库的负责人把工程的 tsvn:logminisize 设置为 1，以便强制注释。设置方法：在你的工 程文件夹右键-team中，进入，设置属性，选中 tsvn: logminisize，确保复选框 recursive 选中，然后点击 Set 按钮把它的值设为 1，其意思是指提交的注释最短长度为一个字。如图：这样配置好后，在每次提交更改的版本时，都需要写注释，否则不能提交这样配置好后，在每次提交更改的版本时，都需要写注释，否则不能提交第二部分TortoiseSVN的使用一：简介TSVN （是TortoiseSVN的简称）是 SVN 版本控制系统的一个免费开源客户端，可以超越时间的管理文件和目录。二：下载及安装SVN1.下载适合自己电脑配置的TSVN客户端，一般而言，要是32-bit的Windows XP可用 tortoisesvn.zip (这个SVN上已经放置了解压后的文件，不需要再下载，可以从其他人处拷贝过来)2.执行下载回来的TSVN 安装程序，就会进行TSVN 的安装。正确安装后，应该进行一次的重开机，以确保TSVN 的正确无误。3.安装成功后，在空白处点击鼠标右键，应该能看到如下画面。三：TSVN的使用1. 新建SVN版本文件夹，取名建议和SVN上的相同，方便查询。我们还是以第一部分的yanshi为例。 2. 在文件夹上点击鼠标右键，进行SVN Checkout操作。出现如下画面：首先我们要填入的是repository的位置，对于SVN来说，repository的位置都是URL。点击OK，就把SVN上的文件copy到当地了，这相当于一个工作副本。然后进入刚才的文件夹，会看到如下画面。其中名为.svn的目录是隐藏目录，其他的有绿色对勾的都是svn上的普通文件。3. 常见操作-add(新增)首先在相应的目录下新建一个文件，如：可见文档上有一个蓝色小问号，表示还未添加到SVN上，这时点击鼠标右键出现如下画面这时再在文档上点击鼠标右键，执行SVN Commit操作，出现如下画面点击Ok即将文档提交到了服务器4.常见操作-update（更新）4. 常见操作-dele