CVS进行项目开发管理

使用CVS进行项目开发管理

来源:本文出自:http://www.swm.com.cn 作者:张云帆 (2001-11-06 07:00:00)

<!---->在多人共同开发一个大型项目时，源代码的维护和版本维护是一件令人头疼的事情，由于多人开发，
每个开发人员都拥有此项目的副本，所以如果要手动维护同一个文件多人的修改是十分困难的事情。
另外，可能你需要的项目的版本不是当前开发的最新的版本， 如果为了这个目的而为每一个版本
保留一个备份几乎是不可能的。Linux平台上提供了一个功能软件：CVS。众所周知，Linux的发展
得益于互联网的发展，大部分的软件都是众多开发者在互联网上共同开发的，这些软件的维护大部
分都使用CVS，例如Deban Linux的开发、KDE的开发，以及sourceforg上的开发项目。正确熟练使
用CVS是一个Linux程序员基本的素质。


CVS不仅可以维护源代码，事实上，所有的文本文件都可以使用CVS来管理，当然也可以管理 二进
制文件，只是需要特殊的命令选项罢了。

CVS把文件保存在一个名叫仓库（repository）的地方，仓库中保存的文件并不是每个版本的副本，
而是可以从任意版本回溯到初始版本的一些代码的主控信息，这样，就节省了大量的存储空间。
仓库不仅可以建立在本机上，也可以建立在网络上。另外CVS支持版本分支（tag），这样可以从
任意的版本中衍生出另外一个版本进行开发，必要时，还可以把这个分支合并到主开发分支去。

CVS需要一个名叫RCS（修订控制系统）的软件，确切说，CVS主要管理开发项目中的目录的改动，
而RCS则侧重于管理的一个文件的改变。如果要使用网络的CVS，还需要rsh或者自己内置的
cvs-server，rsh是CVS客户于服务器的通信平台，如果需要安全的信息传输，可以使用ssh，
这个可以使用CVS_RSH环境变量来指定：
export CVS_RSH=rsh 使用rsh
export CVS_RSH=ssh 使用ssh

RCS使用
在使用CVS之前，先介绍一下RCS的使用方法。
正如前面所说，RCS是针对某一个特定的文件进行管理，常用到的命令是co和ci。RCS使用当 前工
作路径下的RCS目录来存储管理的文件。
ci （check in)把源代码加入到RCS源代码仓库中，每一个添加进代码库中的文件的版本是 1.1。
以后每次修改文件重新ci以后，此文件的版本递增为1.2 ，1.3.……。
co（check out）把源文件从RCS源代码仓库中取出，缺省的版本是最新的版本，如果你需要一个
指定的版本，则需要使用-r选项指定。例如：
$mkdir RCS 建立RCS源代码仓库
编辑一个文件，如hello.c
#include <stdio.h>
int main (void)
{
printf ("Hello World\n");
return 0;
}
然后把它加入到RCS仓库中：
[kerberos@power zhyf]$ ci hello.c
RCS/hello.c,v <-- hello.c
enter description, terminated with single '.' or end of file:
NOTE: This is NOT the log message!
>>the inital verion. 输入关于文件改动的信息
>> . 以.结束信息输入
initial revision: 1.1 初始版本是1.1
done
[kerberos@power zhyf]$
当文件加入到源代码仓库后，RCS会自动删除文件。

如果需要修改文件，则从仓库取出：
[kerberos@power zhyf]$ co hello.c
RCS/hello.c,v --> hello.c
revision 1.1
done
此时，取出的文件是只读的，如果需要编辑文件，需要对文件加锁取出，防止与他人编辑冲突。 
加锁取出使用-l (lock)选项。
[kerberos@power zhyf]$ co -l hello.c
RCS/hello.c,v --> hello.c 从RCS仓库中取出hello.c，仓库中的文件是以v结尾的。
revision 1.1 (locked) 指明是加锁取出
done
这时，我们就可以修改和编辑文件了。
例如：
#include <stdio.h>
int main (void)
{
printf ("Hello World\n");
printf("checkoutwithlock\n"); 添入代码
return 0;
}
[kerberos@power zhyf]$ ci hello.c
RCS/hello.c,v <-- hello.c
new revision: 1.2; previous revision: 1.1 重新加入到仓库，文件版本递增为1.2
enter log message, terminated with single '.' or end of file:
>> check out with lock and modified it .
>> .
done
如果你需要先前的hello.c,也就是1.1版本的，可以使用-r来指定取出文件的版本：
[kerberos@power zhyf]$ co -l -r1.1 hello.c
hello.c,v --> hello.c
revision 1.1 (locked) 取出1.1版本
done
可以尝试使用两次加锁取出，这时候，RCS会提示警告信息。
[kerberos@power zhyf]$ co -l hello.c
hello.c,v --> hello.c
revision 1.1 (locked)
writable hello.c exists; remove it? [ny](n) 是否覆盖当前的hello.c
如果回答n,则取出失败，回答是则覆盖当前文件
与-l相反的选项是-u，取出不加锁的文件用于工作。-f则在ci时强制覆盖RCS仓库中的文件，
 在co时强制覆盖当前的文件。 

