CVS操作手册

  • 格式:pdf
  • 大小:166.44 KB
  • 文档页数:14

CVS使用手册内容摘要:CVS是一个C/S系统,多个开发人员通过一个中心版本控制系统来记录文件版本,从而达到保证文件同步的目的。

工作模式如下:CVS服务器(文件版本库)/|\(版本同步)/|\开发者1开发者2开发者3作为一般开发人员挑选2,6看就可以了,CVS的管理员则更需要懂的更多一些,最后还简单介绍了一些Windows下的cvs客户端使用,CVS远程用户认证的选择及与BUG跟踪系统等开发环境的集成问题。

1.CVS环境初始化:CVS环境的搭建管理员2.CVS的日常使用:日常开发中最常用的CVS命令,开发人员管理员3.CVS的分支开发:项目按照不同进度和目标并发进行管理员4.CVS的用户认证:通过SSH的远程用户认证,安全,简单管理员5.CVSWEB:CVS的WEB访问界面大大提高代码版本比较的效率管理员6.CVS TAG:将$Id$加入代码注释中,方便开发过程的跟踪开发人员7.CVS vs VSS:CVS和Virsual SourceSafe的比较开发人员管理员8.WinCVS:通过SSH认证的WinCVS认证设置9.基于CVSTrac的小组开发环境搭建:通过CVSTrac实现web界面的CVS用户管理,集成的BUG跟踪和WIKI交流10.CVS中的用户权限管理:基于系统用户的CVS权限管理和基于CVSROOT/passwd的虚拟用户管理一个系统20%的功能往往能够满足80%的需求,CVS也不例外,以下是CVS最常用的功能,可能还不到它全部命令选项的20%,作为一般开发人员平时会用cvs update和cvs commit就够了,更多的需求在实际应用过程中自然会出现,不时回头看看相关文档经常有意外的收获。

CVS环境初始化环境设置:指定CVS库的路径CVSROOTsetenv CVSROOT/path/to/cvsrootbashCVSROOT=/path/to/cvsroot;export CVSROOT后面还提到远程CVS服务器的设置:CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsrootCVS_RSH=ssh;export CVSROOT CVS_RSH初始化:CVS版本库的初始化。

cvs init一个项目的首次导入cvs import-m"write some comments here"project_name vendor_tag release_tag执行后:会将所有源文件及目录导入到/path/to/cvsroot/project_name目录下vender_tag:开发商标记release_tag:版本发布标记项目导出:将代码从CVS库里导出cvs checkout project_namecvs将创建project_name目录,并将最新版本的源代码导出到相应目录中。

这个checkout和Virvual SourceSafe中的check out不是一个概念,相对于Virvual SourceSafe的check out是cvs update,check in是cvs commit。

CVS的日常使用注意:第一次导出以后,就不是通过cvs checkout来同步文件了,而是要进入刚才cvs checkout project_name导出的project_name目录下进行具体文件的版本同步(添加,修改,删除)操作。

将文件同步到最新的版本cvs update不制定文件名,cvs将同步所有子目录下的文件,也可以制定某个文件名/目录进行同步cvs update file_name最好每天开始工作前或将自己的工作导入到CVS库里前都要做一次,并养成“先同步后修改”的习惯,和Virvual SourceSafe不同,CVS里没有文件锁定的概念,所有的冲突是在commit之前解决,如果你修改过程中,有其他人修改并commit到了CVS库中,CVS会通知你文件冲突,并自动将冲突部分用>>>>>>content on cvs server<<<<<<content in your file标记出来,由你确认冲突内容的取舍。

版本冲突一般是在多个人修改一个文件造成的,但这种项目管理上的问题不应该指望由CVS来解决。

确认修改写入到CVS库里cvs commit-m"write some comments here"file_name注意:CVS的很多动作都是通过cvs commit进行最后确认并修改的,最好每次只修改一个文件。

在确认的前,还需要用户填写修改注释,以帮助其他开发人员了解修改的原因。

如果不用写-m"comments"而直接确认`cvs commitfile_name`的话,cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。

