当前位置：文档之家 › TortoiseSVN典型应用

TortoiseSVN典型应用

  • 格式：doc
  • 大小：2.55 MB
  • 文档页数：11

文安TortoiseSVN使用帮助

SubVersion是一款著名的开源免费版本管理系统，相关介绍网上铺天盖地，这里就不多说了。而TortoiseSVN是SubVersion为开发者提供的一个界面友好的客户端软件，通过该客户端我们可以实现对代码版本的共享与建设。本文针对开发者的TortoiseSVN使用方式进行简要介绍。

一、 下载代码

新加入的同事往往面临的第一个问题：当上级给你一个SVN地址时如何将代码，如何将这份代码下载下来。那么下面就先介绍一下

1. 下载最新代码

安装了TortoiseSVN客户端之后，通常要下载代码。TortoiseSVN在Windows的右键菜单中添加了自己的菜单。如图所示，点击Checkout。

图1

图2

点击OK。随机开始代码下载，下载图中不要点击Cancel。

图3

如图所示，表示下载已成功。

图4

下载后代码如图所示，在所有download的文件上都会有一个绿底白色的对勾。表示当前本地版本与服务器版本相同。

这样就可以进行编码工作了。

2. 下载历史版本代码

SVN号会随着软件的修改每次提交代码而不断增加，早期实施的项目很可能使用的不是当前最新代码编译出来的软件，所以当历史项目遇到问题时，我们需要调出历史代码分析bug。这时就要用到TortoiseSVN下载历史版本的功能。

回到图2的checkout界面，点击最下面的Revision按钮，在后面输入需要下载的历史版本代码的SVN号。如果不能确定历史版本的SVN号码，可以点击Show Log查找历史版本：

图6

选择好历史版本记录后，点击OK，回到checkout界面后，可以看到Revision后面出现了你选择的历史版本的SVN号。点击OK，开始下载代码。之后的操作同首次下载代码。

二、 提交代码

当你做完了某个单元功能后，就要提交代码了。该操作不会覆盖掉SVN服务器上旧版本的代码。提交代码要审慎，针对自己修改的部分一定要做好单元测试，避免其他人下载的代码不能使用。理想状态下，SVN上任何一个历史版本的代码都是可以下载即可编译通过。

图7

这里要介绍一下我们的目录结构，trunks是主干代码，branches是分支代码，他们之间在代码逻辑上不存在任何耦合，所以我们的提交代码动作只能针对其中的一个。如图，在刚下载的Daemon代码中修改了一下daemonconfig.ini文件（实际情况下可能修改的文件比这个要多）。此操作为trunks目录下的变更，所以我们到trunks目录下的空白处点击右键，commit。

图8

图9

这里是关键的一步，首先选择好此次提交到服务器的代码文件，Text Status表明了对打钩文件的操作，deleted表明原来服务器上有此文件，此次上传则把它从服务器上清除掉。Modified表明是你修改的文件。而non-versioned表明该文件没有被SVN服务器记录在案，从未上传过。

选择文件有一个一句话原则：要上传最精简的，且其他人下载后直接可以编译通过的代码。

图中的exe、obj后缀的文件，都是编译后生成的文件，所以不用上传，但代码文件和ini配置文件是软件运行必须的文件、且不会自动生成，则需要上传。以此类推。

然后填写Change Log，这里建议将ChangeLog本地备份，因为提交可能失败。然后点击OK即开始提交工作。

图10

如图所示，代码提交已成功。可以在刚刚提交动作目录下点击：右键\TortoiseSVN\Show

Log查看自己刚刚提交的代码。

最后再次重申，提交代码不仅关系到能否与他人默契的协同工作，也关系到提交人的考评，所以建议代码提交的时候一定要仔细，check your commitment over and over again。

三、 代码更新

当合作开发时，常常是多人共同开发，每个人开发一个功能模块。有时你所写的模块依赖于其他人开发的功能，当其他人完成开发并提交了代码到服务器时，你就需要从服务器更新代码到你的计算机。这时就用到了代码更新功能。

更新工作非常简单，在你要更新的文件所在根目录下点击右键，点击SVN Update，则代码会自动下载到你本地。如果下载没有问题，则会出现如图所示的界面。

图11

建议Update代码时，关闭掉你本地的开发工具，确保本地文件可写状态，避免更新失败。需要注意的是：在功能模块划分不明确、多人共同修改一个代码文件的情况下。Update之前最好备份自己本地的文件，因为你不能假设其他人都会按规矩使用SVN，其他人上传的东西有可能将你本地修改的代码文件覆盖掉，导致你自己工作成果丢失。

