VisualSVN 使用手册

软件配置管理

原创

发布日期: 2012-02-14

更新日期: 2024-04-10

文章字数: 6.7k

阅读时长: 24 分

阅读次数:

1. VisualSVN Server简介

介绍VisualSVN Server之前，首先说说Subversion。

Subversion是一个自由，开源的版本控制系统。在Subversion管理下，文件和目录可以超越时空。Subversion将文件存放在中心版本库里。这个版本库很像一个普通的文件服务器，不同的是，它可以记录每一次文件和目录的修改情况。这样就可以籍此将数据恢复到以前的版本，并可以查看数据的更改细节：做了哪些修改，谁做的修改，等等。正因为如此，许多人将版本控制系统当作一种神奇的“时间机器”。

Subversion的版本库可以通过网络访问，从而使用户可以在不同的电脑上进行操作。从某种程度上来说，允许用户在各自的空间里修改和管理同一组数据可以促进团队协作。因为修改不再是单线进行（单线进行也就是必须一个一个进行），开发进度会进展迅速。此外，由于所有的工作都已版本化，也就不必担心由于错误的更改而影响软件质量—如果出现不正确的更改，只要撤销那一次更改操作即可。

某些版本控制系统本身也是软件配置管理系统（如SCM），这种系统经过精巧的设计，专门用来管理源代码树，并且具备许多与软件开发有关的特性—比如，对编程语言的支持，或者提供程序构建工具。不过Subversion并不是这样的系统。它是一个通用系统，可以管理任何类型的文件集。

VisualSVN和Subversion一样，都是版本控制器SVN的服务端，一个重要区别是VisualSVN比Subversion配置起来容易的多了。

如果直接使用Subversion，那么在Windows 系统上，要想让它随系统启动，就要封装SVN Server为Windws service，还要通过修改配置文件来控制用户权限，另外如果要想以Web方式（http协议）访问，一般还要安装配置Apache，如果是新手，岂不是很头痛？

而VisualSVN Serve集成了Subversion和Apache，省去了以上所有的麻烦。安装的时候SVN Server已经封装为Windws service，Apache服务器的配置也只是在图像界面上，指定认证方式、访问端口等简单操作；另外，用户权限的管理也是通过图像界面来配置。

需要知道的是，VisualSVN和VisualSVN Server又有一定区别，两者虽然同是SVN的**服务端**，但前者是收费的，后者是免费的。

还有一点，用VisualSVN Server所搭建的服务器仅能在局域网下工作，这是团队开发中必须要注意的，所有成员都必须在同一局域网才能进行资源的同步与共享。一旦客户机与服务机跨越了路由，便无法相连。

2. TortoiseSVN简介

TortoiseSVN 是 Subversion 版本控制系统的一个免费开源**客户端**，可以超越时间的管理文件和目录。

实际上安装TortoiseSVN后，它是以一种类似“右键插件”的方式存在，使用TortoiseSVN能够更方便地管理SVN服务器上的资源，在团队开发中能够更有效实时地共享所有资源。

这里使用TortoiseSVN的一个主要原因是为了使用它的一个基本功能：把代码或资源迁入SVN服务器以达到同步共享的目的。

3. VisualSVN Server的安装

先到网上下载VisualSVN Server的最新版（当前为2.1.10）。

运行 VisualSVN-Server-2.1.10.msi 安装程序后，点击Next按钮继续。

图3-1

勾选“I accept the terms in the License Agreement”选择框，点击Next按钮继续下一步操作。

图3-2

选择完全安装方式，点击Next按钮继续。

图3-3

到这里开始要注意：

“Location”为VisualSVN Server的安装目录，可任意选择。
“Repositories”为SVN代码仓库的位置，即在使用时共享资料的位置，因此基于方便使用的考虑，不建议该位置设置太深（一般在磁盘根目录下再建一层即可），否则以后使用时同步资源库不方便。
“Server Port”为服务端口选择，后面有一个选择框“Use secure connection”。不勾选该选择框为使用快速链接【http协议】，此时供选择的端口有80/81/8080三个；勾选该选择框为使用安全链接【https协议】，这时的端口只有433/8433二个可用。

一般建议选择安全链接【https协议】，即勾选选择框，端口使用默认的即可。设置完毕点击Next按钮继续下一步，然后一直到安装完成即可。

图3-4

图3-5

图3-6

4. VisualSVN Server的配置

安装完VisualSVN Server后，运行VisualSVN Server Manger，启动界面，其中：

“Status”为SVN服务器状态，包括运行状态和服务器URL地址。
“Logging”为服务器日志。
“Subversion Authentication”为账户（User和Groups）信息。
“Repositories”为SVN代码库信息。

图4-1