在RCS中，支持类似于宏的关键字，在ci后，这些关键字会被RCS替换成特定的信息，
如$Id$关键字：
/*$Id
*/
#include <stdio.h>
int main (void)
{
printf ("Hello World\n");
printf("checkoutwithlock\n");
return 0;
}
ci 之后，然后取出，文件将变成：
/*$Id: hello.c,v 1.3 2001/02/22 16:16:58 kerberos Exp kerberos $
*/
#include <stdio.h>
int main (void)
{
printf ("Hello World\n");
printf ("check out with lock\n");
return 0;
}
$Id$ 关键字是用文件名、版本、时间、作者 及代码性质替换，如果使用-l选项取出，在Exp后
面会加上登录用户的名称。除了$Id$关键字，RCS还支持下面常用的关键字：
$Log$ : 你所提供的修改日志信息。
$Author$ ：存入该版本的作者。
$Locker$ : 该版本的加锁者
$State$ : 该版本的状态 Exp（试验版）, Stabe（稳定版）, Rel（发行版）.缺省是Exp
$Date$ : 该版本存入的时间，使用UTC时间格式。
$Revision$ : 该版本的版本号
$RCSfile$ : RCS文件名
$Source$ : RCS全路径名
$Name$ : 取回该版本的符号名
$Header$ : 相当于$ Source $$ Revision$$Date$$Author $$State$$Locker$的组合
在UNIX/Linux下有一个diff工具可以比较两个文件的不同，rcsdiff可以在不同的版本之间比
较文件的不同，而不必取出文件，如：
rcsdiff hello.c 比较当前hello.c文件与RCS仓库中最新版本的区别。
rcsdiff -r1.1 hello.c 比较当前hello.c文件与hello.c的1.1版本的区别。
rcsdiff -r1.2 -r1.1 比较hello.c 文件的1.1版本和1.2版本的区别。
使用这个命令，可以很方便的做出任意版本之间的补丁文件。
另外，还有其他一些不常用的RCS命令，读者可以参考更详细的资料。

CVS使用
下面我们就讲一下CVS的使用和管理。

在使用CVS之前，必须要指定CVS的根路径，不像RCS是工作在工作目录下的RCS目录下。指定
CVS路径的方法有两种，一种是使用cvs-d 选项指定，如：
cvs -d /home/kerberos/cvsroot 指定/home/kerberos/cvsroot为CVS仓库的路径。
另外一种是使用CVSROOT环境变量指定(bash下)：
export CVSROOT=/home/kerberos/cvsroot

无论何种方式，每当重新开启一次终端会话，CVS仓库的路径都要重新设置，你可以把以上的
后者加入到其实目录下的.bashrc文件中，这样开启一次终端会话后，不需要重新设置了（对
于其他的环境变量的设置也是如此）。如果你的CVSROOT环境变量已经存在，可以使用cvs -d 
选项来指定不同于CVSROOT所指定的CVS仓库。然后初始化CVS仓库，建立CVS维护所需要的一些
文件和信息,CVS把这些信息存放在CVS仓库主目录的CVSROOT目录下。这些文件，除了modules ，
其他文件都没有手动修改的必要，modules 文件定义了CVS的导出模块在CVS仓库中的位置，
这一点在从CVS仓库中导出一个深层目录时是非常方便的。

cvs init
初始化之后，我们使用cvs import来把需要进行版本维护的开发项目的目录结构导入到CVS仓
库中，如下：
建立好项目的目录结构以后，当前的testprj目录的结构是这样的：

[kerberos@power zhyf]$ tree testprj
testprj
|-- admin
|-- doc
|-- include
|-- libs
`-- src
|-- include
`-- main

7 directories, 0 files
cvs import有三个参数：第一个是这个目录树在CVS仓库中的模块名称，第二个是发布者的一个
标志，第三个是这个项目的版本标记（tag)。下面，我们把testprj导入到CVS仓库中，使用
testprj 模块名称。
[kerberos@power testprj]$cvs import testprj KERBEROS INITVER

