SVN使用说明-客户端-TortoiseSVN篇

1、 SVN使用说明-客户端-TortoiseSVN篇为方便项目人员使用Subversion(SVN配置管理系统,特编写此手册。概述TortoiseSVN是一个轻松、直观的客户端,它让开发人员直接从Windows 的文件浏览器(explorer中操作,提供“点击右键并按下(point-and-click”的使用环境。术语及定义1.Check out签出:指将库中整个模块首次导出到本地。2.Commit提交:将本地修改过的文件提交到库中。3.Update更新:从库下载其他人的修改过的文件。更新本地的拷贝。1TortoiseSVN安装与设置1.1TortoiseSVN安装官方网站下载:内网下载:192

2、.168.87.241tools$软件工程配置工具SVNTortoiseSVN-2137-win32-svn-1.4.6.msi点击安装程序,然后依次按确认按钮即可,安装完毕后,重启后就会和资源管理器集成,在右键菜单中出现,如图: 1.2为项目创建本地工作目录如项目1的本地工作目录为:D:workspaceproject12TortoiseSVN的基本用法2.1工作空间首先,您需从配置库(repository签出(check out原始码的一个版本到本地工作目录。然后,您可以只编辑想要改变的文件,也可以新增文件或是删除不再需要的文件。当您完成时,可以签入(Commit到库中。如果

3、在您修改时,其它人已经改变了同一个文件,那么签入(commit会失败。那么您必须从仓库(repository更新(Update所有您的文件。这将其它开发人员的改变自动合并到您的文件副本里。但如果两个人改变了同一行程序代码或者修改的是二进制文件(如word、excel等,这将发生“冲突(Conflict”,您必须手动解决冲突(见后面。2.2签出(check out一个模块第一次从配置库获得一个模块,称作签出(checkout。在工作目录上按鼠标右键,从弹出菜单中选择SVNcheck out菜单,如下图: URLof repository:为配置库路径checkout directory:为本地工

4、作目录其它一般按缺省设置。2.3Windows Explorer 和 TortoiseSVNExplorer中文件有不同的小图标覆盖在上面,指出文件或是文件夹的SVN 状态:如 您在Windows Explorer内按鼠标右键并从内容菜单中选择SVN操作来与TortoiseSVN互动。哪个文件和文件夹被执行,是根据您选了什么和您在哪里按鼠标右键:此外,文件的属性及Explorer的Detail View中多了SVN的内容。 2.4更新工作区从服务器取得变动的部分到您的本地副本的过程称作“更新(Updating”。更新可能作用于文件、目录上。若要更新,选择您想要的文件或目录,按鼠标右键并选择SV

5、N Update。对话框会蹦出并显示当它执行时更新的过程。由其他人所做的变动会被合并到您的文件之中,执行更新(update对配置库不会被影响。如果您在更新期间收到冲突提示,请先手工解决冲突。2.5签入变动到仓库让本地的修改在仓库(repository有效称作“签入(committing”。在签入之前,您应该做更新以确保没有冲突(conflicts。要开始签入您的变动,选择您想要签入(commit的文件或文件夹。在所选的文件或文件夹上按鼠标右键,并选择SVN Commit。 然后您将看到签入对话框(Commit Dialog,在里面您可以简短的总结您做了什么变动。您也可以不勾选(uncheck它

6、们的可选框(checkboxes来排除变动的文件,使其不被签入。一旦您满意您所签入的东西,在对话框上按下OK来继续进行您的签入(commit操作。 请注意签入变动不会自动地新增您已经建立的本地新文件。如何新增文件,详见新增文件和目录到仓库中。编制部门 批准日期 EPG 2008/1/22 2.6 解决冲突 有时候，当您从仓库（repository）更新您的文件，SVN 服务器会报告冲突。 当二个或更多开发人员变动了一个文件的同一行，冲突会发生，需要人工解决。 在冲突文件上按鼠标右键并选择 Edit Conflicts.， 现在 TortoiseSVN 会启动 您在合并应用程序。解决每个冲突，储

7、存结果文件，并且退出合并应用程序。 2.7 新增文件和目录到仓库 如果您已经建立新文件或目录， 您会注意到它们以 Not In SVN 状态覆盖的 小图标显示。 要在 SVN 控制下放置新的文件或文件夹， 选择您想要新增的项目， 按鼠标右键并从内容菜单中选择 SVN Add 来新增。 您不需要烦恼一个文件是否是 ASCII/Text，Unicode/Text，或二进制文件 （Binary） ，TortoiseSVN 会自动地检测它。 在新增操作被执行后， 文件或文件小图标显示为 “被改变了的 （changed） ” 。 这是因为新增被视为本地端的变动，且尚未被用到仓库（repository）上

8、，直到 您签入（commit）它们。 此外， 您可以使用 SVN Add Contents.命令来新增一些文件和目录到 SVN。 此操作递归地往下到文件夹结构里，并在 Add Dialog 中显示所有尚未新增 （unadded） 的文件。 在此您可以选择可选框和取消可选框选您希望新增到 SVN 的文件和文件夹。 第 6 页 编制部门 批准日期 EPG 2008/1/22 3 TortoiseSVN 的进阶用法 3.1 锁定文件 按下鼠标右键并选择 SVN Get lock。 对于二进制文件，如 doc、xls 等，可采用设置锁的方式。这对于习惯于 VSS 模式的人员，也可用此方式。 选定目录/

9、文件，文件菜单属性subversion 页，property 栏增加 svn:need-lock,值可填* 以后改文件，需先 get lock，如成功，则可修改并提交。否则可检查状态， 看是被谁锁住了。 修改完后，commit 时系统默认会自动解锁。 如果未修改，也可通过 release lock 来释放锁。 3.2 TAG 和 Branch TAG 使得系统目前的状态可以在未来被重新建构。SVN 使用整体版本号，每 次提交都将使全局版本号加 1，Tag 可为全局版本号取个容易记忆的名称。与 CVS 不同，它执行非常快。 在 SVN 中，标记（Tags）和分支（Branch）的命令是在一起，说

10、明两者有 相似之处。未修改的分支即为“标记”，标记修改后就转化为分支。 作基线时，可通过标记操作实现，将系统主干（trunk）复制到 tags 目录 下即可。如： 1、选中 trunk 目录 2、右键TortoiseSVN-tags/branches 3、出现界面 第 7 页 编制部门 批准日期 EPG 2008/1/22 因此， 项目目录结构中， 顶层必须符合规范， 设立 trunk、 tags 和 branches 目录，否则将无法做基线。 对于文件级的标签，虽然也可以通过 tags 操作，但效果不大好，可在提交 时写在备注说明中，以后可在日志显示中查到。 3.3 版本库浏览器 通过版本库

11、浏览器可对系统概貌有个全面的了解。 如果想看文件，也可直接选中文件，右键，选择打开功能。注意：对于 word、 excel 等文件，应选择 open with，然后选择相应的软件打开。 第 8 页 编制部门 批准日期 EPG 2008/1/22 3.4 切换(relocation 通过切换，可将版本库地址切换到另一个地方。在使用分支时经常用到。 另外在内外网切换时也可以通过此方式实现。为了内外网使用同一地址，避免 切换，也可在 C:WINDOWSsystem32driversetchosts 文件内增加一行： 62 这样无论内外网都可统一使用一个地址了。 注意事项： 1、有卡巴斯基时，获取项目只能获取到 svn 控制文件,却不能获取项目源文件, 并且打开 svn 版本树时,程序一直在运行状态,不能打开树目录。 解决方法: 打开卡巴斯基设置->保护->信息区域->信息程序,选择 SVN 客户 端程序,并选