首先添加一个代码库。右击“Repository”，出现下图所示的右键菜单，任意选择一种方式均可创建一个新的代码库。

图4-2

然后在文本框中输入代码库名称。

需要注意的是，若选择框“Creat default structure”被选中，则在代码库StartKit下面会创建trunk、branches、tags三个子目录；不选中，则只创建空的代码库StartKit。点击OK按钮，代码库StartKit则创建成功。

图4-3

创建完代码库后，没有任何内容在里面。添加内容的方法会在后面说明，这里暂且略过。

图4-4

下面，开始创建用户Users。在左侧的Users上点击右键，出现下图所示的右键菜单，任意选择一种方式均可创建一个新的用户。

图4-5

然后设置新用户的用户名和密码。输入信息后，点击OK按钮，就创建一个用户了。按照这种方式，创建4个用户：starter、Developer1、tester1、manager1。

图4-6

然后把这些用户授权给刚才创建的代码库StartKit。只有被授权的用户才能使用StartKit代码库内的资源，与其他用户进行资源共享。具体方法如下：

首先右击刚才创建的代码库StartKit, 选择“Properties”，弹出如下界面：

图4-7

点击”Add…”按钮，然后选择刚才创建的4个新用户，点击OK按钮则完成了授权工作。

大家可能注意到了图中的Groups。是的，我们也可以先创建组，把用户添加到各个组中，然后对组进行授权，操作比较简单，在此略过。

图4-8

把用户授权给代码库后，还要继续对每个用户（或组）进行详细的权限设置：

“No Access”为禁止该用户访问代码库。
“Read Only”为虽然用户可以访问代码库，但只有读资源的权限。
“Read / Write”为用户不但可以访问代码库，还能对其中的资源进行读或写。

需要注意的是，在用户列表中存在一个“Everyone”用户，为缺省用户，暂时无视之即可。

图4-9

设置完权限后，点击“确定”按钮，这4个用户就具有了访问StartKit代码库的不同权限。

本例中各个用户的权限说明：

用户starter：在团队中是新来者，不希望他向代码库中提交新代码，所以他只能读取代码库中的代码，不能提交代码。
用户tester1：是测试人员，不负责代码编写，所以也是只读权限。
用户Developer1：是开发人员，自然具有读写的权限。
用户manager1：是项目经理，自然具有读写的权限。

在实际的项目开发过程中，Developer和tester往往不可能只有一个人，这时候使用组来授权会更加方便。

5. TortoiseSVN的安装

先到网上下载TortoiseSVN的最新版（当前为1.7.2）。

运行 TortoiseSVN-1.7.4.22459-x64-svn-1.7.2.msi安装程序后，点击Next按钮继续。

图5-1

此时点选“I accept the terms in the License Agreement”选择框，点击Next按钮继续下一步操作。

图5-2

然后选择安装目录，任意即可。设置完毕点击Next按钮继续下一步，然后一直到安装完成。

图5-3

图5-4

点击Finish按钮后TortoiseSVN即安装完毕，但此时可能会提示重启系统，其实不重启也没有关系。

图5-5

6. VisualSVN Server与TortoiseSVN的基本组合使用

注意在使用SVN服务之前，要先确保关闭Windows防火墙，否则可能出现无法连接到SVN服务器的情况。

关闭Windows防火墙的方法是：

右击计算机 -> 属性 -> 系统和安全 -> Windows防火墙 -> 打开或关闭Windows防火墙

为方便下文说明，这里重新配置了一下VisualSVN Server：

SVN资源库为CodeLib（代码库）和FileLib（文件库），其所在的位置可在VisualSVN Server启动界面查得：

图6-1

用户及其权限分别为：（Everyone是缺省用户，暂无视之）

CaiZhenBiao Read Only
DengWeiWen Read Only
LiaoQuanBin Read/Write
LiJianCong Read Only

这里设置4个用户的密码均为123456。

图6-2

然后说一下用TortoiseSVN把源代码迁入SVN服务器的例子。

首先在Eclipse新建项目TestSVN：

图6-3

然后打开Eclipse的工作空间，可以找到项目TestSVN的文件夹，如下图：

图6-4

右击要迁入SVN服务器的项目文件夹TestSVN，可以看到TortoiseSVN出现在右键选项中。若选择Setting则可进行相关的设置，这里不做详细说明。我们选择Import把项目TestSVN迁入SVN服务器。

图6-5

此时弹出如下图所示的界面， URL ： https://Exp-PC/svn/CodeLib 就是当前要迁入的SVN服务器地址。其中 https://Exp-PC/ 是服务器名，svn是代码库的根目录，CodeLib就是刚才添加的代码库。

图6-6