执行命令以后，CVS会调用CVSEDITOR指定的编辑器来让你输入日志，如果CVSEDITOR没有定义，
缺省调用vi，可以使用export命令指定你自己喜欢使用的编辑器。输入日志以后，CVS把当前的
目录结构导入CVS仓库中，并且使用testprj这个模块名称，在导出文件时，就可以使用
cvs co testprj 来导出。
"/tmp/cvscVxZnW" 5L, 242C written
cvs import: Importing /home/zhyf/cvsroot/testprj/admin
cvs import: Importing /home/zhyf/cvsroot/testprj/libs
cvs import: Importing /home/zhyf/cvsroot/testprj/src
cvs import: Importing /home/zhyf/cvsroot/testprj/src/include
cvs import: Importing /home/zhyf/cvsroot/testprj/src/main
cvs import: Importing /home/zhyf/cvsroot/testprj/doc
cvs import: Importing /home/zhyf/cvsroot/testprj/include

No conflicts created by this import

看一下cvsroot目录中的结构是不是和testprj 的相同:


../cvsroot
|-- CVSROOT
| |-- checkoutlist
| |-- checkoutlist,v
| ........................... CVS的仓库信息，省略..
| ...........................
`-- testprj
|-- admin
|-- doc
|-- include
|-- libs
`-- src
|-- include
`-- main

这里testprj 模块的结构和我们自己的testprj的目录结构是一样的。
这样，当需要再次使用这些源代码时，就可以简单的使用cvs co模块名来导出目录树和文
件了。导出任意具有写权限的目录下：
[kerberos@power testprj]$ cd ..
[kerberos@power zhyf]$ rm -rf testprj 删除testprj目录
[kerberos@power zhyf]$ cvs co testprj 重新导出
cvs checkout: Updating testprj
cvs checkout: Updating testprj/admin
cvs checkout: Updating testprj/doc
cvs checkout: Updating testprj/include
cvs checkout: Updating testprj/libs
cvs checkout: Updating testprj/src
cvs checkout: Updating testprj/src/include
cvs checkout: Updating testprj/src/main
[kerberos@power zhyf]$ tree testprj
testprj
|-- CVS
| |-- Entries
| |-- Repository
| `-- Root
|-- admin
| `-- CVS
| |-- Entries
| |-- Repository
| `-- Root
|-- doc
| `-- CVS
| |-- Entries
| |-- Repository
| `-- Root
|-- include
| `-- CVS
| |-- Entries
| |-- Repository
| `-- Root
|-- libs
| `-- CVS
| |-- Entries
| |-- Repository
| `-- Root
`-- src
|-- CVS
| |-- Entries
| |-- Repository
| `-- Root
|-- include
| `-- CVS
| |-- Entries
| |-- Repository
| `-- Root
`-- main
`-- CVS
|-- Entries
|-- Repository
`-- Root

CVS在每个目录下面都建立了一个名叫CVS的目录，此外，目录的结构是一样的，事实上，
CVS目录中存放的是一些关于目录结构在仓库中的信息，Entries中包含了这些目录中的子目录，
Respository包含此目录在仓库中的相对位置，ROOT包含导出的模块主目录的绝对路径。

cvs import命令只是在第一次把项目导入CVS仓库时才使用，以后如果再需要加入目录或者加入
文件，则使用cvs add 命令加入，然后使用cvs commit提交之后，文件或者目录才会真正加入到
CVS仓库中。我们可以把刚才编辑的hello.c文件拷贝到testprj/src/main/中，然后使用:
[kerberos@power zhyf]$ cvs add testprj/src/main/hello.c
cvs add: scheduling file `testprj/src/main/hello.c' for addition
cvs add: use 'cvs commit' to add this file permanently

使用cvs commit提交修改
[kerberos@power zhyf]$ cvs commit
cvs commit: Examining testprj
cvs commit: Examining testprj/admin
cvs commit: Examining testprj/doc
cvs commit: Examining testprj/include
cvs commit: Examining testprj/libs
cvs commit: Examining testprj/src
cvs commit: Examining testprj/src/include
cvs commit: Examining testprj/src/main
RCS file: /home/zhyf/cvsroot/testprj/src/main/hello.c,v
done
Checking in testprj/src/main/hello.c;
/home/zhyf/cvsroot/testprj/src/main/hello.c,v <-- hello.c
initial revision: 1.1

使用RCS管理单个文件
done

testprj/src/main/hello.c

