subVersion安装配置说明要点

subversion安装配置说明
目录
subversion安装配置说明 (1)
目录 (1)
1SubVerison和TortoiseSVN (2)
1.1下载 (2)
1.2安装 (2)
1.3配置 (3)
1.3.1TortoiseSVN的汉化 (3)
1.3.2创建版本库 (4)
1.3.3配置SubVersion自动运行服务 (5)
1.3.4配置基于Apache服务的SubVersion (6)
1.3.5配置SubVersion登陆用户名和密码 (8)
1.3.6导入工程文件到版本库 (9)
1.3.7配置版本库目录访问权限 (11)
1.4获取版本库工程文件 (13)
1.5添加目录和文件到版本库 (14)
1.6下载目录和文件到本地（SVN Upate） (17)
1.7锁定文件（Get lock） (18)
1.8取消锁定文件（Release lock） (19)
1.9提交修改后的文件到版本库（SVN Commit） (20)
1.10复原本地文件（Revert） (21)
1.11FAQ (23)
2SubVersion和Eclipse (26)
2.1下载并安装subclipse插件 (26)
2.1.1下载subclipse插件 (26)
2.1.2安装subclipse插件 (26)
2.2从SubVersion版本库中下载工程到本地 (28)
2.3从版本库得到最新文件 (33)
2.4上传新的文件到版本库 (34)
2.5锁定文件 (36)
2.6取消锁定文件 (37)
参考资料 (39)
1 SubVerison和TortoiseSVN
1.1 下载
下载的程序包括如下：
●Apache Web服务器
下载地址：/download.cgi；
下载的版本文件：apache_2.0.59-win32-x86-no_ssl.msi
注意：
1）2.0.54版本的Apache将不能与Subversion 1.3.xx配合工作。

而且，小于2.0.54的Apache也因为在windows上的编译存在一个bug而导致不能与subversion1.2配合使用；
2）目前的subversion1.3.2只能跟Apache2.0.x配合，不能用于Apache2.2.x
●SubVersion安装包
下载地址：/；
下载的版本：svn-1.3.2-setup.exe
●SubVersion服务自动运行程序
下载地址：/bbs/
下载的文件：SVNService.exe
●TortoiseSVN安装包
下载地址：/；
下载的版本：TortoiseSVN-1.3.5.6804-svn-1.3.2.msi
●TortoiseSVN汉化包
下载地址：/；
下载的文件：LanguagePack-1.3.5.6804-win32-zh_CN.exe
1.2 安装
●第一步：安装Apache Web服务器，安装前需要检查操作系统的80端口是否被占用，然
后执行apache_2.0.59-win32-x86-no_ssl.msi，在Server Information配置界面中输入如下内容：
然后一步步安装直至完成，打开IE浏览器，执行http://localhost，如果看到apache 的提示页面，则证明安装成功；如果要修改默认端口80为其它端口，可以通过修改Apache安装目录下conf目录下的httpd.conf文件中的端口配置来实现；
●第二步：安装SubV ersion服务端软件，执行svn-1.3.2-setup.exe安装程序，全部默认安
装直至完成。

●第三步：安装SubV ersion客户端软件TortoiseSVN，
执行TortoiseSVN-1.3.5.6804-svn-1.3.2.msi；
●第四步：安装TortoiseSVN软件汉化包，
执行LanguagePack-1.3.5.6804-win32-zh_CN.exe；
说明：安装完以上软件，重启一下计算机。

1.3 配置
1.3.1 TortoiseSVN的汉化
在windows的任何目录下，右键点击如下图所示菜单：
系统弹出TortoiseSVN的设置页面，如下图所示：
修改language为“中文(简体)”，然后点击“确定”按钮；此时在windows目录下，重新点击右键菜单已经汉化。

1.3.2 创建版本库
●第一步：在D：盘下创建一个目录SVN（此目录为所有版本库的父目录），然后在此目
录下创建版本库目录repository（此目录名可以自己随便定义，一般为项目工程名称的英文缩写）；
●第二步：鼠标右键点击repository目录，选择菜单“TortoiseSVN-->在此创建文件库”，
如下图所示：
系统弹出对话框，如下图所示：
默认选择第一项，点击“确定”按钮；系统显示创建成功。

