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

SVN使用说明-客户端-TortoiseSVN篇 为方便项目人员使用Subversion（SVN）配置管理系统，特编写此手册。 概述 TortoiseSVN是一个轻松、直观的客户端，它让开发人员直接从Windows的文件浏览器（explorer）中操作，提供“点击右键并按下（point-and-click）”的使用环境。 术语及定义 1.Check out—签出：指将库中整个模块首次导出到本地。 2.Commit—提交：将本地修改过的文件提交到库中。 3.Update—更新：从库下载其他人的修改过的文件。更新本地的拷贝。 TortoiseSVN安装与设置 TortoiseSVN安装 官方网站下载：/downloads 内网下载：\\41\tools$\软件工程\配置工具\SVN\TortoiseSVN-2137-win32-svn-1.4.6.msi 点击安装程序,然后依次按‘确认’按钮即可，安装完毕后，重启后就会和资源管理器集成，在右键菜单中出现，如图： 为项目创建本地工作目录 如项目1的本地工作目录为：D:\workspace\project1 TortoiseSVN的基本用法 工作空间 首先，您需从配置库（repository）签出（check out）原始码的一个版本到本地工作目录。 然后，您可以只编辑想要改变的文件，也可以新增文件或是删除不再需要的文件。当您完成时，可以签入（Commit）到库中。 如果在您修改时，其它人已经改变了同一个文件，那么签入（commit）会失败。那么您必须从仓库（repository）更新（Update）所有您的文件。这将其它开发人员的改变自动合并到您的文件副本里。 但如果两个人改变了同一行程序代码或者修改的是二进制文件（如word、excel等），这将发生“冲突（Conflict）”，您必须手动解决冲突（见后面）。 签出（check out）一个模块 第一次从配置库获得一个模块，称作签出（checkout）。 在工作目录上按鼠标右键，从弹出菜单中选择SVNcheck out菜单，如下图： ? URLof repository:为配置库路径 checkout directory:为本地工作目录 其它一般按缺省设置。 Windows Explorer 和 TortoiseSVN Explorer中文件有不同的小图标覆盖在上面，指出文件或是文件夹的SVN状态：如 未修改过的 本地文件或文件夹是仓库中最新版本。 修改过的 本地已经被修改过，不同于目前的仓库版本。 新增的 文件或文件夹已经被新增到SVN，不过尚未被签入（committed）。 有冲突的 本地与服务器的版本有冲突。 不在SVN上 文件或文件夹不在仓库里。 您在Windows Explorer内按鼠标右键并从内容菜单中选择SVN操作来与TortoiseSVN互动。哪个文件和文件夹被执行，是根据您选了什么和您在哪里按鼠标右键： 此外，文件的属性及Explorer的Detail View中多了SVN的内容。 更新工作区 从服务器取得变动的部分到您的本地副本的过程称作“更新（Updating）”。更新可能作用于文件、目录上。若要更新，选择您想要的文件或目录，按鼠标右键并选择SVN Update。对话框会蹦出并显示当它执行时更新的过程。 由其他人所做的变动会被合并到您的文件之中，执行更新（update）对配置库不会被影响。如果您在更新期间收到冲突提示，请先手工解决冲突。 签入变动到仓库 让本地的修改在仓库（repository）有效称作“签入（committing）”。在签入之前，您应该做更新以确保没有冲突（conflicts）。 要开始签入您的变动，选择您想要签入（commit）的文件或文件夹。在所选的文件或文件夹上按鼠标右键，并选择SVN Commit。 然后您将看到签入对话框（Commit Dialog），在里面您可以简短的总结您做了什么变动。您也可以不勾选（uncheck）它们的可选框（checkboxes）来排除变动的文件，使其不被签入。一旦您满意您所签入的东西，在对话框上按下OK来继续进行您的签入（commit）操作。 请注意签入变动不会自动地新增您已经建立的本地新文件。如何新增文件，详见新增文件和目录到仓库中。 解决冲突 有时候，当您从仓库（repository）更新您的文件，SVN服务器会报告冲突。当二个或更多开发人员变动了一个文件的同一行，冲突会发生，需要人工解决。 在冲突文件上按鼠标右键并选择Edit Conflicts....，现在TortoiseSVN会启动您在合并应用程序。解决每个冲突，储存结果文件，并且退出合并应用程序。 新增文件和目录到仓库 如果