欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

svn命令行操作(公司新人svn使用教程)

程序员文章站 2023-12-04 20:31:34
一、svn工作原理svn(subversion)的基本工作思路是这样的:在一台服务器上建立一个源代码库,库里可以存放许多不同项目的源程序,由源代码库管理员统一管理这些源程序。每个用户在使用源代码库之前...

一、svn工作原理

svn(subversion)的基本工作思路是这样的:在一台服务器上建立一个源代码库,库里可以存放许多不同项目的源程序,由源代码库管理员统一管理这些源程序。

每个用户在使用源代码库之前,首先要把源代码库里的项目文件下载到本地(checkout),然后用户可以在本地任意修改,最后用svn命令进行提交(commit),由svn源代码库统一管理修改。如下图:

svn命令行操作(公司新人svn使用教程)
  • svn服务器:运行subversion服务的计算机,subversion支持linux和windows,更多的是安装在linux下。svn提供服务有两种方式(运行方式):独立服务器和借助apache服务器,分别使用svn协议和http协议。
  • svn客户端:用户通过svn客户端同svn服务器打交道,svn客户端分为命令行工具和图形化工具。最流行的客户端是tortoisesvn。也可以在eclipse中使用svn插件。
svn命令行操作(公司新人svn使用教程)

二、subversion的使用

可以在
http://subversion.apache.org/packages.html下载svn并安装(本文使用windows版本,过程不多说)。在svn中集成了服务器端和客户端组件:

  • 服务器组件(管理员用):svnadmin、svnserve
  • 客户端组件(程序员用):svn

这些组件命令都位于subversion安装目录下的bin目录下。

友情提示:安装完svn后,通过”svnadmin –version”验证是否安装成功。如果出现错误“svnadmin不是内部或外部命令”,则需要手动将svn的bin目录加入到path环境变量下。

1、创建svn仓库

1)先创建一个目录:e:svnreporepodemo1。后面就使用该目录作为svn仓库。

2)创建仓库:svnadmin create e:svnreporepodemo1。创建仓库后的目录结构如下:

svn命令行操作(公司新人svn使用教程)

3)启动svn服务:svnserve -d -r e:svnreporepodemo1,如下图:

svn命令行操作(公司新人svn使用教程)

这样就启动了repodemo1这个仓库的服务(单仓库),如果在svnrepo目录下还有其他仓库,且要同时启动多个仓库,执行svnserve -d -r e:svnrepo即可(多仓库)。

一般情况下,访问svn仓库的url格式形如:
svn://192.168.1.6/repodemo1,但如果启动的是单仓库,则url直接用:svn://192.168.1.6表示。svn协议的默认端口号为3690。

小技巧:如果需要频繁使用该仓库,则可将该svn服务注册成windows服务,这样在计算机开机时就可以启动该服务。如下图:

svn命令行操作(公司新人svn使用教程)

删除该windows服务:sc delete svnservice。

2、svn客户端操作(命令行)

重点:checkout(检出)、commit(提交)、update(更新)

1)在e盘下建立user1、user2两个目录,模拟两个协同工作的用户的workspace。

2)检出:第一次和svn服务器交互时,需要使用checkout将仓库检出到本地。

svn命令行操作(公司新人svn使用教程)

说明:检出一次,就建立了与svn仓库的连接。

3)提交:commit

在user1目录下新建demo1.java文件,将该文件提交到svn仓库。下图演示了三种典型的错误提交。

svn命令行操作(公司新人svn使用教程)

4)更新:update

切换到user2的工作空间(user2目录下),user2第一次使用svn仓库,需要检出。user2修改demo1.java后提交。切换到user1目录,更新(update)。

svn命令行操作(公司新人svn使用教程)

5)删除与恢复:delete、revert

svn命令行操作(公司新人svn使用教程)

说明:如果delete后,提交到服务器(commit),则服务器上的数据也被删除了(慎用)。

三、svn的目录约定

  • /trunck:开发主线
  • /branches:支线副本
  • /tags:标签副本(一旦创建,不允许修改)

1)使用trunk作为主要的开发目录

一般的,我们的所有的开发都是基于trunk进行开发,当一个版本(release)开发告一段落(开发、测试、文档、制作安装程序、打包等结束后),代码处于冻结状态(人为规定,可以通过hook来进行管理)。此时应该基于当前冻结的代码库,打tag。