这种情况仅限于分工不明确的情况，如果不幸遇到了，要做两件事：1、向上级主管求助；2、学习本文档的高级应用\冲突处理 部分。

四、 高级应用

1. 冲突（Conflict）处理：

图12

当多人共同修改同一个文件时，出现文件冲突并不意外。TortoiseSVN Update检测到服务器代码与你本地的冲突后，会在你的代码文件中做如下修改。

<<<<<<< filename

your changes // 这是你本地的代码

=======

code merged from repository // 这是服务器下载的代码

>>>>>>> revision

带着这样的代码你是无法编译通过的，所以需要对冲突进行处理。注意：不要手动修改代码中的文本。否则后果不可预期，要使用TortoiseSVN的工具进行代码合并。

可以到有冲突的目录下，右键\TortoiseSVN\Resolved。在弹出窗口中双击要处理的冲突文件即可对你的本地文件和服务器文件进行比对，在这里你能查看到这两份代码有哪些不同。并且可以对本地文件进行编辑。

图13

或者如果你十分明确你的代码与服务器有什么不同，也可以直接通过Resolve conflict

using “theirs”和Resolve conflict using “mine”来解决冲突。分别是使用服务器版本和使用本地版本。同样，选择Resolve conflict using “theirs”要谨慎，因为这会覆盖你本地对该文件的修改。换言之：你自己的东西只有你自己有，覆盖了就没了，服务器的代码却可以重复下载。如果你不确定一个冲突文件该如何处理，那么要找到服务器最新版本的提交人，共同探讨解决办法。

参考文献

TortoiseSVN使用手册

合集下载

TortoiseSVN与VisualSVN Server搭建安装及使用手册

TortoiseSVN与VisualSVN Server搭建安装及使用手册

SVN使用说明

TortoiseSVN与VisualSVN Server搭建SVN版本控制系统

本片主要介绍如何搭建SVN版本控制系统，主要使用工具：

1 客户端：TortoiseSVN （小乌龟）

2 服务端：VisualSVN Server

搭建出图形化管理，以及右键菜单版本控制管理的SVN系统。

背景知识

首先要了解SVN是一种集中式管理代码的版本控制系统，原理就是

把代码都保存到一个固定的位置，每次从这个位置拷贝更新代码，进行编辑；再把修改后的代码提交到该目录中。

多人协作开发也是如此。

因此需要一个类似Oracle或者Mysql的服务器用于保存和管理库文件（要保存的代码等文件）的服务端——VisualSVN Server。

还需要一个用户的操作端，用于提交更新检出代码，常用的有Eclipse的Svn插件，以及TortoiseSVN（小乌龟）。

这里推荐使用TortoiseSVN与VisualSVN搭配使用。

下载地址：链接：/s/1qYz5wJE 密码：ormb 如何安装VisualSVN Server

首先去官网下载对应操作系统位数的安装文件： 然后双击安装文件：

接受安装

默认选择即可，第一项是安装VisualSVN Server以及控制台。

最后一项是自动加入环境变量。

选择标准安装（免费），即可。

确认文件安装目录，以及代码库的位置（你的代码想要保存的位置），一旦这个位置的代码库文件被删除，可就无力回天了。

安装即可

确认，直接打开控制管理界面。

安装结束，自动打开控制管理界面。 如何安装TortoiseSVN（小乌龟）

通过官网下载安装文件 双击安装 下一步

点击接受，下一步

默认即可，下一步

安装

完成安装，在任意目录位置，右键可以看到多了两个菜单。 创建资源库

首先右键Repositories,创建资源库 创建FSFS类型的资源库即可，根据官方说法，VDFS是基于FSFS的一种分布式的存储类型。

TortoiseSVN的安装和使用方法

TortoiseSVN的安装和使用方法

Tortoise的安装：

1. 下载安装文件

（1）在浏览器网址输入栏中输入网址：https://tianhua/svn ,然后按Enter键

（2）点击继续浏览此网页

（3）在弹出的认证页面输入用户名和密码，其中用户名为本人中文名拼音首字母缩写（比如：张飞 用户名则为：zf,初始密码为：123）

（4）认证完成后，进入版面库主页面（如图）

（5）进入主页面后，进入共享程序，打开SVN1.8和汉化（如下图）

2. 安装：

下载完成后，先双击TortoiseSVN文件开始安装，一直默认即可（有选项的选第一个），安装完成后再双击LanguagePack，安装过程一直默认即可。

TortoiseSVN的使用：

1. 右键单击桌面，选择TortoiseSVN——版面库浏览器单击（也可以在开始——程序——TortoiseSVN——TortoiseSVN Repository Browser来打开）会弹出一个URL地址框

