Subversion的安装与使用

1 windows2003下架设svn服务器

1.1 获取 Subversion 服务器程序

到官方网站（http://subversion.tigris.org/ ）下载最新的服务器安装程序。

目前最新的是1.5版本，具体下载地址在：http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100&expandFolder=8100&folderID=91

1.2 安装服务器端

下载下来的服务器端是个 zip 压缩包，直接解压缩即可，比如我解压到 E:/subversion 。客户端安装文件是个 exe 可执行文件，直接运行按提示安装即可，客户端安装完成后提示重启。

1.3 建立版本库（Repository）

运行Subversion服务器需要首先要建立一个版本库（Repository）。

版本库可以看作是服务器上集中存放和管理数据的地方。

首先建立 e:/svn 空文件夹作为所有版本库的根目录。

然后，进入命令行并切换到subversion的bin目录。

输入如下命令：

svnadmin create E:/svn/repos1

此命令在 E:/svn 下建立一个版本库 repos1 。

repos1 下面会自动生成一些文件夹和文件。

我们也可以使用 TortoiseSVN 图形化的完成这一步：

先建立空目录 E:/svn/repos1 ，注意一定是要空的。

=>在 repos1 文件夹上“右键->TortoiseSVN->Create Repository here...”

=>可以选择版本库模式，这里使用默认的FSFS即可

=>创建了一系列文件夹和文件，同命令行建立的一样。

1.4 运行独立服务器

此时 subversion 服务还没有开始，只是通过它的命令建立了版本库。

继续在刚才的命令窗口输入：

svnserve.exe --daemon

svnserve 将会在端口 3690 等待请求，--daemon（两个短横线）选项告诉 svnserve 以守护进程方式运行，这样在手动终止之前不会退出。

注意不要关闭命令行窗口，关闭窗口会把 svnserve 停止。

为了验证svnserve正常工作，使用TortoiseSVN -> Repo-browser 来查看版本库。

在弹出的 URL 对话框中输入：

svn://localhost/svn/repos1

点 OK 按钮后就可以看见 repos1 版本库的目录树结构了，只不过这时 repos1 是个空库。

你也可以使用--root选项设置根位置来限制服务器的访问目录，从而增加安全性和节约输入svnserve

URL的时间：

svnserve.exe --daemon --root drive:/path/to/repository

以前面的测试作为例，svnserve 将会运行为：

svnserve.exe --daemon --root e:/svn

然后TortoiseSVN中的版本库浏览器URL缩减为：

svn://localhost/repos1

你可能会问这样岂不是每次启动SVN服务器都要输入一次命令?怎样才能让SVN服务器在开机的时候自动启动呢?

答案就是将SVN服务注册到Windows系统服务,在Windows命令提示符里执行命令。

sc create SVN binpath= "/"d:/subversion/bin/svnserve.exe/" --service -r F:/SVN" displayname= "SVN Service" depend= Tcpip start= auto

这个命令是不是有点长?

其实很容易理解,sc是Windows自带的系统服务注册工具,微软支持中心提供了详细的说明,这里我就不再复述了,参数binpath= "/"d:/subversion/bin/svnserve.exe/" --service -r F:/SVN"和我们前面手动启动SVN服务器的命令很像吧?只是把-d改成了--service,这不难理解,因为现在是服务嘛。好了,现在已经大功告成了,重起一下试试吧。

PS: 如果想从系统服务里删除刚才注册的SVN服务可以使用sc delete SVN命令。

1.5 配置用户和权限

用文本编辑器打开E:/svn/repos1/conf目录，修改svnserve.conf：

将：

# password-db = passwd

改为：

password-db = passwd

即去掉前面的 # 注释符，注意前面不能有空格。

然后修改同目录的passwd文件，增加一个帐号：

将：

[users]

# harry = harryssecret

# sally = sallyssecret

增加帐号：

[users]

#harry = harryssecret

#sally = sallyssecret

test = test

1.6 初始化导入

下面就是将我们的数据（项目）导入到这个版本库，以后就由版本库管理我们的数据。我们的任何改动都回被版本库记录下来，甚至我们自己丢失、改错数据时版本库也能帮我们找回数据。

比如，我在 d:/wwwroot 下有个 guestbook 文件夹，里面存放的是我编写的留言簿程序。

在此文件夹上“右键 -> TortoiseSVN -> Import...” ，在弹出对话框的“URL of repository”输入

svn://localhost/repos1/guestbook

在“Import message”输入“导入整个留言簿”作为注释。

点 OK 后要求输入帐号。我们在用户名和密码处都输入 test 。完成后 guestbook 中的内容全部导入到了 svn://localhost/svn/repos1/guestbook 。

我们看到在 e:/svn/repos1 没有任何变化，连个 guestbook 文件夹都没有建立，唯一的变化就是e:/svn/repos1容量变大了。实际上我们源guestbook中的内容已经导入 repos1 版本库了，源 guestbook 文件夹可以删除了。

需要注意的是，这一步操作可以完全在另一台安装了 TortoiseSVN 的客户机上进行。例如运行svnserve的主机的IP是133.96.121.22，则URL部分输入的内容就是“svn://133.96.121.22” 。

