SVN
如何来进行多人协作开发?
在实际工作中,通常是一个小组或者一个团队一起开发同一个项目,不同的人开发不同的功能模块,有一个公共的地方存放项目代码。
如果多个人同时对同一个文件做了修改,比如按照分工,两个人分别做文章模块的增删改查功能,需要操作同一个文件article控制器,如果大家同时完成工作并提交代码,会出现一个代码覆盖的问题。
解决办法:
①合理分配工作任务
②合理分配工作时间
以上两种思路都有一定的局限性。
今天要学习的svn就是用来解决多人协作开发的问题。
一、SVN概述
1、什么是SVN
SVN是Subversion的简称,是一个开放源代码的版本控制系统,是用于多个人共同开发同一个项目,共用资源的目的。
所谓的版本控制,就是记录项目代码文件夹和文件的每一次改动,并为每次改动编上序号,也叫做版本号,用于存储、追踪文件夹和文件的修改历史。
通过版本控制软件,我们可以对项目代码的修改历史进行查看,或者直接把代码恢复到以前的一个版本代码。
2、同类型产品
vss版本控制软件:visual source safe,微软公司开发的基于Windows平台的版本控制软件,入门简单,微软不再对VSS提供技术支持。
cvs版本控制软件:出现比较早的版本控制软件,由于稳定性不是很好,现在基本被替代。
svn版本控制软件:简单、入门容易、国内使用量多,目前主流的版本控制软件。
git版本控制软件:也是使用量比较多的一个版本控制软件
3、使用SVN的好处
①协作开发
②版本回退
③查看项目代码修改历史(领导可以掌控项目的开发进度)
4、SVN执行流程(理解)
①搭建svn服务器,安装svn服务器端软件
②在svn服务器创建项目文件夹(在svn中叫做仓库)
③在开发电脑上安装svn客户端软件
④和svn服务器建立联系(checkout检出操作)
检出操作完成了两件事:一和服务器建立联系 二从svn服务器的仓库下载代码
⑤开发经理写初始版本的核心代码
⑥通过提交操作(commit)把代码提交到svn仓库
⑦开发经理会把svn服务器仓库的地址给到程序员,这个地址是svn协议的地址
svn://ip地址或者svn://localhost
⑧程序员在自己电脑安装svn客户端软件
⑨程序员通过svn的地址从svn仓库下载代码
⑩开发自己的功能模块的代码,需要把代码提交到svn仓库
⑪开发经理从svn仓库更新代码(update),查看代码。
以上流程涉及了三个svn操作:checkout 检出,commit 提交, update 更新。
二、SVN软件的下载和安装
1、服务端与客户端软件的下载
服务端软件(Subversion)
客户端软件(TortoiseSVN)
①服务端软件下载地址:
https://www.collab.net/downloads/subversion
注:服务端软件下载需要先注册登录
下载之后得到下列软件之一:
②客户端下载地址:
https://tortoisesvn.net/downloads.html
下载之后得到下列软件之一:
2、安装服务端软件
安装软件,以64位软件为例:
①双击软件打开以下界面。
②点击Next下一步,两次Next之后打开以下界面。
建议:路径中尽量避免出现空格和中文字符,在以后使用命令时有可能引出问题
③确认安装路径,点击Install安装,进入以下界面,等待进度完成。
④安装进度完成自动进入以下界面,点击Finish完成安装即可,界面关闭。
3、安装客户端软件(重要)
安装软件,以64位软件为例:
①双击软件打开以下界面。
②点击Next下一步,两次Next之后进入以下界面。
③确认安装路径,点击Next下一步,继续点击Install安装,进入以下界面,等待进度完成。
④安装进度完成自动进入以下界面,点击Finish完成安装即可,界面关闭。
⑤客户端软件安装完成,在桌面右键菜单可以看到 svn checkout选项和TortoiseSVN选项,如果没有出现,可能需要重启电脑。
4、中文语言包的安装下载
下载地址:https://tortoisesvn.net/downloads.html
在客户端软件下载页面的下方,有各种语言包的安装文件可供下载。
我们选择下载简体中文语言包,下载对应的32位或64位安装软件。
下载之后得到下列软件之一:
双击软件,点击next下一步,就会自动安装完成。
安装完成之后,一般会自动应用中文,如果没有自动使用中文,需要打开设置页面进行设置:
桌面或空白处 右键菜单->TortoiseSVN->settings
打开设置页面如下:
根据图示可修改软件使用的语言包。
注意:如果要卸载软件重新安装,需要通过软件管家或者控制面板的程序与功能,完整的卸载软件。直接删除安装目录的方式不可行。
三、服务端创建仓库并启动服务
1、创建一个SVN项目(仓库)
服务端通常使用命令行模式操作。
创建svn仓库命令:svnadmin create “仓库地址”
示例:svnadmin create “F:svncangkulog”
这里先在F盘新建svncangku目录,然后打开命令行窗口执行命令创建blog仓库。
注意事项:
①仓库地址建议加上双引号,避免路径中有空格产生错误。
②如果直接使用svnadmin 命令报错,提示“不是一个内部或外部命令”,有两种解决方式:
第一是直接执行svnadmin.exe可执行文件,第二配置环境变量。
③svnadmin 命令本身对应一个可执行文件svnadmin.exe,可以拖拽到命令行直接执行。
svnadmin.exe可执行文件在svn服务端软件安装目录中。其位置及执行方式参考下图:
2、启动仓库服务
要使用svn仓库,必须先启动svn仓库服务。比如使用apache也需要先启动apache服务。
如果在以后的使用中,出现以下错误,就是由于svn服务没有开启。
在命令行模式下执行以下命令启动仓库服务:
svnserve -d[启动模式] -r[仓库地址] “仓库地址”
示例:svnserve -d -r “F:svncangkulog”
执行完成之后:会发现光标换行,持续闪烁,这代表执行成功
注意:启动仓库服务之后,这个命令行窗口需要保持打开(挂起)状态。
如果关闭窗口,仓库服务也会关闭。如果要执行其他命令,再重新打开一个新的命令行窗口。
在启动仓库服务之后,会有一个svn协议的地址svn://localhost或者svn://IP地址,指向我们启动服务时使用的仓库地址。示例:svn://localhost -> F:svncangkulog 。
这类似于使用apache时,http://localhost 指向一个目录。
后续使用svn仓库时,我们需要使用svn://localhost这个svn协议的地址代表仓库地址。
四、客户端使用svn(重点)
1、从svn仓库检出代码
在工作目录(这里为F:workspacelog),在空白处右键菜单->SVN checkout打开检出界面
点击ok检出
第一次检出成功,会在工作目录中出现一个.svn的隐藏目录
注:这个目录充当svn软件管理当前目录下的文件和文件夹的一个“管理员”角色
不要轻易删除或者修改里面的东西
2、给svn仓库提交第一个程序文件
①首先在工作目录新建程序文件
②选中文件,右键TortoiseSVN -> add操作,点击把要提交的文件,添加到svn的提交列表
③再次选中文件,右键点击SVN commit操作
④在打开的提交页面中填写相关信息
④点击ok完成提交
3、设置仓库的写权限
在第一次向仓库提交操作时,会提示没有操作权限
说明:仓库创建后,默认只有读权限,没有写权限(没有提交的权限)
在仓库目录中conf目录下:svnserve.conf主配置文件
打开这个文件:
给匿名用户设置写权限
重新完成提交操作
3、常用指令
Checkout检出指令:第一次和svn仓库取得联系时,下载仓库中所有的代码到本地,一般只需要执行一次。
Commit提交指令:每次修改了文件后,都要执行一次提交操作。按照需要每隔一段时间执行一次。
Update更新指令:把仓库的最新部分代码更新到本地。每次提交之前或者每次开始工作之前需要执行。
Add添加指令:把要提交的文件添加到提交列表(针对新增的文件)。
4、文件和目录的提交
通常要提交的是多个文件和目录的整体
提交方式:
①按照提交第一个文件的方式,一个一个提交(操作麻烦)
②在工作目录空白处右键->svn commit 打开提交页面,手动选中要提交的文件,进行提交
点击ok进行提交:
③对于新增的目录下的新增的文件,不能直接执行add操作和commit操作,右键菜单没有相关选项,解决办法:到上一级目录:通过批量提交的方式,在空白处右键svn commit进行提交
点击ok进行提交
5、svn图标集
1)常规图标:当本地文件与服务器端文件完全同步时,系统显示常规图标
2)冲突图标:如果两个程序员同时修改同一个文件,系统在上传时就会显示冲突图标
3)已删除图标:服务器文件已删除,本地就会显示删除图标
4)增加图标:文件还未上传但是已经添加到上传的队列中
5)无版本控制图标:当前文件是新建的,还未上传
6)修改图标:如果本地文件有修改但未上传就显示修改图标
7)只读图标:服务器端文件如果设置为只读,客户端就显示只读图标
8)锁定图标:如果服务器端文件已锁定,本地就显示锁定图标
9)忽略图标:有的电脑图标可能不显示,如果某些文件与项目无关,可以添加到忽略列表
常用的:
常规图标、冲突图标、增加图标、修改图标
说明:这些图标只是一个辅助功能,用作参考。
五、SVN使用细节
目录关系:
1、SVN中的存储机制(了解)
Svn中有一种特有的存储机制,叫差异存储,每个版本只存储与上一个版本有差异的地方。
在svn仓库中看不到原始的代码文件就是因为差异存储的原因。
在仓库目录blog下的db目录中,有存放每个版本的具体信息的目录:revprops 和 revs
比如记录日志信息的目录中:
2、忽略文件
有的时候,我们在工作目录中存放了一些与项目代码没有直接关系的参考文件,这些文件不需要提交到svn仓库进行管理,所以可以设置为忽略文件,避免它们出现在提交列表中,干扰我们的操作。
操作方式:右键->TortoiseSVN -> add to ignore list 添加到忽略列表, 有四个选项:
设计.psd 选中这一项忽略当前文件
*.psd 选中这一项忽略当前目录下后缀为.psd的所有文件
设计.psd(recursively) recursively是递归的意思,忽略掉所有目录中的该名称的文件
*.psd(recursively) 忽略所有目录中的.psd后缀的文件
反向操作(取消忽略):右键->TortoiseSVN -> remove from ignore list 从忽略列表移除
3、版本回退(重点)
查看项目代码的提交历史日志信息:右键->TortoiseSVN -> show log
版本回退的操作方式:
右键 -> TortoiseSVN -> update to revision
可以手动设置版本号:选中Revision,在输入框填写版本号
也可以点击Show log 选中一个版本,自动填入版本号
设置好要回退的版本号,点击ok进行版本回退。
回退到历史版本后,右键 -> SVN Update 可以回到最新版本。
注意:版本回退功能仅用于查看历史版本代码或者获取历史版本代码,不能回退到历史版本后直接在历史版本基础上继续开发。
版本回退之后,如果在历史版本中修改文件代码,然后提交,会提示错误,文件过期,需要先更新到最新版本再提交。更新时又可能会引起冲突。
比如:
在版本3基础上,先修改一下Application.class.php,写一些代码并提交
提交:
提交后版本为4号
通过版本回退功能,回到3号版本
然后重新修改Application.class.php
直接进行提交操作
点击ok提示我们要更新代码
更新之后,会有冲突的提示:
总结:在版本回退之后,不要在历史版本中修改代码。要先更新到最新版本,然后写代码后再提交。
4、版本冲突(重点)
版本冲突:如果多个人对同一个文件做了修改,然后同时提交,后提交的人会发生代码覆盖的问题,这在svn中就叫“版本冲突”。
发生版本冲突,本质还是因为后提交的人,其提交代码时代码的版本不是最新的,也就是其在一个历史版本提交了代码,引起了版本冲突。
这个冲突不是直接发生在svn仓库,是发生在提交者本地的代码。svn提示后提交的人需要先更新svn仓库中的最新版本代码,然后其本地的代码就会有冲突提示。
冲突的表现:
①文件上出现冲突图标,文件下方出现一些新的文件
②文件中的代码有变化,里面有多个版本的代码
代码中冲突的部分会出现很多标记,每个标记之间的代码分别是不同版本的代码。
说明:这里变化的这部分代码是发生冲突的代码,如果文件中有其他不受冲突影响的代码,会正常的显示,我们要处理的只是其中发生冲突的部分。
强调:发生冲突之后,一定要解决冲突,再提交。
处理冲突的方式:
①根据需要,处理文件中的代码,保留最终需要留下并提交的代码
②选中冲突的文件,右键->TortoiseSVN -> resolve解决冲突,这个操作是标记文件,表示这个冲突已经被处理,代码可以直接提交了。操作之后会自动把冲突产生的多余文件删除。
注:冲突是发生在客户端本地的,版本回退也是在本地回退,svn仓库中的代码是不受影响的,各个版本在svn仓库中都还是存在的。
冲突处理完成,进行提交操作。
提交成功:
5、配置多仓库
在工作中,通常我们要同时开发多个项目,比如一个blog博客,一个shop商城,都需要使用svn来管理,这里需要新建一个仓库shop
在工作目录shop中直接进行检出checkout操作,发现得到的是blog仓库的代码,并不是shop仓库的代码
即使重新开启一次仓库服务,想把svn://localhost 绑定到shop仓库,实际上没有生效。
解决办法:
配置多仓库
重新开启仓库服务,把仓库地址改为多个仓库的共同上级目录,会把svn://localhost指向该上级目录,
在需要使用仓库时比如检出操作时,在svn://localhost后面加上/仓库名称:
比如svn://localhost/shop
在工作目录shop中重新checkout:
结果:正确检出了shop仓库
在原来的blog工作目录,直接使用update等操作时会提示错误:
原因是blog仓库的检出地址还是原来的svn://localhost,需要改变为svn://localhost/blog
操作方式:右键->TortoiseSVN -> relocate重新定位仓库地址
点击之后
修改路径为svn://localhost/blog
重新执行update等操作就可以成功了
6、权限控制
我们之前通过给匿名用户设置写权限来使用svn,这种方式在实际工作中是不安全的。
svn提供了一个权限控制功能,可以限制用户对仓库的读写权限。
权限控制分为认证(Authentication)和授权(Authorization)
认证文件:鉴别用户身份,可以设置用户名和密码(passwd)
授权文件:判断用户是否具备某种操作的权限(authz)
设置权限控制的步骤:
打开该仓库主配置文件svnserve.conf,关闭匿名用户的访问权限
开启认证文件
开启授权文件
打开passwd文件,设置用户名和密码
打开authz文件,设置哪些用户具有哪些权限
①直接给指定的用户设置权限
重新在工作目录中进行操作比如更新操作:
会弹出以下权限认证界面
输入用户名和密码,可以选择保存认证信息(即记住用户名和密码),如果认证成功,以后就不用再次认证。否则,每一次操作都需要进行认证。
②对用户进行分组,然后对分组设置权限
设置完成之后,配置都会立即生效
7、清除保存的认证信息
保存认证信息后,不会再次弹出认证界面,如果需要更改认证信息(用户名和密码),则需要先清除svn保存的认证信息
在svn的设置页面 (右键->TortoiseSVN->settings)
点击clear选择指定的用户信息进行清除或者clearAll 可以清除所有
然后重新执行update等操作就可以唤起用户名密码输入界面
六、SVN自启动服务与批处理指令
1、为什么需要自启动服务
开启仓库服务,我们是要保持命令行黑窗口的挂起状态,这种方式不友好,如果不小心关闭了这个窗口,整个svn服务就关闭了。更友好的方式,是把svn仓库服务设置成自启动的服务。
2、创建自启动服务
示例:sc create svn binPath= "F:Subversionsvnserve.exe -r F:svncangku --service" start= auto
--service 说明其为服务项目
start= auto说明电脑开机就自动启动该服务
① 必须使用管理员身份打开命令行窗口
② 图示指定位置必须放置一个空格,否则创建会失败。
执行:
成功之后,可以右键我的电脑-管理,打开计算机管理页面来查看服务
点击“服务”,查找创建服务时使用的服务名称比如svn
第一次需要手动启动,以后重启电脑之后可以自动启动
3、批处理指令
服务的启动停止可以通过执行命令来实现:
net start svn 启动svn服务
net stop svn 停止svn服务
sc delete svn 删除svn服务(记住:svn如果需要删除必须先停止)
这些命令都需要在管理员权限下来执行
为了方便,可以把这些指令分别保存到一个文件当中,比如start.bat stop.bat
然后以管理员的身份运行这些文件,可以达到和执行命令相同的效果
七、钩子程序同步代码
1、钩子程序原理
每次向svn仓库提交代码之后,需要在apache下来更新一次最新的代码,这样比较麻烦,有一种自动同步代码的解决方案---使用钩子程序
原理:每次想svn仓库提交代码,这个钩子程序会检测到这次改动,自动在apache下执行一次svn的update操作更新代码。
2、使用同步钩子(post-commit)程序
① 在服务器端apache创建一个文件夹接收同步数据,比如创建F:workspaceonline目录
② 在本地和服务器端同时检出svn仓库最新数据
③打开服务器的Blog仓库,找到hooks钩子目录,新建一个post-commit.bat批处理文件,然后输出如下代码(需要根据实际情况修改里面的内容)
SET SVN=”F:Subversionsvn.exe” 设置svn指令目录
SET DIR=”F:workspaceonline” 设置需要同步的目录
SVN update %DIR% [--username a --password b] 使用update指令更新数据到同步目录
比如:
设置完成,可以测试一下:
在工作目录blog新增一个文件并提交
在线上目录online下发现,新增的文件自动更新下来了。