1.3.3 配置SubVersion自动运行服务
●第一步：先将SVNService.exe文件拷贝到SubVersion安装目录的bin目录下（例如：
c:\program files\Subversion\bin）；
●第二步：在windows的命令行方式下，运行“SVNService -install -d -r D:\SVN”，
其中“D:\SVN”对应SubVersion版本库所在的父目录。

●第三步：右键鼠标点击“我的电脑”的管理菜单，然后打开“服务”，找到SVNService
服务，然后双击，如下图所示：
然后修改此服务的启动类型为“自动”，然后点击“启动”按钮；
1.3.4 配置基于Apache服务的SubVersion
●第一步：打开SubV ersion安装目录（例如：c:\program files\Subversion）下的bin目录，
拷贝文件mod_dav_svn.so和mod_authz_svn.so和libdb43.dll到Apache的modules目录（通常为c:\program files\apache group\apache2\modules）；
●第二步：使用文本编辑器编辑Apache的配置文件(通常为c:\program files\apache
group\apache2\conf\httd.conf)，修改以下内容：
⏹去掉以下行的注释（将开头的#删除）：
#LoadModule dav_fs_module modules/mod_dav_fs.so
#LoadModule dav_module modules/mod_dav.so
⏹在LoadModule节的最后添加以下两行：
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
注意：如果httd.conf文件中已经存在以上两行（可能路径不是这样写的），只需要修改为以上格式即可；
⏹去掉以下行的注释（将开头的#删除）：
这样配置表示：你所有的版本库将位于D:\SVN目录下，要访问你的版本库可以使用这样的URL：http://localhost/svn/，访问权限将由D:\SVN\passwd文件中的用户名/密码来限制。

1.3.5 配置SubVersion登陆用户名和密码
1.3.5.1 创建passwd文件
首先，将htpasswd 命令所在的D:\Program Files\Apache Group\Apache2\bin\路径加入到操作系统环境变量path中。

密码为admin；
重启Apache服务。

将你的浏览器指向http://localhost/svn/repository(repository是你之前创建的Subversion版本库)。

如果一切正常，你将被提示输入用户名密码，输入正确的用户名密码后你就可以看到版本库中的内容了。

1.3.5.2 新增账号
说明：系统会在D:\SVN\passwd新增账号test，密码为test；
1.3.5.3 修改账号密码
1.3.5.4 删除账号
说明：系统会在D:\SVN\passwd删除账号test；
1.3.6 导入工程文件到版本库
●第一步：先创建要导入工程的目录，首先在D：盘创建一个临时目录tempdir，然后创
建如下图所示目录结构：
目录结构说明：
cring：表示工程的名称，在这里表示“彩铃”。

branches：表示工程的分支目录，用于存放工程的分支。

tags：表示工程的标签目录，用于存放工程的每一个版本信息。

trunk：表示工程的主干目录，用于存放工程的程序和文档信息；
doc：存放工程的文档目录，可以继续细分。

source：存放工程的程序目录，可以继续细分。

●第二步：鼠标右键点击tempdir目录，选择“TortoiseSVN-->导入”菜单，如下图所示：
然后系统弹出如下对话框：
然后输入文件库的url，也可以在导入信息栏中输入一些说明文字，然后点击“确定”按钮，系统弹出用户名录入框，如下图所示：
然后输入用户名admin，密码admin，如果勾选“保存认证”选项，则系统会自动记录用户登陆名和密码，下次操作时就不会出现用户名认证提示框，然后点击“确定”按钮，系统显示导入的结果，如下图所示：
1.3.7 配置版本库目录访问权限
通过配置Subversion授权文件，Apache将确保只有有效的用户可以访问版本库（http://loaclhost/svn），Apache将用户名传到AuthzSVNAccessFile模块进行认证，这样就可以得到更精细的版本库目录权限控制。