2 TortoiseSVN安装与使用

2.1 获取并安装 TortoiseSVN 客户端程序

完成了svn服务器的安装配置，怎么使用svn呢？在Windows下，最常用的svn客户端是TortoiseSVN，有时简称为TSVN。

可以从

http://tortoisesvn.net/downloads下载最新版，目前最新版是TortoiseSVN-1.4.1.7992。下载后，安装。重启机器，使目录图标生效。

或者从http://www.7xm.net/soft/softdown.asp?softid=11321 下载

在资源管理器中，鼠标右键点击任意位置，右键菜单中出现“SVN Checkout”,即为安装成功。

2.2 svn操作流程

开发人员使用svn进行开发的一般流程是：

checkout（检出）项目

——> 更新文件或目录 ——> update

——> 修改文件或目录 ——> commit(提交)变更

——> 增加文件或目录 ——> add(增加) 文件或目录——> commit(提交)

——> 删除文件或目录 ——> commit(提交)上一级目录

其中，checkout只进行一次，update、commit、add操作根据需要会经常使用。

2.2.1 checkout(检出)操作

在资源管理器中，鼠标右键点击任意位置，在菜单中选择”SVN Checkout”。

出现对话框，在”URL of repository:”中输入svn串

格式是 协议://ip:port/版本库/项目/目录。

根据实际情况输入，例如

http://code.google.com/p/google-web-toolkit/source。

在“checkout directory”中输入本地存放代码的目录，请选择空目录或新目录。

svn会清空该目录下的一切文件。输入完毕，点击”ok”按钮。

如果需要，会提示输入用户名和密码。选上”Save authentication”后，以后可以自动登录，不必重输密码。

checkout…有时候时间会很长。结束，点”ok”。

2.2.2 update(更新)操作

在资源管理器中，选择本地目录或文件，鼠标右键菜单选择”SVN Update”。会提示有无文件需要更新，点”ok”完成。

2.2.3 commit(提交)操作

把本地目录中变化了的文件或目录提交到版本库中，用commit操作。

增加新文件或目录，要先用add，再commit。

删除文件或目录，commit上一级目录。

在资源管理器中，选择本地目录或文件，鼠标右键菜单选择”SVN Commit”。

显示分上下2个框的界面。在上框输入说明文字，建议写版本号或变更原因，以便将来查找。下框列出提交的内容。没有可提交的内容，下框中会显示一段说明文字。点“ok”。

提交结束，显示结果。点“ok”。

2.2.4 解决代码冲突

如果commit时出现“You have to update your work copy first.”红色警告，说明版本库中的此文件已经被其他人修改了。

请先点“ok”按钮退出。执行update,然后再commit。

如果修改与update得到的代码不冲突，则自动合并。如果冲突（比如对同一行代码进行了修改），则出现”One or more files are in a conflicted state.“红色警告，并产生几个文件记录冲突。

一般情况下，我们不要直接编辑冲突文件。而按照以下操作手工解决冲突。

在资源管理器中，选择commit时冲突的那个文件，鼠标右键菜单选择“Edit conficts”。

出现界面，分为”Theirs”、”Mine”和”Merged”3部分，表示”别人修改的内容”、 ”我修改的内容”和”合并后的结果”3部分。我们是要将”别人修改的内容”和”我修改的内容”有取舍地合并起来，形成”合并后的结果”。

合并一般分为4种情况：

1. 保留”我的修改”,舍弃”别人的修改”。鼠标右键点击Mine框的相应 行，点击”Use this text block”。

2. 舍弃”我的修改”,保留”别人的修改”。鼠标右键点击Theirs框的相应行，点击”Use this text block”。

3. 同时保留”我的修改”和”别人的修改”，并将”我的修改” 放在前面。鼠标右键点击Mine框的相应行，点击”Use text block from mine before theirs”。

4. 同时保留”我的修改”和”别人的修改”，并将”别人的修改”放在前面。鼠标右键点击Mine框的相应行，点击”Use text block from theirs before mine”。

合并完成，Ctrl+S存盘，退出。

然后，在资源管理器中，选择冲突文件，鼠标右键菜单选择”Resolved”,标记冲突已解决。系统会自动删除因冲突而新建的文件。此时，就可以继续进行commit操作了。

2.2.5 add(增加)操作

增加新文件或目录，要先用add，再commit。

在资源管理器中，选择新增的目录或文件，鼠标右键菜单选择”Add”。

提示增加的文件。点“ok”继续。结束点“ok”。

2.2.6 删除操作

删除文件或目录，commit上一级目录。

3 附录：

介绍几家免费提供svn源代码管理的站点

国内：

http://www.coollittlethings.com/

只需要注册即可使用，速度很快，使用http进行传输，无web管理功能。

国外：

http://code.google.com/hosting/

google提供的，速度比较快，申请即可使用，使用https进行传输，安全性，可靠性高，带有web管理功能。

http://developer.novell.com/wiki/index.php/Project_Hosting

novell公司提供，申请后需要审核，速度较快，使用https进行传输，安全性，可靠性高，带有web管理功能。

推荐使用google提供的。