注意上图中左下角的“Include ignored files”，在第一次迁入源代码时没有用，可以不勾选。但是，在以后提交代码的时候是非常有用的。

点击OK按钮后则自动把TestSVN项目迁入了SVN服务器。迁入过程如下图所示。迁入完成后再点击OK关闭窗口。

图6-7

此时在VisualSVN Server中点击CodeLib，可在右方看到刚才迁入SVN服务器的源代码（如下图），若没有显示，右键刷新即可。

注意：也可从这里的灰色条栏中看到当前代码库CodeLib的URL地址。

图6-8

不难发现项目TestSVN的项目文件夹没有了，在CodeLib中只保留了其项目内容。这是因为“根文件夹默认不上传”，因此要把整个TestSVN项目（包括项目文件夹在内）都上传到SVN服务器，可以把整个项目复制到任意一个空文件夹A中，使得文件夹A作为根文件夹，再右击文件夹A进行上传。效果如下图所示。

资源上传到SVN服务器的是资源的副本，因此一旦资源被上传，即使在本地删除也不会对服务器中的资源有任何影响。

图6-9

7. 资源的同步与共享

第6节介绍了如何利用TortoiseSVN把源代码上传到SVN服务器，其实上传非代码的其他资源也是同样的方法，把所需上传的资源（如Word、Excel、*.rar等）放在文件夹内，右键Import即可。同样要注意的是“根文件夹默认不上传”。

本节主要介绍怎样读取已上传到SVN服务器的指定资源的方法，主要有三种：

（1）浏览器连接SVN服务器查看和下载资源；
（2）TortoiseSVN的Checkout功能导出SVN服务器资源；
（3）Eclipse连接SVN服务器查看和导出资源。

方法（3）要在Eclipse安装SVN插件后（见第8节）才能使用，这将在第9节和第10节介绍。所以在本节中主要介绍方法（1）和方法（2）。

7.1. 浏览器连接SVN服务器查看和下载资源

要通过浏览器连接SVN服务器，首先需要获取SVN服务器的URL地址，URL地址的获取方法如下图所示：

打开VisualSVN Server界面，右击想要连接的代码库CodeLib，点选“Copy URL to Clipboard”即把代码库的URL复制到剪贴板。

图7-1-1

然后把URL黏贴到浏览器地址栏回车即可。

部分浏览器可能会拦截，如火狐浏览器可能会出现下图的警告。此时点击“我已充分了解可能的风险”，然后点击“添加例外”，“确认安全例外”即可。同时请确认windows防火墙已关闭。其他浏览器也是类似的信任安全操作。

图7-1-2

通过浏览器拦截后，会弹出身份认证窗口。此时只需要把刚才在VisualSVN Server中设置的4个用户之中的一个账号密码输入即可。然后浏览器就会反馈出当前SVN服务器所保有的资源。

图7-1-3

图7-1-4

下载界面如下：

图7-1-5

7.2. TortoiseSVN的Checkout功能导出SVN服务器资源

在任意空白位置点击鼠标右键，在弹出的功能菜单中选择“SVN Checkout”。

图7-2-1

图7-2-2

如上图所示（下述的“检出”实质就是把SVN服务器上的资源复制一份副本到本地）：

“URL of repository”为要检出资源的SVN资源库地址。
“Checkout directory”为要检出到的位置，可自由选择。
“Checkout Depth”为检出资源的深度，默认为把整个数据库的资源都检出。若要指定检出的项目，可点击“Choose item”按钮进行选择，只勾选需要检出的资源，然后点选OK按钮。
“Revision”为版本控制选项，功能很重要，将在第11节叙述相关作用。
“Show log”为显示被选中的服务器的操作日志。

图7-2-3

图7-2-4

图7-2-5

如上图为检出过程。

如下图为检出后的资源文件。其中左下角的Icon若为“绿色√”说明本地资源与服务器资源一致。当本地资源被修改后，“绿色√”变成“红色！”，说明本地资源与服务器资源不一致。

而关联本地与服务器资源一致性的功能由“.svn”文件夹实现，该文件夹默认为隐藏。当删除“.svn”文件夹后本地与服务器断开连接，Icon消失。

图7-2-6

图7-2-7

图7-2-8

8. Eclipse的SVN插件安装

首先安装Eclipse关于SVN的插件。这里使用Eclipse在线安装插件的方法。

Google搜索“SVN Eclipse插件”即可很容易找到SVN插件的安装地址，当前的安装地址为：http://subclipse.tigris.org/update_1.6.x 。

然后打开Eclipse -> Help -> Install New Software。

图8-1

把地址 http://subclipse.tigris.org/update_1.6.x 复制到“Work with”下按回车，等待加载如下图的3个插件，点击 “Select all”按钮选中全部，然后点击Next按钮执行下一步，按提示操作即可完成安装。可能安装的时间较漫长，请耐心等待。