配置方式如下：
第一步：使用文本编辑器编辑Apache的配置文件(通常为c:\program files\apache group\apache2\conf\httd.conf)，将最后的SVN配置文件中的“#AuthzSVNAccessFile
●第二步：在版本库所在目录D:\SVN下创建一个Subversion授权文件，文件名为
svnaccessfile，此文件名需要和Apache服务器配置文件httd.conf中描述的一致，参见
1.3.4一节。

说明：路径将被指定为[库:路径]的方式，或者是[路径]。

如果你不明确指定一个库，访问规则将应用到由SVNParentPath指定的目录下所有的版本库中。

注意：
1.svnaccesfile文件中配置的目录在知识库中必须存在，否则http无法访问SVN；
比如：[repository:/cring/trunk]，知识库中必须存在“repository/cring/trunk”目录。

2.Svnaccesfile必须是UTF-8格式
第四步：重新启动Apache2服务。

1.4 获取版本库工程文件
先创建本地工作目录D:\SVNWORK，然后右键点击此目录，选择“SVN取出”菜单，如下图所示：
然后系统弹出如下提示框
然后输入版本文件库所在的url，点击点击“确定”按钮，系统显示如下图所示结果：
在本地得到如下目录结构：
1.5 添加目录和文件到版本库
在source目录下新建目录“com”，然后右键点击此目录，选择菜单“”，如下图所示：
系统弹出如下窗体，如下图所示：
在此选择要上传的目录和文件，然后点击“确定”按钮，系统弹出窗体，如下图所示：
点击“确定”，系统显示如下目录结构：
然后右键点击“com”目录，选择菜单“SVN提交”菜单，如下图所示：
系统弹出窗体，如下图所示：
然后点击“确定”按钮，然后在弹出的窗体中输入用户名和密码，系统显示如下结果：
1.6 下载目录和文件到本地（SVN Upate）
右键点击本地工作目录，选择“SVN更新”菜单，如下图所示：
然后在弹出的窗体中输入用户名和密码，系统显示如下图所示结果：
1.7 锁定文件（Get lock）
锁定文件的功能相当与vss中的check out文件，操作步骤如下：
选择要锁定的文件，右键点击“TortoiseSVN-->取得锁定”菜单，如下图所示：
系统弹出窗体，如下图所示：
然后，可以输入加锁的原因，然后点击“确定”按钮，系统显示如下结果：
说明：
文件被锁定以后，别人不可以在对版本库中的此文件进行锁定。

1.8 取消锁定文件（Release lock）
取消锁定文件的功能类似于vss中的check in文件，但不完全一样，vss在check in的时候，会自动将本地文件更新到版本库，同时释放锁定，而subvserison在release lock的时候，并不会将本地文件更新到版本库，只是释放锁定。

操作步骤如下：
选择要取消锁定的文件，右键点击“TortoiseSVN-->解除锁定”菜单，如下图所示：
系统弹出窗体，如下图所示：
点击“确定”按钮。

1.9 提交修改后的文件到版本库（SVN Commit）
本地修改后的文件必须提交，才可以更新到版本库中。

操作步骤如下：
选择已经修改好的文件，右键点击“SVN提交”菜单，如下图所示：
系统弹出窗体，如下图所示：
在信息框可以输入本次提交的所做的修改信息，然后点击“确定”按钮。

1.10 复原本地文件（Revert）
如果本地修改文件后，发现修改的不对，需要恢复本地文件的内容和版本库一致，按如下方式操作：
先选择要恢复的本地文件，然后右键点击“”菜单，如下图所示：
系统弹出窗体，如下图所示：
然后点击“确定”按钮，系统弹出如下结果：
◆SubVerison和TortoiseSVN的其他操作再此不在一一列举，详细内
容参见SubVerison和TortoiseSVN安装后的联机帮助文档。

1.11 FAQ
●安装Apache2服务器结束时报“。

系统找不到文件。