由于CVS使用RCS管理单个文件，所以，前面我们讲的关于RCS的知识也可以用到这里，唯一不同的
是命令之前要限定是cvs,比如cvs ci, cvs co, cvs diff, 或者在导出时使用 -r 选项指定导出的
文件的版本。在源代码文件中，同样也可以使用RCS的关键字。
对于非ASCII文件，如二进制可执行文件，位图等文件，我们不能直接使用cvs add
加入到CVS仓库中，因为CVS只是基于ASCII代码比较文件的改变，所以，对于二进制文件，如果单
纯使用cvs add 命令会破坏文件的完整，所在加入二进制文件时，要指定-kb参数。如果对已有文
件进行了修改，使用cvs ci， cvs commit 来提交修改。
另外一种情况是自己导出别人修改的文件，而不想覆盖自己所作的修改，可以使用cvs update命令，
这个命令会自动比较CVS仓库中文件和当前自己文件的最后修改时间来导出最新的文件。

在cvs update 和cvs ci 时，你对此的文件修改与他人发生冲突，CVS则提示你。CVS会在文件中使
用“>>>>>>” 或者“<<<<<<<”标记标出冲突的地方，你可以与他人协商手动修改这一段代码。

如果你想删除仓库中的一个文件，就要先删除本地导出的文件，然后使用cvs remove 文件名, 
cvs commit来删除。事实上，CVS是不会真正删除这些文件的，如果你还想得到这些文件，只需要，
使用cvs co -r 指定删除前的版本导出就可以了。

有时候为了导出CVS仓库中的深层目录或者文件不得不输入很长的路径，这一点很讨厌，你可以导
出CVS仓库中CVSROOT目录下，修改modules文件，定义这个目录或者文件为一个模块,提交修改后就
可以直接使用cvs co 模块名 就可以导出了。

CVS的版本控制功能主要体现在tag上。标记的作用如同是同时记录了做标记时所有文件的版本，需
要的时候可以一次导出这些版本不一的文件，这常常是在项目的开发达到了一定的目标时使用的。
cvs tag 命令的参数只有一个：标记名。例如：
cvs tag RELEASE_1.0_BETA
以后，如果需要这个版本，只需要使用cvs co -r RELEASE_1.0_BETA就可以导出这个版本了。或者
使用cvs diff -r 来生成patch文件和使用cvs log -r 来查看这个版本的日志。

标记的另外一个非常重要的作用是生成分支和合并分支。
通常，我们的项目的开发到某一定的程度时，需要探索某一条开发途径是否有效，这个时候，我们
需要做一个试验，但是这个试验的分支的开发不能影响项目的主开发分支，这样，我们就可以生成
一个分支开发，主开发分支也可以继续进行，两者并不冲突，将来如果证明分支开发有效，还可以把
分支合并到主开发分支中。建立一个CVS分支:
cvs tag -b 分支标记名

建立分支后，并不影响当前我们从CVS仓库中的文件，需要从CVS仓库中重新导出分支BRANCH_VER：
cvs co -r 分支标记名 模块名 

这样，我们可以进行分支开发，主分支的开发也可以照常进行，如果此分支开发成功，我们可以把它
与主分支合并：
cvs update -j 分支标记名
cvs commit
就可以把开发分支合并到主分支中去了。

以上是本地CVS仓库的操作，如果使用网络CVS仓库，只需要使用CVS_RSH环境变量指定通信shell,另外
设置CVS仓库为网络仓库就可以了。网络上的CVS仓库的服务器有两种：ext和dserver。对于后者在进行
CVS操作时，需要先login验证用户。后者使用rlogin验证，不需要显式登陆。如：

ext CVS 服务器使用
export CVSROOT=:ext:kerberos@power:/home/repository 
或者cvs -d :ext:kerberos@power:/home/repository
cvs co platoon

derser CVS 服务器使用
export CVSROOT=:pserver:[e-mail]:/home/kde
cvs login 
cvs co kdebase

其他一些常用的cvs 命令选项
-d 指定CVS仓库的路径
-zn 使用gzip 压缩后传输,到本地后自动解压。n为压缩级别通常式 1～4，通常使用于服务器的传输速
度较慢的情况下。
-x 用于服务器的通信使用加密算法，只有在使用kerberos验证体系下有效

CVS 的GUI工具
几个常用的GUI工具:
LinCVS(图1),是Xwindow 的CVS客户端工具,比较流行的一个,功能也很强大. 


图1 LinCVS
Cervisia (图2),一个基于KDE的CVS GUI工具,使用KDE的读者使用起来很容易上手. 


图 2 cervisia 
注:文章中的环境变量的设置是在bash下,其他shell使用不同的命令