使用Subversion构建版本控制环境（Windows）
使用Subversion构建版本控制环境（Windows）
摘要：
在 软件开发中，CVS在很长的一段时间内一直都是版本控制的首选。但是现在用户有了另一个或许是更好的选择SVN（subversion）。SVN是下一代 版本控制系统，完全可以替代CVS，CVS下的项目，也可以非常容易的转到SVN的控制之下（SVN项目主页是 http://subversion.tigris.org，Tigris本身就是一些在SVN控制下的开源项目，可以说是sourceforge的 SVN版本）。
SVN是一个自由、开放源码、跨平台的版本控制系统。它是一个通用系统，可用来管理任何类型的文件， 其中包括程序源码。
SVN 的设计目标很明确，实现绝大部分CVS的已有功能，充分考虑现有的CVS用户，在使用方式上模仿CVS，同时开发了一系列工具，使得基于CVS的项目能够 顺利迁移到SVN上。作为新一代的版本控制系统，和CVS相比，它有很多优点，例如目录版本控制、不可分割的提交、一致的数据处理方式和更有效率的分支与 标记等。
现在，好多开源项目已经开始转移到了SVN控制之下。作为软件开发者，使用Subversion控制所开发的项目是必然趋势，本文即以Apache+SVN为例，介绍了SVN环境的答建以及简单使用方法。
一、准备相关软件
a) 、Subversion服务器svn-win32-1.3.2.zip
建议直接到http://subversion.tigris.org/下载最新版本
b) 、Subversion客户端TortoiseSVN-1.3.5.6804-svn-1.3.2.msi
TortoiseSVN是一个非常不错的SVN客户端，可以实现跟资源管理器的紧密结合。建议到http://tortoisesvn.tigris.org/下载最新版（相信很多使用过CVS的朋友应该用过TortoiseCVS吧）。
c) 、VS.NET使用SVN的插件AnkhSetup-0.5.3.1636.msi
AnkhSVN是一个相当不错的VS.NET的SVN插件，可以到AnkhSVN的官方网站下载最新版本http://ankhsvn.tigris.org/。有关AnkhSVN的更详细的信息，请访问http://ankhsvn.tigris.org/screenshots.html。
d) 、Apache Web服务器（svn-1.3.2建议使用apache-2.0.54）。
可以到http://www.apache.org/dist/下载合适的版本，最好跟subversion软件中使用的版本一致，若要求的apache版本比较旧，可以到apache历史版本页面下载http://archive.apache.org/dist/。
e) 、TortoiseSVN简体中文语言包（LanguagePack-1.3.5.6804-win32-zh_CN.exe） ，请到http://tortoisesvn.tigris.org/download.html选择下载相应的版本。
小技巧：
以上软件下载完了后，不妨放到同一文件夹下，并附加一包含软件简单说明的readme.txt文件，以备日后使用。
二、软件安装
a) 、安装apache
Apache的安装相当简单、值得注意的一点是，若已经安装了IIS，请先停止，可以使用以下命令：
Net stop w3svc
b) 、安装TortoiseSVN &TortoiseSVN简体中文语言包
安装没什么特别之处，只要先安装TortoiseSVN在安装语言包即可。
c) 、安装Subversion.
i. 解压下载得到的svn-win32-1.3.2.zip到c:/usr/local/目录。并重命名为svn，即可/usr/local/svn/;
ii. 拷贝libeay32.dll、ssleay32.dll两个DLL件到c:/winnt/system32目录;
iii. 拷贝libapriconv.dll、libdb43.dll、intl3_svn.dll到apache/bin目录；
iv. 拷贝mod_dav_svn.so、mod_authz_svn.so两个文件到apache的Modules/目录;
v. 在apache的conf/目录下建立一个文本文件mod_svn.conf输入以下内容
#加载相应模块
LoadModule dav_svn_module /usr/local/svn/bin/mod_dav_svn.so
LoadModule authz_svn_module /usr/local/svn/bin/mod_authz_svn.so
#LoadModule dav_svn_module modules/mod_dav_svn.so
#LoadModule authz_svn_module modules/mod_authz_svn.so
#配置仓库
<Location /svn>
DAV svn
SVNParentPath /usr/local/repository#仓库父目录位于c:/usr/local/repository
# SVNPath /usr/local/respository/svn1 #仓库目录
</Location>
vi. 若需要使用Apache验证则还需要做以下调整：
进入apache/bin目录，执行以下命令产生密码验证文件
htpasswd -cm /usr/local/svn/svn-auth-file user1
提示输入密码时输入该用户的密码
若还需要增加用户user2，则执行以下命令
htpasswd -m /usr/local/svn/svn-auth-file user2
删除某个用户（user2），可以使用下列指令：
htpasswd -D /usr/local/svn/svn-auth-file user2
使用htpasswd产生密码文件
vii. 启用验证后，SVN相关配置如下
<Location /svn>
DAV svn
SVNParentPath /usr/local/repository#仓库父目录位于c:/usr/local/repository
AuthType Basic
AuthName "Subversion repository"
AuthUserFile /usr/local/svn/svn-auth-file
Require valid-user
AuthzSVNAccessFile /usr/local/svn/svn-access-file
</Location>
viii. 配置文件中使用到了svn-access-file，这个文件是用来控制用户访问SVN仓库权限的,下面就讲述以下access文件的配置。
[svn1:/] //这表示，仓库svn1的根目录下的访问权限
user1 = rw // svn1仓库user1用户具有读和写权限
user2 = r // svn1仓库user2用户具有读权限
[svn2:/] //svn2仓库根目录下的访问权限
user1 = r // user1用户在svn2仓库根目录下只有读权限
user2 = // user2用户在 svn2仓库根目录下无任何权限
#[/] // 这个表示在所有仓库的根目录下
#* = r // 这个表示对所有的用户都具有读权限
#[groups] // 这个表示群组设置
#svn1-developers = user1,user2 // 这个表示某群组里的成员
#svn2-developers = user1
#[svn1:/]
#@svn1-developers = rw// 如果在前面加上@符号，则表示这是个组权限设置
ix. 重启APACHE
注意：DocumentRoot目录与svn的SVNParentPath值不可设置为一样，否则可能会出现301 Moved Permanently…错误
三、软件使用
a) 、使用命令行（CMD窗口模式）
创建新的版本库
svnadmin create /path/to/repository
svnadmin是有用的subversion系统管理命令，使用svnadmin help查看在线帮助
信息。
添加新的项目（import new project）
svn import project file:///repository_name/project -m "Comment"
svn import project http://yourhost/svn_dir/repository_name/project -m "Comment"
检出（checkout）项目
svn checkout file:///repository_name/project/trunk project
svn checkout http://yourhost/svn_dir/repository_name/project/trunk project
列出仓库中的项目（list）
svn list --verbose file:///repository_name/project
svn list --verbose http://host/svn_dir/repository_name/project
状态查询（status）
svn status
给出新文件，已经改变的文件和被删除的文件列表;
添加文件或目录（add）
svn add
删除文件或目录（delete）
svn delete
svn delete http://yourhost/svn_dir/repository/project_dir
提交（commit）
svn commit http://yourhost/svn_dir/repository/project_dir
更新（update）
svn update
更新仓库中的文件到本地。
标签和特殊版本项目
使用copy命令
svn copy http://yourhost/repos/project/trunk http://yourhost/repos/project/tags/1.0.0
用于创建某个特定版本的快照（snapshot）;
svn list http://yourhost/repos/project/tags/1.0.0
b) 、下面我们就用以上介绍的命令创建一个测试仓库
i. 打开命令提示符，进入E:/repository目录，执行以下命令
ii. 重启apache，浏览http://localhost/repos/qjoa,若看到以下画面，则表示SVN已经正常工作
iii. 刚才建立的仓库只是一个空的仓库，里面没有任何的项目/文件，下面，我将演示一下怎么向该仓库添加项目，使用以下命令
svn import D:\WorkSpace\OTH_007_QJTech-OA http://localhost/repos/qjoa -m "SVN init project"
注意：以上命令必须单行输入，import项目时，最好先去掉apache验证，否则将导致import项目失败！
iv. OK,重新浏览http://localhost/repos/qjoa试试，若出现跟下图类似的画面，则表示项目导入成功；
c) 、TortoiseSVN操作简介
i. 选择语言
TortoiseSVN安装后，默认使用的是英文，为了使用中文需要执行以下操作，在windows资源管理器中右击TortoiseSVN->Settings.
弹出以下对话框，选择“中文（简体）”后点击应用，即更改默认显示为中文如下图所示：
ii. 
添加项目(import）
进入需要导入的文件夹，右击 “TortoiseSVN”->“导入”，则可出现如下图所示对话框，在文件库路径中填写刚新建的仓库http://www.ilinux.com.cn/repos/qjoa,点击确定，即可完成项目的导入
iii. 检出项目(checkout）
在工作目录新建一文件夹QJOA（我使用的是D:/workspace/qjoa），在有多个项目时，使用工作目录绝对是一个不错的习惯^_^，进入qjoa目录，右击，即出现如下图所示菜单
单击“SVN取出”，则出现如下图所示的画面，
填写适当的信息，单击确定，则TortoiseSVN将开始检出项目，如下图所示
iv. 列出项目
资源管理器中右击TortoiseSVN->文件库浏览器；
在URL栏中填入仓库路径，就可以浏览仓库内容，如下图所示
v. 状态查询
vi. 添加文件或目录
选中要添加的文件夹或文件右击 “TortoiseSVN”->“添加”
vii. 删除文件或目录
选中要添加的文件夹或文件右击 “TortoiseSVN”->“删除”
viii. 提交修改
在工作目录，右击 —>“SVN提交”
ix. 更新
在工作目录，右击 —>“SVN更新”
注意：添加或删除后需要进行提交操作。更多的有关Subversion的详细用法，请查阅Subversion官方文档中文版本。
四、相关资源
a) 、Subversion中文站（http://www.subversion.org.cn/）；
b) 、Subversion官方站（http://subversion.tigris.org/）；
c) 、Subversion官方文档中文版本（http://www.easyea.com/doc/CH/svnbook/）；
五、参考
a) 、Installing Subversion（http://svn.collab.net/repos/svn/trunk/INSTALL）；
b) 、CVS to SVN Crossover Guide（http://svn.collab.net/repos/svn/trunk/doc/user/cvs-crossover-guide.html）；
c) 、apache文档2.0（http://httpd.apache.org/docs/2.0/）；