图8-2

9. Eclipse与SVN服务器的连接

安装SVN插件后，找到Eclipse左下角的“+”（快速视图菜单），再点击打开快速视图菜单，选择Other。在弹出的界面中输入“SVN”，点选搜索到的“SVN资源库”，点击OK按钮确认。

图9-1

图9-2

此时会出现SVN资源库窗口（如下图）。在空白处右击，选择“新建”，在点选“资源库位置”。然后在弹出的窗口输入SVN服务器的地址，这里使用前面创建的代码库的URL地址：https://Exp-PC/svn/CodeLib 。地址无误则点击Finish按钮确定。

图9-3

图9-4

图9-5

此时会弹出如下图所示的对话框，选择“永久接受”，然后输入用户名和密码。这里必须使用授权给当前正在同步的SVN资源库的用户。前面第6节中，配置给CodeLib代码库的用户有4个，这里选择其中的一个即可，为避免以后再输入账户密码，可选择“保存密码”。

图9-6

图9-7

此时已经可以看到SVN服务器上的代码库，展开则可看到保存在SVN服务器的资源。

图9-8

10. 利用SVN插件进行代码的同步与共享

10.1. 从SVN服务器上把代码同步到本地

打开Eclipse的“SVN资源库”，找到要下载的源代码项目，右击该项目的根文件夹，选择“检出为”则可把服务器上的项目同步到本地。

图10-1-1

图10-1-2

如上图所示，检出时会提示命名项目名称，任意命名均可（只要与本地已有项目不重名）。命名完毕后直接按Finish按钮。

此时返回本地Project目录，即可看到刚才从SVN服务器同步下来的TestSVN项目。

如下图所示，从服务器上同步到本地的项目，可以在左边项目列表看到该源代码的来源，以及最后被更新的时间和用户信息。

图10-1-3

10.2. 把本地的代码共享到SVN服务器

新建项目TestSVNUpdata，右击项目文件夹，选择Teamshare project在弹出的界面中选择“SVN”，点击Next按钮继续。

图10-2-1

图10-2-2

如下图所示，选择“使用已有资源库位置”，然后在资源库地址列表中点选要上传的SVN服务器，点击Next按钮继续下一步。若资源库地址列表为空，则选择“创建新的资源库的位置”，输入要上传的SVN服务器的URL地址即可。

图10-2-3

到这步选择“使用项目名做为文件夹名”，点Finish后自动切换到Synchronize标签，其中Synchronize显示的是为等待同步到服务器的项目，这里只有项目TestSVNUpdata可供选择。右击TestSVNUpdata项目文件夹，选择“提交”。

图10-2-4

图10-2-5

然后弹出下图的界面，勾选全部，点击OK按钮。

图10-2-6

切换回到“SVN资源库”标签，右击刚才所上传到的SVN资源库，选择“刷新”，则可看到刚才上传的项目，上传成功。

图10-2-7

10.3. 本地代码与服务器代码的更新和冲突处理

在说明更新和冲突处理之前，先解释一下各种SVN图标含义。

当本地的项目是从SVN服务器上更新下来的时候，若本地或SVN服务器的代码有被修改过，则当进行如此操作时：在“Project Explorer”标签的本地项目上点击右键 Team 与资源库同步（“与资源库同步”仅是在本地和服务器进行比对，暂时并不会使得本地或服务器代码有任何改变）。

这时会在“Synchronize”标签中列出本地与SVN服务器上不一致的文件列表。文件列表中各个文件的右方会根据不同的情况出现不同的Icon（即SVN图标），它们的含义分别为：

灰色向右箭头：本地修改过；
蓝色向左箭头：SVN上修改过；
灰色向右且中间有个加号的箭头：本地比SVN上多出的文件；
蓝色向左且中间有个加号的箭头：SVN上比本地多出的文件；
灰色向右且中间有个减号的箭头：本地删除了而SVN上未删除的文件；
蓝色向左且中间有个减号的箭头：SVN上删除了而本地未删除的文件；
红色双向箭头：SVN上修改过,本地也修改过的文件。

10.3.1. 更新处理

更新主要有两种操作形式：

（1）从本地提交到服务器；
（2）从服务器覆盖/更新到本地。

前者主要用于开发进度的更新，后者主要用于从服务器的备份恢复本地错误。两种操作都比较简单，在核对完本地和服务器代码后，只需在“Synchronize”标签中选中需要更新的文件（或文件夹），然后点击右击，找到“Team”，此时选择“提交”则是进行操作（1），选择“覆盖/更新”则是进行操作（2）。具体要进行哪种操作应该视情况而定，这里不再详细说明。