当下一个版本/阶段的开发任务开始时,继续在trunk进行开发。此时,如果发现了上一个已发行版本(released version)有一些bug,或者一些很急迫的功能要求,而正在开发的版本(developing version)无法满足时间要求,这时候就需要在上一个版本上进行修改了。解决方法是基于发行版对应的tag,做相应的分支(branch)进行开发。

2)下图为struts2的svn仓库目录:

svn命令行操作(公司新人svn使用教程)

现在struts2的代码使用git管理,所以现在查看struts2的svn仓库是空的。

四、tortoisesvn的使用

tortoisesvn是现在最流行的svn客户端工具,使用图形化界面和svn仓库交互(作为命令行方式的替代)。关于tortoisesvn的安装省略。

安装完成后,在任意位置右击都能看到tortoisesvn选项。

1、基本操作

1)创建仓库

创建目录:e:svnreporepodemo2,进入该目录下,右击 — tortoisesvn — create repository here,并创建默认的svn目录结构,如下图所示:

svn命令行操作(公司新人svn使用教程)

2)检出:checkout

在e盘下建立user3、user4两个目录,模拟两个协同工作的用户的workspace。

进入user3目录下,右击 — svn checkout,在url of repository中输入:
file:///e:/svnrepo/repodemo2。【此时仓库还没有启动svn服务,所以使用file://】

svn命令行操作(公司新人svn使用教程)

3)提交:commit

在user3/trunk目录下新建demo1.java,在该文件上右击 — tortoisesvn — add,则将demo1.java纳入版本控制。然后右击 — svn commit,提交至代码仓库。

4)更新:update

对user4进行上面的检出操作。并修改user4目录下的demo1.java(如增加一个字段),并commit。

回到user3/trunk,右击 — svn update。

5)启动svn服务。这步需要在命令行中输入:svnserve -d -r e:svnrepo

6)访问svn仓库。在任意空白位置右击 — tortoisesvn — repo browser,url输入:
svn://192.168.1.6/repodemo2即可浏览svn仓库中的内容,如下。

svn命令行操作(公司新人svn使用教程)

2、其他操作

下面的操作都位于右键菜单的tortoisesvn中。

1)删除:delete

删除文件或目录,不能直接用windows的删除命令来操作,那样只是没有显示出来,实际并没有删除,在更新后,删除的文件又会被更新出来的。要想从库中删除,必须选中你要删除的内容,tortoisesvn — delete,这样才会将这个文件标记成要删除的。确认需要删除后,使用前面所讲的提交命令,就会真正的在库中删除了。

2)重命名:rename

重命名也不能直接用windows的重命名命令来操作,必须选中你要重命名的文件,tortoisesvn — rename。修改后提交就可以更新到仓库。

改名的处理方式相当于新增了一个以新名称命名的文件,原名称命名的文件进行了删除。

3)还原:revert

在未提交之前,你对前面做的操作反悔了,可以使用revert来恢复。

4)检查更新:check for modifications

① 此功能可以显示你所做的修改有哪些还没有提交的。② 还可以看到版本库里的改动,即别人提交了哪些文件的改动,你还没更新到本地。

5)导出:export

使用svn的工作空间每个目录下面都有一个.svn隐藏目录,利用svn的export命令可轻松地导出不含.svn目录的工作空间。

3、冲突问题的解决(☆)

何时发生:接着4.1节中的操作,假设user3和user4目录下的demo1.java都更新到了最新版本。user3修改demo1.java,提交至仓库。若user4也修改demo1.java并提交,此时user4的tortoisesvn会报提交版本过时的错误,并提醒user4需要更新,更新时就会发生冲突。如下图:

svn命令行操作(公司新人svn使用教程)

对于每个更新冲突的文件,subversion会在冲突文件所在目录下放置了三个文件:

  • demo1.java.mine:发生冲突时的本地版本。
  • demo1.java.r3:最后更新之后的本地版本。
  • demo1.java.r4:仓库中的最新版本。

解决方法 1:

① 在demo1.java上右击 — tortoisesvn — edit conflicts,这时你需要确定哪些代码是需要的,做一些必要的修改然后保存。小技巧:编辑冲突时,可使用直接复制需要的代码到merged窗口即可。

