软件环境:
Svn : CollabNetSubversion-server-1.5.5-1.win32
搭建步骤:
1 建立版本库
Svnadmin create A:/B/repository
例如: >svnadmin create d:/repository
在 D 盘根目录下,建立版本库 svnrepository ,当然版本库的目录可以任意指定。
2 修改属性文件
修改 repository/conf 中的文件内容
文件: Passwd
修改前:
[users]
# harry = harryssecret
# sally = sallyssecret
修改后:
[users]
harry = harryssecret
sally = sallyssecret
这样你就为版本库增加了两个用户: harry , sally ,密码分别是“ = ”后面的内容。我们也可以增加用户,例如
svnuser=svnuser123
文件: svnserve.conf
修改前:
[general]
### These options control access to the repository for unauthenticated
### and authenticated users. Valid values are "write", "read",
### and "none". The sample settings below are the defaults.
# anon-access = read
# auth-access = write
修改后:
[general]
### These options control access to the repository for unauthenticated
### and authenticated users. Valid values are "write", "read",
### and "none". The sample settings below are the defaults.
anon-access = read
auth-access = write
3 添加 svn_path 环境变量
有可能不是必须要完成的步骤,此部分调查中。。。
4 启动服务
启动建立好的版本库服务。
命令: svnserve -d -r 版本库路径
例如: svnserve -d -r D:/repository
注意:启动后请勿关闭窗口,否则服务会被停掉。
5 导入工程到版本库中
命令: svn important 导入文件 PATH 版本库 PATH [ 参数 ]
通过 import 命令,将本地未版本化的工程导入到版本库中。导入完成后, svn 会为导入的文件设定版本号。
例如:将本地机器上的 E:/eclipse_workspace/jdk51 导入到版本库中
命令: C:/>svn import E:/eclipse_workspace/jdk5 file:///d:/repository/jdk5 -m "first import jdk5 on 20090317"
运行结果:
Adding E:/eclipse_workspace/jdk5/.classpath
Adding E:/eclipse_workspace/jdk5/.project
Adding E:/eclipse_workspace/jdk5/src
Adding E:/eclipse_workspace/jdk5/src/jdk
Adding E:/eclipse_workspace/jdk5/src/jdk/autoboxing
Adding E:/eclipse_workspace/jdk5/src/jdk/autoboxing/Autoboxing.java
Adding E:/eclipse_workspace/jdk5/src/jdk/bigdecimal
Adding E:/eclipse_workspace/jdk5/src/jdk/bigdecimal/Bigdecimal.java
Adding E:/eclipse_workspace/jdk5/src/jdk/compare
Adding E:/eclipse_workspace/jdk5/src/jdk/compare/Compare.java
Committed revision 1.
命令说明:
-m :指定导入的 log 信息。 -m 参数是必须的,但是可以指定空内容。否则的话 svn 会启动外部编辑器,编辑 log 内容
/ : svn 的版本库 path ,通过 / 进行分割,而不是 windows 的 /
运行结果说明:
Adding :表示向版本库中追加文件
Committed revision 1. :表示当前版本为 1
注意:
1 import 命令导入时,并不会在版本库中建立一个跟工程名同样的文件目录。只是将本地目录下的文件导入到指定版本库的目录下面。上面的导入操作,就是将 jdk5 下面的文件以及子目录导入到 repository 下面。所以导入的时候,最好先在版本库 repository 中建立好目录
2 对版本库下的文件进行删除,移动,拷贝,请务必使用 svn 的命令,或者客户端工具完成。如果直接在 windows 下进行删除,拷贝,粘贴操作, svn 是无法记录这些操作,同时也就失去了版本控制的意义了。
关于导入时发生的一些问题,参考文章最后。
8 查看版本库文件
命令: svn list 版本库文件目录
通过 list 命令查看版本库任意目录下的文件夹,以及文件。
例如:查看版本库 repository 根目录下的文件目录
命令: C:/>svn list file:///d:/repository/jdk5
运行结果:
.classpath
.project
bin/
src/
注意:
我是在 C 盘下运行的 list 命令,版本库并不在 C 分区下,所以必须指定版本库所在的分区。假如,我门直接在版本库所在的分区下运行 list 命令,无需指定版本库所在的分区
命令: D:/>svn list file:///repository/jdk5
运行结果:
.classpath
.project
bin/
src/
7 取得版本库文件到本地机器
命令: svn checkout 版本库文件 PATH 本地路径文件 PATH [参数]
通过 import 命令,仅仅是将本地代码,导入到版本库中。但是版本库中的代码并没有跟本地代码关联起来,即使我们修改了本地代码,也无法反应到版本库中的。
通过 checkout 命令,从版本库中取得工程的拷贝到本地,所取得的拷贝是和版本库关联在一起的。
例如: 将导入的工程到取到本地机器上
命令: D:/>svn checkout file:///repository/jdk5 e:/jdk5 -r 1
运行结果:
A E:/jdk5/.classpath
A E:/jdk5/.project
A E:/jdk5/src
A E:/jdk5/src/jdk
A E:/jdk5/src/jdk/autoboxing
A E:/jdk5/src/jdk/autoboxing/Autoboxing.java
A E:/jdk5/src/jdk/bigdecimal
A E:/jdk5/src/jdk/bigdecimal/Bigdecimal.java
A E:/jdk5/src/jdk/compare
A E:/jdk5/src/jdk/compare/Compare.java
Checked out revision 1.
命令说明:
-r :指定要取得的文件的版本
运行结果说明:
checkout 命令会自动为每个文件夹在本地建立一个 .svn 的隐藏文件文件夹,这个是存放记录本地文件和版本库关联信息文件的。请勿删除,如果删除了,也就失去了和 svn 版本库的关联关系。
注意:
Checkout 命令取得文件时,并不会在指定的本地路径下,自动建立同名目录,需要事先做成相应的文件目录。
9 修改文件,并且提交到 svn
命令: svn commit 本地文件 PATH
Commit 命令是
例如:修改 E:/jdk5/src/jdk/autoboxing/Autoboxing.java 文件后,提交到 svn 版本库中
命令: D:/>svn commit E:/jdk5/src/jdk/autoboxing/Autoboxing.java -m "change 20090317"
运行结果
Sending E:/jdk5/src/jdk/autoboxing/Autoboxing.java
Transmitting file data .
Committed revision 2.
命令说明:
执行 commit 时,只需要指定要提交的文件的路径即可, svn 会根据“ .svn ”文件夹中记录的内容,将命令解析成“ svn commit 本地文件 PATH 版本库 PATH ”的形式,然后再执行。这里需要注意的是,被解析的“版本库 PATH ”中并不包含分需信息,所以必须在版本库所在的目录下面执行 commit 命令。
上面的命令如果不在 D 分区下执行,会发生下面的错误:
C:/>svn commit E:/jdk5/src/jdk/autoboxing/Autoboxing.java -m "change 20090317"
svn: Commit failed (details follow):
svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///repository/jdk5/src/jdk/autoboxing'
运行结果说明:
Committed revision 2. :为版本库所有文件设定统一的版本号。这里我们可以看到,即使修改了一个文件,但是svn是将整个版本库的版本设定成2了,也就是说svn并不对单独文件设定版本号
10 追加新文件到 svn
命令: svn add 本地目录 PATH
add 命令会将指定的文件目录以及其包含的文件提交到 svn 版本库中,同时会为此文件,建立本地文件到版本库的关联关系(建立 .svn 文件夹)。但是,add命令并不会将文件追加到版本库中,而是需要commit命令进行提交。
例如:把 E:/jdk5/src/jdk/Unboxing添加 到版本库中
命令: D:/>svn add E:/jdk5/src/jdk/Unboxing
运行结果:
A E:/jdk5/src/jdk/unboxing
A E:/jdk5/src/jdk/unboxing/Unboxing.java
注意:
1 add 命令是没有 -m 参数的,原因调查中。。。
2 add 命令并不是真正的把本地文件追加到版本库中,而是让文件或者文件夹在版本控制中,也就是仅仅为文件或者文件夹建立一个和版本库的关联关系。我们用 svn list 可以发现, Unboxing 并没有被追加到版本库中。如下: D:/>svn list file:///d:/repository/jdk5/src/jdk
autoboxing/
bigdecimal/
compare/
generic/
通过 commit 命令,将文件提交到版本库中。
D:/>svn commit E:/jdk5/src/jdk/unboxing -m "add unboxing"
Adding E:/jdk5/src/jdk/unboxing
Adding E:/jdk5/src/jdk/unboxing/Unboxing.java
Transmitting file data .
Committed revision 6.
注意:
因为我是 add 一个文件夹到版本库中的,所以不能单独的 commit 此文件夹下面的某一个文件,只能commit整个文件夹,只提交某一个文件,会发生下面的错误。
D:/>svn commit E:/jdk5/src/jdk/unboxing/Unboxing.java
svn: Commit failed (details follow):
svn: 'E:/jdk5/src/jdk/unboxing' is not under version control and is not part of
the commit, yet its child 'E:/jdk5/src/jdk/unboxing/Unboxing.java' is part of the commit
13 删除版本库文件
命令: svn delete 本地文件 path
svn delete 版本库文件 path
delete 命令,可以执行两种删除,一种是删除本地文件,并且通过修改 .svn 文件,让被删除的文件在版本库的控制之下,但是并不实际删除版本库中的文件,需要通过 commit 命令,提交版本库后,执行对版本库的修改。另一种是直接删除版本库中的文件,无需执行 commit 命令。
方法一:
例如:删除 E:/jdk5/src/jdk/unboxing/Unboxing.java 文件。
命令:
D:/>svn delete E:/jdk5/src/jdk/unboxing/Unboxing.java
D E:/jdk5/src/jdk/unboxing/Unboxing.java
通过 svn list 命令查看,版本库中文件实际还存在,只是删除了本地文件,下面通过 commit 提交删除。
D:/>svn commit E:/jdk5/src/jdk/unboxing/Unboxing.java -m "delete 20090317"
Deleting E:/jdk5/src/jdk/unboxing/Unboxing.java
Committed revision 7.
通过 svn list 命令查看,版本库文件已经被删除。
方法二:
14 查看版本库 log
命令: svn log 版本库PATH
通过 svn log 命令,可以查看对版本库操作的所有的 log 信息,前提是必须在每次对版本库进行操作(导入,删除,修改,移动等)操作是,追加了相应的 log 。
例如:通过 svn log 命令,查看第 5 步中,导入时的 log 信息
命令: C:/>svn log file:///d:/repository
运行结果:
------------------------------------------------------------------------
r3 | wd | 2009-03-17 14:04:27 +0800 ( 火 , 17 3 2009) | 1 line
first import jdk5 on 20090317
导入的过程中,遇到了一些问题,如下:
问题 1 :
E:/eclipse_workspace>svn import jdk5 svn://localhost/repository
svn: Could not use external editor to fetch log message; consider setting the $SVN_EDITOR environment variable or using the --message (-m) or --file (-F) option
s
svn: None of the environment variables SVN_EDITOR, VISUAL or EDITOR are set, and
no 'editor-cmd' run-time configuration option was found
原因:
提示要在windows环境变量中,设置SVN_EDITOR。
问题 2 :
E:/>svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5
'C:/Program' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。
svn: system('C:/Program Files/EmEditor/emeditor.exe svn-commit.tmp') returned
原因:
当没有指定-m参数的时候,svn会启动环境变量SVN_EDITOR中指定的编辑器。上面的命令,没有指定-m参数,但是svn却无法启动SVN_EDITOR设定的编辑器。
解决方法:
在导入命令中,追加 -m 参数,如下
svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5 -m "import"
-m 参数是,导入的时候,需要指定的 log 信息。
问题 3
C:/>svn import E:/eclipse_workspace/jdk5 file:///repository/jdk5 -m "first import jdk5 on 20090317"
svn: Unable to open an ra_local session to URL
svn: Unable to open repository 'file:///repository/jdk5'
原因:
版本库的路径不合法。我们是在 C 分区根目录下执行 import 命令的, svn 默认认为版本库就在 C 分区根目录下,然而实际得到版本库是在 D 分区的根目录下。
解决方法:
修改版本库的绝对路径 file:///d:/repository/jdk
问题 4
在 windows 中,手动关闭 Subversion Server ,为什么导入,还可以正常进行。
转自:http://blog.csdn.net/haru/archive/2009/03/16/3996152.aspx