注释的质量很重要:所以不仅必须要写,而且必须写一些比较有意义的内容:以方便其他开发人员能够很好的理解不好的注释,很难让其他的开发人员快速的理解:比如:-m"bug fixed"甚至-m""好的注释,甚至可以用中文:-m"在用户注册过程中加入了Email地址校验"修改某个版本注释:每次只确认一个文件到CVS库里是一个很好的习惯,但难免有时候忘了指定文件名,把多个文件以同样注释commit到CVS库里了,以下命令可以允许你修改某个文件某个版本的注释:cvs admin-m 1.3:"write some comments here"file_name添加文件创建好新文件后,比如:touch new_filecvs add new_file注意:对于图片,Word文档等非纯文本的项目,需要使用cvs add-kb选项按2进制文件方式导入(k表示扩展选项,b表示binary),否则有可能出现文件被破坏的情况比如:cvs add-kb new_file.gifcvs add-kb readme.doc如果关键词替换属性在首次导入时设置错了怎么办?cvs admin-kkv new_file.css然后确认修改并注释cvs ci-m"write some comments here"删除文件将某个源文件物理删除后,比如:rm file_namecvs rm file_name然后确认修改并注释cvs ci-m"write some comments here"以上面前2步合并的方法为:cvs rm-f file_namecvs ci-m"why delete file"注意:很多cvs命令都有缩写形式:commit=>ci;update=>up;checkout=>co/get;remove=>rm;添加目录cvs add dir_name查看修改历史cvs log file_namecvs history file_name查看当前文件不同版本的区别cvs diff-r1.3-r1.5file_name查看当前文件(可能已经修改了)和库中相应文件的区别cvs diff file_namecvs的web界面提供了更方便的定位文件修改和比较版本区别的方法,具体安装设置请看后面的cvsweb使用正确的通过CVS恢复旧版本的方法:如果用cvs 这个命令是给加一个STICK TAG:"1.2",虽然你的本意只是想将它恢复到1.2版本正确的恢复版本的方法是:cvs update-p-r1.2file_name>file_name如果不小心已经加成STICK TAG的话:用cvs update-A解决移动文件/文件重命名cvs里没有cvs move或cvs rename,因为这两个操作是可以由先cvs remove old_file_name,然后cvs add new_file_name实现的。

删除/移动目录最方便的方法是让管理员直接移动,删除CVSROOT里相应目录(因为CVS一个项目下的子目录都是独立的,移动到$CVSROOT目录下都可以作为新的独立项目:好比一颗树,其实砍下任意一枝都能独立存活),对目录进行了修改后,要求其开发人员重新导出项目cvs checkout project_name或者用cvs update-dP同步。

项目发布导出不带CVS目录的源文件做开发的时候你可能注意到了,每个开发目录下,CVS都创建了一个CVS/目录。

里面有文件用于记录当前目录和CVS库之间的对应信息。

但项目发布的时候你一般不希望把文件目录还带着含有CVS信息的CVS目录吧,这个一次性的导出过程使用cvs export命令,不过export只能针对一个TAG或者日期导出,比如:cvs export-r release1project_namecvs export-D2*******project_namecvs export-D now project_nameCVS Branch:项目多分支同步开发确认版本里程碑:多个文件各自版本号不一样,项目到一定阶段,可以给所有文件统一指定一个阶段里程碑版本号,方便以后按照这个阶段里程碑版本号导出项目,同时也是项目的多个分支开发的基础。

cvs tag release_1_0开始一个新的里程碑:cvs commit-r2标记所有文件开始进入2.x的开发注意:CVS里的revsion和软件包的发布版本可以没有直接的关系。

但所有文件使用和发布版本一致的版本号比较有助于维护。

版本分支的建立在开发项目的2.x版本的时候发现1.x有问题,但2.x又不敢用,则从先前标记的里程碑:release_1_0导出一个分支release_1_0_patchcvs rtag-b-r release_1_0release_1_0_patch proj_dir一些人先在另外一个目录下导出release_1_0_patch这个分支:解决1.0中的紧急问题,cvs checkout-r release_1_0_patch而其他人员仍旧在项目的主干分支2.x上开发在release_1_0_patch上修正错误后,标记一个1.0的错误修正版本号cvs tag release_1_0_patch_1如果2.0认为这些错误修改在2.0里也需要,也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中:cvs update-j release_1_0_patch_1CVS的远程认证通过SSH远程访问CVS使用cvs本身基于pserver的远程认证很麻烦,需要定义服务器和用户组,用户名,设置密码等,常见的登陆格式如下:cvs-d:pserver:cvs_user_name@cvs.server.address:/path/to/cvsroot login例子:cvs-d:pserver:cvs@:/cvsroot login不是很安全,因此一般是作为匿名只读CVS访问的方式。