WinCVS的配置与使用方法

 

1、 WinCVS简介：

WinCVS是CVS的一个客户端软件，它运行在Windows上，用来在Windows上登录CVS服务器，然后进行一些CVS相关的操作与管理。由于当前很多的企业内部都采用Linux/Unix做服务器，而用Windows做客户端，所以，WinCVS与CVS服务器配合使用将组成最强有力的版本控制与管理的系统之一。

 

2、 WinCVS的下载与安装；

WinCVS的安装文件可以从ftp://192.111.1.1/jutone_ftp/software/地址下载到，也可以在http://sourceforge.net/project 上下载到最新的或其它版本的WinCVS。

下载到相应的版本后根据向导进行安装

 

3、 配置WinCVS：

a、    一般选项的设置(General)，选择Admin->Preferences…，出现如下界面：

第一、 Path：用来配置cvs在服务器上的主目录路径，也就是服务器上用进行cvs初始化的目录，格式一般为username@192.111.1.2:/Project。该路径从管理员处获得。

第二、 Authentication：用来配置cvs服务器的认证方式，可以从下拉框中选择其它的认证方式，不过一般只要选择”passwd” file on the cvs server方式就可以，要注意的是必须与cvs服务器配置时所指定的认证方式一致；

第三、 Use version：一般选择默认即可。

 

b、 全局选项的设置(Globals)，在上一个界面上选择“Globals”：

 

此项的配置主要是要注意这几选项：

第一，Checkout read-only不要选上，否则，checkout出来的源代码将不允许用户进行

修改，并且此选项默认是选中的；

第二，Prune (remove) empty directories也不要选上，否则，会自动删除空目录；

第三，对一般配置没有特殊要求的，把Dirty files support、Supply control when adding

与TCP/IP compression选项选中；

 

c、  WinCvs项的设置(WinCvs)，在上一个界面上选择“WinCvs”：

 

此项的配置主要是要注意这几选项：

第一，Default viewer used to open files点击右边的按钮 选取用于默认的打开文件的软件；

第二，Home folder点击右边的按钮 选取存放cvs服务器上文档的本地路径，该目录用户机上需要事先键好；

 

4、 登录服务器：

选择Admin->login，将出现如下对话框要求用户输入登录口令

 

输入口令后，选择“OK”按钮，如果CVS服务器与WinCVS的配置都没出错的话，将在CVS的状态栏中提示：

cvs -z9 -d :pserver:cvsyxwu@10.104.1.204:/home/cvsroot login

Logging in to :pserver:cvsyxwu@10.104.1.204:2401/home/cvsroot

***** CVS exited normally with code 0 *****

code 0表示正确的登录；而如果出错的话，将是code 1，那么要根据错误的提示进行相应的修改。

 

5、 更改Modules 中的视图：

在view中选择Brows LocationàChange…选择存放cvs文档的本地路径如下图所示

 

 

6、 从CVS服务器上check out相应的模块：

第一， 在workspace中的Modules选中要存放checkout模块的目录；

第二， 选择Create->Checkout Modeles，将出现如下对话框：

 

 

其中，Module name and path on the server就是要存放checkout 内容的目录，由用户输入；而Local folder to checkout to就是第一中用户所选择的目录。

 

7、 修改之后把文件提交到CVS服务器

a)、只有一个用户对文件进行修改的情况

用自己喜欢的编辑器对checkout出来的文件进行修改，修改之后的文件在没有提交之前会是红色的，如下图default.jsp文件：

 

选中红色的文件default.jsp后右击选择“Commit Selection”选项，如果没有其它用户也对其进行修改并已经提交到CVS服务器上，一切正常的话将把default.jsp文件提交到CVS服务器并把图标恢复成原来的颜色。

 

b)、两个或两个以上的用户对同一文件的不同部分进行修改的情况

这种情况就是如用户A与用户B都checkout了文件default.jsp，

然后用户A修改，并提交到CVS服务器（一般将正常提交）：

接着用户B修改：

当用户B选择“Commit Selection”时将提示：

cvs server: Up-to-date check failed for `default.jsp'

cvs [server aborted]: correct above errors first!

此时表明已经有用户对同一个文件default.jsp进行修改并提交到CVS服务器，这时

要先选择“Update Selection”对本地default.jsp与CVS服务器上的default.jsp文件进行

同步与合并，不用选中出现的任何选项，直接选择“OK”，这时将显示如下：

cvs -z9 update default.jsp (in directory C:/my cvs/STW/src/)

RCS file: /home/cvsroot/STW/src/default.jsp,v

retrieving revision 1.4

retrieving revision 1.5

Merging differences between 1.4 and 1.5 into example.h

M default.jsp

 

***** CVS exited normally with code 0 *****

表明用户B与用户A的修改已经合并成功，同时文件default.jsp的图标也将变成红色，合并后的文件是存放在用户B的本地机上，为了更新到CVS服务器还必须选中default.jsp并右击选择“Commit Selection”才能把用户A与用户B的修改合并后的结果提交到CVS服务器上。注：M表示此文件已经被修改过。

 

c)、两个或两个以上的用户对同一个文件的相同部分进行修改的情况

这种情况就是如用户A与用户B都下载了文件default.jsp，内容如下：

然后用户A把文件修改成如下，并提交到CVS服务器（一般将正常提交）：

如果用户B这时选择“Commit Selection”准备把修改结果提交到CVS服务器，此

时将显示如下的错误提示：

cvs commit -m "no message" (in directory D:/cvsfolder/cinnamon/PH2/Implementation/coding/Web Content/script/)

cvs commit: Examining .

cvs server: Up-to-date check failed for `default.jsp'

cvs [server aborted]: correct above errors first!

 

*****CVS exited normally with code 1*****

表明用户B的修改与其它用户的修改冲突，这时要先选择“Update Selection”，将显示如下提示：

cvs update default.jsp (in directory D:/cvsfolder/cinnamon/PH2/Implementation/coding/Web Content/script/)

U default.jsp

cvs server: nonmergeable file needs merge

cvs server: revision 1.3 from repository is now in default.jsp

cvs server: file from working directory is now in .#default.jsp.1.2

C default.jsp

 

*****CVS exited normally with code 0*****

default.jsp前面的C表示与其它用户的修改有冲突

系统将自动备份文件。遇到这样的问题需要AB用户协商解决。

B用户可以先选择“Update Selection”，在如下的对话框中勾上”Get the clean copy”得到A用户修改的文件后，再对该文件进行修改，然后在将文件上传。

 

这样，向CVS服务器提交文件所会遇到的问题也基本上就是这些，用户要根据所遇到的实际问题进行修改。

 

8、 向CVS服务器添加新文件

在本地添加文件后，要提交到服务端。先选中文件，然后点击“添加按钮”，添加文件后，再在右键菜单中选择提交命令“Commit Selection”即可。

如图，选中文件.#default.jsp.1.2，因为.#default.jsp.1.2当前不是CVS的文件，此时“添加按钮”将由不可选状态变成可选状态，所以Status中显示为“NonCvs file”，选择“添加按钮”之后.#default.jsp.1.2图标将变成红色并增加了一个A字母

然后选中.#default.jsp.1.2，右击，选择“Commit Selection”把文件.#default.jsp.1.2提交到CVS服务器上而成为CVS的一个文件。

9、 结束语

来到这里，你基本上已经能为自己或公司配置一个实用的CVS服务器与WinCVS客户端，配合使用CVS进行系统开发或其它文档的版本管理与控制。