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

编制部门EPG批准日期2008/1/22SVN使用说明-客户端-TortoiseSVN篇为方便项目人员使用Subversion（SVN）配置管理系统，特编写此手册。概述TortoiseSVN是一个轻松、直观的客户端，它让开发人员直接从Windows的文件浏览器（explorer）中操作，提供“点击右键并按下（point-and-click）”的使用环境。术语及定义1.Check out签出：指将库中整个模块首次导出到本地。2.Commit提交：将本地修改过的文件提交到库中。3.Update更新：从库下载其他人的修改过的文件。更新本地的拷贝。1 TortoiseSVN安装与设置1.1 TortoiseSVN安装官方网站下载：/downloads内网下载：41tools$软件工程配置工具SVNTortoiseSVN-2137-win32-svn-1.4.6.msi点击安装程序,然后依次按确认按钮即可，安装完毕后，重启后就会和资源管理器集成，在右键菜单中出现，如图： 1.2 为项目创建本地工作目录如项目1的本地工作目录为：D:workspaceproject12 TortoiseSVN的基本用法2.1 工作空间首先，您需从配置库（repository）签出（check out）原始码的一个版本到本地工作目录。然后，您可以只编辑想要改变的文件，也可以新增文件或是删除不再需要的文件。当您完成时，可以签入（Commit）到库中。如果在您修改时，其它人已经改变了同一个文件，那么签入（commit）会失败。那么您必须从仓库（repository）更新（Update）所有您的文件。这将其它开发人员的改变自动合并到您的文件副本里。但如果两个人改变了同一行程序代码或者修改的是二进制文件（如word、excel等），这将发生“冲突（Conflict）”，您必须手动解决冲突（见后面）。2.2 签出（check out）一个模块第一次从配置库获得一个模块，称作签出（checkout）。在工作目录上按鼠标右键，从弹出菜单中选择SVNcheck out菜单，如下图： URLof repository:为配置库路径checkout directory:为本地工作目录其它一般按缺省设置。2.3 Windows Explorer 和 TortoiseSVNExplorer中文件有不同的小图标覆盖在上面，指出文件或是文件夹的SVN状态：如未修改过的本地文件或文件夹是仓库中最新版本。修改过的本地已经被修改过，不同于目前的仓库版本。新增的文件或文件夹已经被新增到SVN，不过尚未被签入（committed）。有冲突的本地与服务器的版本有冲突。不在SVN上文件或文件夹不在仓库里。您在Windows Explorer内按鼠标右键并从内容菜单中选择SVN操作来与TortoiseSVN互动。哪个文件和文件夹被执行，是根据您选了什么和您在哪里按鼠标右键：此外，文件的属性及Explorer的Detail View中多了SVN的内容。2.4 更新工作区从服务器取得变动的部分到您的本地副本的过程称作“更新（Updating）”。更新可能作用于文件、目录上。若要更新，选择您想要的文件或目录，按鼠标右键并选择SVN Update。对话框会蹦出并显示当它执行时更新的过程。由其他人所做的变动会被合并到您的文件之中，执行更新（update）对配置库不会被影响。如果您在更新期间收到冲突提示，请先手工解决冲突。2.5 签入变动到仓库让本地的修改在仓库（repository）有效称作“签入（committing）”。在签入之前，您应该做更新以确保没有冲突（conflicts）。要开始签入您的变动，选择您想要签入（commit）的文件或文件夹。在所选的文件或文件夹上按鼠标右键，并选择SVN Commit。然后您将看到签入对话框（Commit Dialog），在里面您可以简短的总结您做了什么变动。您也可以不勾选（uncheck）它们的可选框（checkboxes）来排除变动的文件，使其不被签入。一旦您满意您所签入的东西，在对话框上按下OK来继续进行您的签入（commit）操作。请注意签入变动不会自动地新增您已经建立的本地新文件。如何新增文件，详见新增文件和目录到仓库中。2.6 解决冲突有时候，当您从仓库（repository）更新您的文件，SVN服务器会报告冲突。当二个或更多开发人员变动了一个文件的同一行，冲突会发生，需要人工解决。在冲突文件上按鼠标右键并选择Edit Conflicts.，现在TortoiseSVN会启动您在合并应用程序。解决每个冲突，储存结果文件，并且退出合并应用程序。2.7 新增文件和目录到仓库如果您已经建立新文件或目录，您会注意到它们以Not In SVN状态覆盖的小图标显示。要在SVN控制下放置新的文件或文件夹，选择您想要新增的项目，按鼠标右键并从内容菜单中选择SVN Add来新增。您不需要烦恼一个文件是否是ASCII/Text，Unicode/Text，或二进制文件（Binary），TortoiseSVN会自动地检测它。在新增操作被执行后，文件或文件小图标显示为“被改变了的（changed）”。这是因为新增被视为本地端的变动，且尚未被用到仓库（repository）上，直到您签入（commit）它们。此外，您可以使用SVN Add Contents.命令来新增一些文件和目录到SVN。此操作递归地往下到文件夹结构里，并在Add Dialog中显示所有尚未新增（unadded）的文件。在此您可以选择可选框和取消可选框选您希望新增到SVN的文件和文件夹。3 TortoiseSVN的进阶用法3.1 锁定文件按下鼠标右键并选择SVN Get lock。对于二进制文件，如doc、xls等，可采用设置锁的方式。这对于习惯于VSS模式的人员，也可用此方式。选定目录/文件，文件菜单属性subversion页，property栏增加svn:need-lock,值可填*以后改文件，需先get lock，如成功，则可修改并提交。否则可检查状态，看是被谁锁住了。修改完后，commit时系统默认会自动解锁。如果未修改，也可通过release lock来释放锁。3.2 TAG 和 BranchTAG使得系统目前的状态可以在未来被重新建构。SVN使用整体版本号，每次提交都将使全局版本号加1，Tag可为全局版本号取个容易记忆的名称。与CVS不同，它执行非常快。在SVN中，标记（Tags）和分支（Branch）的命令是在一起，说明两者有相似之处。未修改的分支即为“标记”，标记修改后就转化为分支。作基线时，可通过标记操作实现，将系统主干（trunk）复制到tags目录下即可。如：1、选中trunk目录2、右键TortoiseSVN-tags/branches3、出现界面因此，项目目录结构中，顶层必须符合规范，设立trunk、tags和branches目录，否则将无法做基线。对于文件级的标签，虽然也可以通过tags操作，但效果不大好，可在提交时写在备注说明中，以后可在日志显示中查到。3.3 版本库浏览器通过版本库浏览器可对系统概貌有个全面的了解。如果想看文件，也可直接选中文件，右键，选择打开功能。注意：对于word、excel等文件，应选择open with，然后选择相应的软件打开。3.4 切换(relocation)通过切换，可将版本库地址切换到另一个地方。在使用分支时经常用到。另外在内外网切换时也可以通过此方式实现。为了内外网使用同一地址，避免切换，也可在C:WINDOWSsystem32driversetchosts文件内增加一行：62 这样无论内外网都可统一使用一个地址了。注意事项：1、有卡巴斯基时，获取项目只能获取到svn控制文件,却不能获取项目源文件,并且打开svn版本树时,程序一直在运行状态,不能打开树目录。解决方法: 打开卡巴斯基设置-保护-信息区域-信息程序,选择