”时，如何解决？
答：原因是由于WINDOWS系统服务中没有apache2这个服务，正常的化，在安装apache2的过程中会自动添加此服务，但如果没有添加的化，你需要手动添加此服务，添加步骤如下：首先，进入命令行方式，到apache的bin目录下，执行以下命令
apache.exe -k install -n apache2
执行成功后，WINDOWS系统服务中会添加apache2服务，然后执行以下命令
net start apache2
就可以运行apache2服务。

net stop apache2可以关闭apache2服务。

●如何清除保存到本地的认证信息？
答：在windows文件夹下，鼠标右键点击目录，选择菜单“”，如下图所示：
系统弹出窗体，如下图所示：
点击“立即清除”按钮，就可以清除已经保存的用户认证信息。

3. 如果svnaccessfile文件中包含中文信息，或者SVN路径中包含中文信息，则编辑svnaccessfile文件时，保存的时候必须使用utf-8格式保存，否则，提交文件的时候会报错。

1.svnaccesfile文件中配置的目录在知识库中必须存在，否则http无法访问SVN；
比如：[repository:/cring/trunk]，知识库中必须存在“repository/cring/trunk”目录。

2.Svnaccesfile必须是UTF-8格式
3.Svnadmin Load导入dump文件时，必须先创建要导入项目的空svn库
2 SubVersion和Eclipse
2.1 下载并安装subclipse插件
2.1.1 下载subclipse插件
下载地址：，
下载文件：site-1.0.3.zip，site-1.0.3.zip.md5；
2.1.2 安装subclipse插件
在MyEclipse的IDE环境中，点击“Help-->Software Updates-->Find and Install”菜单，如下图所示：
系统弹出窗体，如下图所示：
然后选择第二项，点击“next”按钮，如下图所示：
然后点击“New Archived Site”按钮，系统弹出如下窗体：
选中subclipse插件包文件“site-1.03.zip”，然后点击“打开”按钮，系统弹出如下窗体：
然后点击“ok”按钮即可。

2.2 从SubVersion版本库中下载工程到本地
在MyEclipse的IDE环境中，点击“Window-->Open Perspective-->Other”菜单，如下图所示：
系统弹出如下窗体：
然后选中“SVN Repository Exploring”,然后点击“OK”按钮，如下图所示：
然后点击“Add SVN Repository”按钮，系统弹出如下窗体：
然后输入SubVersion版本库的URL（注：此URL中的“localhost”需要根据实际的情况输入，例如版本库在192.168.16.147，则此URL为http://192.168.16.147/svn/repository，具体情况请与版本库管理员联系），系统弹出如下窗体：
然后输入你的用户名和密码，点击“ok”按钮，系统显示如下界面：
此时界面中显示出当前版本库已有的工程文件目录，用鼠标右键点击“projectsrc”，选择菜单“Checkout”，系统弹出如下窗体：
然后选择第一个选项，使用工程向导从版本库中得到工程文件，点击“Finish”按钮，系统弹出如下窗体：
选择“Web Project”，然后点击“Next”按钮；系统弹出如下窗体：
然后，输入Project Name 为projectsrc（此工程名可以自己定义），修改Web root folder为“Framework”（注：修改根目录名主要是为了保持于以前的风格），然后点击“Finish”按钮，系统弹出如下进度条窗体：
耐心等待，直到下载文件完成，下载完成后，MyEclipse会自动刷新，显示如下界面：
图中是相关的说明。

2.3 从版本库得到最新文件
选中要更新的工程文件目录，然后鼠标点击右键右键菜单“Term-->Update”，如下图所示：
2.4 上传新的文件到版本库
在工程中新建一个文件，然后鼠标点击右键菜单“Term-->Add to Version Control”，如下图所示：
然后，鼠标点击右键菜单“Term-->Commit”，如下图所示：
即可将此文件添加到版本库中。

2.5 锁定文件
在工程中选中要锁定的文件，然后鼠标点击右键菜单“Term-->Lock”，如下图所示：
2.6 取消锁定文件
在工程中选中要取消锁定的文件，然后鼠标右键菜单“Term-->UnLock”，如下图所示：
参考资料
在线使用手册：/中文论坛：/bbs/。