② 编辑完成后保存,直接选择mark as resolved,即标记为冲突已解决。退出编辑冲突窗口,发现冲突发生时生成的三个文件被自动删除了,且demo1.java变成了未提交状态。

svn命令行操作(公司新人svn使用教程)

③ commit,ok。

解决方法 2:

直接修改demo1.java,把其中的一些标记删除即可(前提是服务器上的和本地的内容都需要保存)。

4、tortoisesvn图标

svn命令行操作(公司新人svn使用教程)

部分图标的说明:

  • normal:状态正常
  • modified:对本地的副本做了修改,需要提交到服务器
  • conflicted:有冲突
  • readonly:文件是只读的,要修改必须先获取锁
  • locked:获得锁
  • deleted:计划从版本库中删除
  • added:已被计划纳入版本控制
  • non-versioned:未纳入版本控制

5、认证与授权

所谓认证(authentication),就是给使用该仓库的用户分配一个用户名和密码,用户在连接仓库的时候需要输入用户名/密码。授权(authorization)就是为指定用户分配特定的权限,如只读、读写等。认证与授权的设置需要修改仓库conf目录下的文件,如下:

  • authz:认证文件,分配用户名、密码。
  • passwd:授权文件,为现有用户分配组,并为组分配权限。
  • svnserve.conf:指定认证、授权文件的位置。

1)修改conf/svnserve.conf

svn命令行操作(公司新人svn使用教程)

2)修改conf/passwd

svn命令行操作(公司新人svn使用教程)

3)修改conf/authz

svn命令行操作(公司新人svn使用教程)

这样,当用户再次执行checkout、commit、update时,就会要求认证。

五、subclipse插件的使用

eclipse提供了集成svn的插件 — subclipse,本文重点关注subclipse的使用。eclipse中插件的安装不是这儿的重点。安装成功后,可以看到下面的视图(windows — show view)和透视图(windows — open perspective):

svn命令行操作(公司新人svn使用教程)

下面的操作使用了4.1节中的资源库(repodemo2)。

1)关联资源库

进入svn资源库研究透视图,在svn资源库面板上右键 — 新建 — 资源库位置,url中输入:
svn://192.168.1.6/repodemo2。

2)共享项目:share project

新建一个java project,名称为svnproject,在项目中新建一个demo1.java。

共享项目:在项目上右键 — team — share project…,将项目导入到repodemo2。在输入文件夹名时,一般选择使用项目名称作为文件夹名。

3)提交:commit

共享之后,项目并没有提交到仓库中,此时在项目上右键 — team — commit,就可以将现在的项目提交到仓库中。

4)检出:checkout

新建一个workspace,模拟另外一个用户(user2)。首先还是关联资源库,在svnproject上右键 — 检出为。

svn命令行操作(公司新人svn使用教程)

在demo1.java中新增一个字段并提交(在user2的workspace中做的)。

5)更新:

切换到user1的工作空间,更新项目。不多说,team — update

6)冲突处理

冲突的产生见4.3节。原则:提交之前先更新。

4.3节中的两种解决方法也适用于subclipse,解决方法1对应着subclipse中的synchronize视图(view),解决方法2类同。

六、svn与apache整合(用到再看)

业务场景:在上面的demo中,svn仓库对外提供服务都是通过svn协议,最直观的体现就是url都是以svn://开头的。在开源项目中使用的svn仓库对外提供服务时都是使用http协议,此时需要结合apache服务器。

1)安装apache服务器(假定安装在c:apache2.2)

2)修改c:apache2.2confhttpd.conf释放掉注释和增加红色边框的两行(有顺序要求)

svn命令行操作(公司新人svn使用教程)

3)从svn安装目录的bin目录下,拷贝mod_authz_svn.so和mod_dav_svn.so到c:apache2.2modules目录中

4)用apache服务器的htpasswd创建密码文件

svn命令行操作(公司新人svn使用教程)

5)拷贝project1_password到e:repositorysvnproject1conf目录下

6)拷贝以下内容到apacheconfhttpd.conf最后

svn命令行操作(公司新人svn使用教程)

7)访问
http://localhost/svn/flyne/trunk即可访问svn仓库。