SVN的安装与使用说明.doc

SVN的安装与使用说明

1. 软件下载 4

1.1 服务器下载 4

1.2 客户端下载 4

1.3 MyEclipse 插件下载 4

2. 安装 4

3. 配置 5

3.1 创建版本库 5

3.2 配置版本库 6

3.3 用户权限设置 6

3.4 启动服务 7

3.5 SVN 汉化处理 8

4. Eclipse中的使用 8

4.1 Subclipse安装 8

4.2 MyEclipse 配置Subclipse 9

4.3 创建、导入项目 11

4.4 从SVN检出项目 14

5. SVN 汉化 18

6. 参考资料 19

1. 软件下载
1.1 服务器下载
官网下载地址： 下载软件：
CollabNetSubversionEdge-2.0.0_setup.exe
1.2 客户端下载
官网下载地址： 下载软件：
LanguagePack_1.6.16.21511-win32-zh_CN.msi
TortoiseSVN-1.6.16.21511-win32-svn-1.6.17.msi
1.3 MyEclipse 插件下载
官网下载地址：http://subclipse.tigris.org/

注意：
下载以上软件时需要根据本机的型号下载正确软件
2. 安装
安装顺序：
首先安装SVN 服务器，其次安装TortoiseSVN-1.6.16.21511-win32-svn-1.6.17.msi
然后安装LanguagePack_1.6.16.21511-win32-zh_CN.msi，最后在MyEclipse中配置SVN 的插件
3. 配置
3.1 创建版本库
建立目录D:\svndemo，把通过Subversion管理的工程都放在此目录下。另为了便于对多个工程分别管理，采用多库的方式配置，即每个工程都配置为一个版本库，并且这些库都集中放在D:\svndemo目录下。
在svndemo 下新建空文件夹pro1，在pro1文件夹上右键建库，如图所示：
创建成功后，在该文件夹下创建如图所示的文件结构：

3.2 配置版本库
目录conf存放版本库的一些配置信息。
修改conf\svnserve.conf中：
# anon-access = read
# auth-access = write
# password-db = passwd
#authz-db = authz
去掉前面的#号，注意每行的开头不能有空格，否则连接服务会报错。

3.3 用户权限设置
认证配置
在conf\ passwd 配置和pro1相关的用户名和密码：

[users]
gump=123

授权配置
在conf\ authz配置用户组及用户组、用户的权限：

[groups]
admin = gump
[/]
@admin = rw
*=r

目录含有中文的授权问题：
方法很简单，就是将权限控制文件(authz)的格式转换为UTF-8格式，svn对于非英文文件名和目录名使用utf-8格式编码处理，要对中文目录进行正确控制，应该使用无BOM的utf-8格式。将权限文件改成UTF-8格式的办法：使用UltraEdit的菜单"ASCII to UTF-8 (Unicode Editing)"。
关于UTF-8的问题如下：
1 svn不支持微软格式的UTF-8文件，不支持unicode，仅支持标准UTF-8，就是头部有一个 FF FE的文件；
2 用微软自带的“记事本”编辑出来的任何unicode格式文件，svn均不认识
3 只要使用了svn 支持的标准UTF-8文件，svn 就可以很好地实现对中文的支持，包括中文用户名、中文目录、中文组名 

3.4 启动服务
通过执行以下命令以Daemon的方式运行Subversion服务器：

svnserve –d –r D:\svnrepos

svnserve可以做成windows服务以便开机自启动。

Sc create SVNServer binpath= "\"C:\Program files\Subversion\bin\svnserve.exe\" --service -r D:\svnrepos" displayname= "SVNServer" depend= Tcpip start= auto

其中binpath里的路径视本机而定。
注意：

（1） sc是windows自带的服务配置程序，SVNServer 是服务的名称，似乎没什 么用。
（2） 开机自动启动SVN服务时参数binPath表示svnserve可执行文件的安装路径，如果路径中带有空格，则整个路径需要用双引号引起来。而双引号本身是个特殊字符，需要进行转移，因此在路径前后的两个双引号都需要写成\"即\"C:\Program files\Subversion\bin\svnserve.exe\"，同时注意在key=value的格式中，在key=后面必须添加一个空格才可以，但在key=中不能存在空格。
（3） --service参数表示以windows服务的形式运行，--r指明svnrepository（库的根目录即：D:\svndemo\repository）的位置，service参数与r参数都作为binPath的一部分。
（4） 开机自动启动SVN服务时displayname表示在windows服务列表中显示的名字，depend=Tcpip表示svnserve服务的运行需要tcpip服务，start=auto表示开机后自动运行。安装服务后，svnserve要等下次开机时才会自动运行。
（5） binPath的等号前面无空格，等号后面有空格displayname、depend、start也都一，service前面是--，不是-，而r前面是-
3.5 SVN 汉化处理
1、在空白处单击鼠标右键，在弹出的菜单选择”TortoiseSVN ---
Settings”。如：

2、如下图所示，在出现的对话框选择“Language：中文（简体）”--- 鼠标左键单击 “确定”按钮

3、重新点击右键查看，汉化完成。

4. Eclipse中的使用
Eclipse版本：8.5

4.1 Subclipse安装
对于 Eclipse，您需要安装 Subclipse 插件。
Subclipse 的安装与其他 Eclipse 插件类似：
1. 从中解压出features与plugins文件夹，复制到E:\MyEclipse\myPlugin\svn里面，其它的*.xml文件不要(新建文件夹myPlugin\svn)。
2. 在E:\MyEclipse\MyEclipse8.5\dropins下新建文件svn.link,内容是:path=E:\\MyEclipse\\myPlugin\\svn保存。
3. 删除E:\MyEclipse\MyEclipse8.5\conf iguration\org.eclipse.update文件夹
4. 重启myeclipse就一切正常了。
4.2 MyEclipse 配置Subclipse
1、 点击MyEclipse → Open Perspectice → other，如图所示：

2、 弹出界面如图，点击“SVN资源研究库”，如图所示：

3、 在左侧空白处点击右键 → 新建 → 资源库位置，如图所示：

4、 在弹出的界面中的URl 填写“svn://localhost”如果是客户端链接服务器，需要在此处填写服务器的IP 地址），并点击finsh，如不报错，说明 配置完成，报错请重新配置，如图所示

4.3 创建、导入项目
1、 在Eclipse中创建一个名为Pro1 的动态Web项目。
2、 右击该项目名称，TeamàShare Project：

3、选中库类型为SVN，然后Next。

4、选中“使用已有资源库位置”，然后“Next”。

5、选中“使用指定的模块名”并输入trunk，也可以通过“浏览”得到服务器上的目录，期间会要求认证。
Note：如果该资源库下有trunk目录，先删除掉，方法见前文。

6、输入密码，可以勾上“保存密码”。

7、在提交时可选择要进行版本控制的文件，默认全部选中，直接“OK”。

4.4 从SVN检出项目
1、点击File—〉New—〉Project：

2、选中“从SVN检出项目”，然后“Next”。

3、如果现有资源库位置列表里有相应的位置，则直接选择，若没有则创建新的资源库位置，方法见上文。

4、选中“trunk”，然后“Next”。

5、项目名称更改为“Pro1”，然后“Next”。

6、 项目的检出位置可以直接使用缺省的工作空间，然后“Finish”。
5. 参考资料
1.1.
1.2.
1.3. http://subversion.tigris.org/
1.4.
1.5.