2. 在地址框中输入地址：https://tianhua/svn ,点击确定，会弹出一个登录页面，在其中输入自己的用户名和密码（上面红字部分，可记住密码）。

3. 单击确定后，进入版面库浏览器，可根据需要访问不同文件夹

4. 选择某个文件夹时，会弹出一个认证页面，在其中再输入

一次用户名和密码。

5. 认证完成后，即可对文件夹访问，不同的文件夹有不同的访问权限，其中共享程序、公共文档、公共学习三个文件夹为公共文件夹，里面存放一些常用程序和学习文件；在部门文件夹中，每个人有一个以本人姓名命名的文件夹，可以在里面放置个人的资料，（可公开的文件放在存档文件夹，私密文件放在个人文件夹）

TortoiseSVN的安装及使用方法

TortoiseSVN的安装及使用方法

一、客户端TortoiseSVN的安装

运行TortoiseSVN程序，点击Next，下面的截图顺序即为安装步骤：

图1：

图2：

图3：

图4：

点击Finish按钮后会提示重启系统，其实不重启也没有关系。

二、客户端TortoiseSVN的使用方法

1、 签入源代码到SVN服务器

假如我们使用Visual Studio在文件夹StartKit中创建了一个项目，我们要把这个项目的源代码签入到SVN Server上的代码库中里，首先右键点击StartKit文件夹，这时候的右键菜单如下图所示：

图2-2-1 点击Import，弹出下面的窗体，其中 是服务器名，svn是代码仓库的根目录，StartKit是我们在上个教程中添加的一个代码库。

说明：左下角的CheckBox，在第一次签入源代码时没有用，但是，在以后你提交代码的时候是非常有用的。

图2-2-2

点击OK按钮，会弹出下面的窗体，要求输入凭据：

图2-2-3

在上面的窗体中输入用户名和密码，点击OK按钮：

图2-2-4

如上图所示，好了，源代码已经成功签入SVN服务器了。这时候团队成员就可以迁出SVN服务器上的源代码到自己的机器了。

2、签出源代码到本机

在本机创建文件夹StartKit，右键点击Checkout，弹出如下图的窗体：

图2-2-5

在上图中URL of Repository：下的文本框中输入svn server中的代码库的地址，其他默认，点击OK按钮,就开始签出源代码了。 说明：上图中的Checkout Depth，有4个选项，分别是迁出全部、只签出下一级子目录和文件、只签出文件、只签出空项目，默认的是第一项。上面的例子中，我们也可以使用web的方式访问代码库，在浏览器中输入/svn/StartKit/

这时候也会弹出对话框，要求输入用户名和密码，通过验证后即可浏览代码库中的内容。

搞定！源代码已经成功签出到刚才新建的StartKit目录中。

TortoiseSVN自动填写提交日志

TortoiseSVN自动填写提交日志

TortoiseSVN使用钩子程序自动填写commit日志

1. 目的

对于使用TortoiseSVN来提交代码到SVN库时经常需要填写提交日志，该提交日志往往有固定的格式（通常由公司版本管理员规定）。如下图，公司要求每次提交到代码库的提交日志中必须由BUGID，Description，Note，Author等信息组成。

每次手动填写或复制这些信息到提交日志中都比较麻烦，本文介绍如何使用客户端钩子脚本（使用python编写）自动填写具有固定格式的信息到提交日志中。

2. 工具及版本

本文档用到的工具（其它版本的未做测试）：

 TortoiseSVN 1.8.4, Build 24972 - 32 Bit , 2013/11/24 11:15:39

 Python 2.7.8 上述两个工具都需要安装在SVN客户端（通常为个人PC）上的，其中python是用来执行python编写的钩子脚本的（用其它语言语言编写钩子脚本也是可以的）。

3. 原理

打开TortoiseSVN->Settings，其中有一项为”Hook Scripts”，这里可以添加TortoiseSVN执行各种操作（如提交前、提交时、提交后等）需要执行的脚本，即“钩子脚本”。

点击“Add…”可以看到TortoiseSVN支持执行钩子脚本的各种操作：

自动填写固定格式的日志信息需要配置的钩子脚本为“Start Commit Hook”，根据TortoiseSVN帮助手册可以找到“Start Commit Hook”的解释：

Start-commit会在提交代码对话框显示前执行，显然，自动填写提交日志信息需要在提交对话框显示前完成。

每次点击提交时，会在目录C:\Users\Administrator\AppData\Local\Temp下生成四个svn临时文件（每个临时文件都有各自不同的用途）：

根据帮助手册，可以找到在执行钩子脚本前，TortoiseSVN会依次传给钩子脚本的参数：