linux嵌入式编程高手历程系列4－用cvs进行版本管理

     开发环境搭好之后，项目就可以正式启动了。面对海量的代码，频繁的代码更新，如何管理代码提到议事日程。在linux下，经典的版本管理软件是cvs。下面重点介绍cvs服务的建立过程和管理的相关命令。

    在此强调一下，这些相关的操作，都是在虚拟机环境下进行的。

    参考：CVS服务器建立和权限配置 http://www.chinaunix.net/jh/4/362866.html

http://man.chinaunix.net/develop/cvsdoc_zh/

一.安装cvs

    apt-get install cvs  从网络安装cvs。这个cvs程序既可以做客户端也可以做服务器。

    debian的安装真是一个很享受的过程。

    apt-get install cvsd

http://www.linuxdiyf.com/viewarticle.php?id=77033

    cvsd是cvs的一个pserver的wrapper，能够非常方便地管理repositories和users，并且以更 安全的形式运行cvs服务。

二.建立cvs服务器

    　　修改配置文件
检查一下/etc/cvsd/cvsd.conf文件，确认最后几行类似如下的形式：
RootJail /home/cvs
Repos /repos

第一行的意思就是你的cvsd的根目录，第二行是你的repositories的目录，注意这儿虽然写的是绝对路径，实际上是相对于$cvsdHome的路径，在这里就是指/home/cvs/repos。
建立repositories
如果你在配置cvsd主目录的时候选择了none，你也可以手动创建/home/cvs目录，然后执行
cvsd-buildroot /home/cvs

将cvsd根目录的文件系统建立起来。
然后是创建repositories并初始化：
mkdir /home/cvs/repos
cvs -d /home/cvs/repos init

添加用户
添加用户就很简单了，跟其它服务器程序类似，cvsd可以添加基于本地用户的虚拟用户，如下：
cvsd-passwd /home/cvs/repos cvsuser:cvsd
chown -R cvsd.cvsd /home/cvs/repos

重启服务
最后我们用/etc/init.d/cvsd restart重启cvs服务就可以使用了。

   三.添加多用户

添加多个用户
cvsd-passwd /home/cvs/repos user1
cvsd-passwd /home/cvs/repos user2
cvsd-passwd /home/cvs/repos user3

对于本项目：

添加用户

cvsd-passwd /usr/local/source wafer

查看用户：

cd /usr/local/source/CVSROOT

vi passwd

   四.本地登陆

注意用户登录时还是需要使用相对路径，如：
cvs -d :pserver:cvsuser@localhost:/repos login

    五.远程登陆

在远程登陆的linux机器上配置CVSROOT

export CVSROOT=:pserver:[email protected]:2401/source

敲cvs login登陆

    六.使用命令

 一个项目的首次导入
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_name
cvs 将创建project_name目录，并将最新版本的源代码导出到相应目录中。这个checkout和Virvual SourceSafe中的check out不是一个概念，相对于Virvual SourceSafe的check out是cvs update， check in是cvs commit。注意：第一次导出以后，就不是通过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 commit file_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_file
cvs add new_file
注意：对于图片，Word文档等非纯文本的项目，需要使用cvs add -kb选项按2进制文件方式导入(k表示扩展选项，b表示binary)，否则有可能出现文件被破坏的情况
比如：
cvs add -kb new_file.gif
cvs add -kb readme.doc

如果关键词替换属性在首次导入时设置错了怎么办？
cvs admin -kkv new_file.css

然后确认修改并注释
cvs ci -m "write some comments here"

删除文件
将某个源文件物理删除后，比如：rm file_name
cvs rm file_name
然后确认修改并注释
cvs ci -m "write some comments here"
以上面前2步合并的方法为：
cvs rm -f file_name
cvs ci -m "why delete file"
注意：很多cvs命令都有缩写形式：commit=>ci; update=>up; checkout=>co/get; remove=>rm;

添加目录
cvs add dir_name

要增加带有多级目录和文件的子目录，方法是导入一个目录
比如原项目叫abc，在abc目录下想增加一个带有多级目录和文件的目录jni，
cd jni
cvs import -m "new dir jni" abc/jni weiqiongimport R1_0_0_0
然后，客户端(自己和其他人的客户端)需要
cvs update -d 获取最新的目录更新

查看修改历史
cvs log file_name
cvs history file_name

查看当前文件不同版本的区别
cvs diff -r1.3 -r1.5 file_name
查看当前文件（可能已经修改了）和库中相应文件的区别
cvs diff file_name
cvs的web界面提供了更方便的定位文件修改和比较版本区别的方法，具体安装设置请看后面的cvsweb使用

正确的通过CVS恢复旧版本的方法：
如果用cvs update -r1.2 file.name
这个命令是给file.name加一个STICK TAG： "1.2" ，虽然你的本意只是想将它恢复到1.2版本
正确的恢复版本的方法是：cvs update -p -r1.2 file_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 release1 project_name
cvs export -D 20021023 project_name
cvs export -D now project_name

 

    七.版本管理进阶

1.时间同步

 cvs用户端与cvs服务器之间时间同步极其重要。可以在两端都安装ntp来同步时间。

命令：apt-get install ntp

设定时区：ln -s /etc/localtime /usr/share/zoneinfo/Asia/Shanghai