《cvs客户端使用手册》由会员分享，可在线阅读，更多相关《cvs客户端使用手册（33页珍藏版）》请在金锄头文库上搜索。
1、CVS 客户端使用手册客户端使用手册中国软件与技术服务股份有限公司中国软件与技术服务股份有限公司文档编号：当前版本号：V1.0最初发布日期： 2008-4-23最新修订日期：文档信息文档信息 文档位置文档位置文档存放在文档服务器：文档修改历史文档修改历史版本号版本号版本日期版本日期修改总结修改总结修订人修订人V1.02008-4-23建立文档张莹分发分发本文档已被分发到如下人员：姓名姓名职务职务相关文档相关文档及参考资料及参考资料序序号号相关文档相关文档文档位置文档位置版本版本日期日期1.2.3.4.5.6.7.目目 录录1 文档说明.12安装.23基本操作.33.1设置.33.2登录.53.
2、3设置工作目录.73.4修改密码.83.5检出.93.6更新.133.7添加文件.143.8添加文件夹.183.9修改之后的文件.253.10删除.263.11文件过滤使用.263.12需要注意的问题.291 文档说明文档说明本文档预期读者为开发人员。CVS 客户端工具有多种，本文档以 WinCVS1.3中文版为例，内容为 CVS 安装和基本操作。涉及密码、路径、IP 等根据情况修改，或联系 CVS 管理员。2 安装安装拷贝 CVS 安装程序到本地，运行，安装程序正在启动：之后下一步，直到：选择安装路径，下一步，直到安装结束。3 基本操作基本操作3.1 设置设置首次使用，要先进行各种设置，打开
3、客户端程序，会自动弹出设置页面，可以在这里设置；也可以取消之后，手动打开设置页面；还可以在登录时设置，下面是打开客户端程序时，自动弹出的设置页面：或打开菜单管理下的设置项进行设置：登录时的设置方法将在下一节中讲到；设置好的普通页：填写说明：1认证方式选择 pserver；2路径、主机地址、用户名由 CVS 管理员提供；3CVSROOT，自动生成，不用填写此项。之后点开全局设置页，设置好的页面：建议按上图进行设置，为最佳设置。其它页面不用设置，设置好之后点 OK 即可，CVS 工作界面：左侧为文件夹，右侧为文件夹下的文件及子目录，下面为输出窗口，显示操作结果、记录 log 等。3.2 登录登录C
4、VS 只需登录一次，检出之后在本地 CVS 文件夹中会记录登录信息，即使关闭程序再打开，也不用重新登录，并且，可以直接进行更新等操作。点击管理下的登录：登录界面：如果之前没有对普通和全局页面进行设置，可以在这个界面按上一节讲的方法设置，设置好之后，点击 OK，弹出设置工作目录界面：例如：设置为 D:test，工作目录设置之后，可以修改，下一节将会讲到工作目录的设置和修改方法。设置之后，点击 OK：输入密码，默认为空密码。操作提示：注意：CVS 操作特别要注意操作结果，如果是 code 0 则操作成功；如果是code 1 则操作失败，在遇到操作失败的提示之后，必须解决错误，之后才能进行下一步操作
5、。3.3 设置工作目录设置工作目录在上一节中讲到在登录时设置工作目录，登录之后，工作目录还可以修改。点击工具条上按钮：出现设置界面：选择文件夹，之后 OK 即可。3.4 修改密码修改密码在 CVS 界面按 ctrl+L,打开命令窗口：在 CVS 命令行窗口 cvs 后输入：passwd：点 OK：输入两次新密码，确定即可。3.5 检出检出检出功能只有在第一次连接到 CVS 仓库时使用，检出的含义是从服务器下载代码到本地。在左侧的窗口，选中文件夹，点右键，选择检出项目|模块：检出界面：有两处需要注意，上面的服务器上的模块名和路径、下面的检出到本地文件夹。如果知道模块名，可以直接输入，如果不知道，
6、需要在服务器上查看要下载的模块名是什么，注意，这里的方法只适用于建在 windows 系统的 CVS 仓库，linux 系统不支持此功能。点图中标注的按钮 List：默认 List 没有选择，勾上 List，之后确定，回到检出界面再次点“”图标的按钮，列出了服务器上的模块名：还可以点开文件夹，查看下一级目录。选择要下载的文件夹，之后点确定：模块名自动生成，当然也可以直接输入，但是如果输入的模块名不正确，则会出现 code 1 的错误提示。设置之后，点 OK，检出成功界面：3.6 更新更新当服务器上的模块下载到本地后，就可以用更新操作将本地与服务器进行文件同步。选中要更新的文件或文件夹，右键更新
7、选项：弹出新的窗口，一般情况下选择最后的两个选项：选中之后，点 OK。本地没有修改，做更新操作，如果服务器上有新版本，即把新版本下载到本地，没有新版本则不会下载；如果本地有修改，做更新，不管服务器上的版本是不是新的，都会把本地的文件重命名之后下载服务器上的版本。3.7 添加文件添加文件CVS 中，没有添加到服务器的文件前面有“?” ，以区别服务器上的文件。添加文件需要按文件的类型添加，不同类型的文件有不同的添加方式。添加方式主要有两类：普通方式和二进制方式。以普通方式添加的文件类型有：txt、java、jsp、html、xml 等大部分类型的文件都以普通方式添加；以二进制方式添加的文件类型有：
8、word、excel、vts、rar 类似的文件，基本涉及这四种类型的文件需要以二进制方式添加。需要注意的是 java 类型的文件，必须以普通方式提交，如果添加方式正确但报错，要忽略掉。文件放到工作目录后，在 CVS 界面上找到要添加到服务器上的文件，可以多选同时添加，但要注意以不同方式添加的文件不能同时选中。例如，添加 test 文件：类型为 java 和 txt 的文件添加方式相同，可以一起添加，同时选中，点第一个红色的按钮添加：之后文件被标识为红色，需要提交，才能添加到服务器上：提交，可以点右键，选择提交选项：或者工具条的按钮：提交界面：输入日志信息，之后点 OK，提交之后的文件，版本为
9、 1.1：上面的例子是添加普通文件，下面是添加二进制文件的例子，例如名为 test的 word 和 excel 文件，选中，点第二个红色的添加按钮，加入二进制文件：文件仍然被标识为红色，需要提交，才能添加到服务器上，提交的方法与上面的相同：刚添加的四个文件：3.8 添加文件夹添加文件夹CVS 中，服务器已有的文件夹上有“”的标记，以区别没有添加到服务器的文件夹。文件夹的添加有两种方法：一种是类似添加文件的方法，直接添加文件夹再添加文件，另一种是用导入的功能，需要注意的是空文件夹不能用导入功能，并且 CVS 中文件夹不能删除，因此添加时要慎重。例如直接添加文件夹 test：选中要添加的文件夹，用
10、工具条的按钮：点添加按钮之后，文件夹即被添加：之后添加文件夹下的文件，按上一节讲的方法添加文件即可。另一种方法是用导入功能，先将一级文件夹添加到服务器，再将子文件夹及文件导入到服务器中，之后删除本地文件夹，重新从服务器上下载，仍以添加test 文件夹为例，选中文件夹，点添加按钮：文件夹被添加之后：选中文件夹，点右键，选择导入项目|模块：之后弹出窗口，为文件分析结果，以文件类型分类：检查文件类型对应的 Entry 类型是否正确，如不正确，选中，点编辑按钮，强制改变文件提交方式，注意：除非确信自己的修改是正确的，否则不要轻易用此功能：确定之后回到导入窗口，点继续，出现下面的界面：注意这个界面：设置
11、远程服务器上的模块名和路径，这一项，应该输入的是刚添加的文件夹的完整路径，如果知道确切路径，可以自己输入，否则，可以逐级选择，自动产生路径，点图中红色的按钮，出现服务器模块列表，注意，如果没有列表，按照检出一节中介绍的方法，列出模块名：之后选择刚刚添加的文件夹 test：之后确定：图中标识的模块是自动产生的，不需要再输入了，确认之后，点 OK，文件夹被导入之后，本地文件的状态不会改变，只能删除本地的文件夹及文件，再从服务器下载，如导入之后：删除文件夹内的文件，注意删除的时候不要删除 CVS 文件夹：之后重新更新文件夹：更新之后：3.9 修改之后的文件修改之后的文件在 CVS 中被修改过但没有提
12、交到服务器上的文件，用红色标识，如：这类的文件，如果确认修改，需要提交到服务器，点右键选提交选项，或点工具条的提交按钮：出现提交设置窗口：输入日志，之后 OK，新版本 1.2：3.10 删除删除CVS 中只能删除文件，不能删除文件夹。这里讲的删除是指从服务器删除文件，如果不需要从服务器删除，不用按照下面的操作，只要从本地资源管理器中删除文件即可。选中要删除的文件，点工具条的删除选项按钮：点删除选项之后，文件从本地删除，并标识为红色，需要提交才能从服务器上删除：选中刚才删除的文件，点提交按钮，或右键提交选项：输入日志，OK 即可。注意：点删除按钮并不是从服务器上删除，需要提交操作才是真正提交到服
13、务器。3.11 文件过滤使用文件过滤使用文件过滤功能是 CVS 一个特色，操作简单，使用方便，可以节省提交时间，提高工作效率，下面简单介绍使用方法：查看可以提交的文件：展开模式按钮的作用是把文件夹内的所有文件显示出来，而不显示文件夹：配合提交按钮一起使用，就可以把文件夹下的所有可以提交的文件全部显示出来：显示所有需要添加的文件：既显示新增又显示可以提交的文件：按 ctrl 多选文件，一起添加：添加之后，按 ctr+A，所有文件一起提交：3.12 需要注意的问题需要注意的问题1 建议每次修改代码之前先更新，再修改，以免版本与服务器不一致，导致提交失败的情况；2 提交文件时遇到错误，要先更新文件，看是否因为版本比服务器低造成的；3 CVS 中，文件、文件夹不能重新命名。如果发现文件提交错，删除之后重新提交；文件夹提交错，联系 CVS 管理员；4 不管是添加、修改、删除，都需要提交，才能保存到服务器上；5 每个 CVS 目录中，都有 CVS 文件夹，复制、删除的时候注意不要移动CVS 文件夹，否则会引起提交错误等问题；6 注意操作结果提示：code 0 为操作成功，code 1 为操作失败。在遇到操作失败的提示之后，必须解决错误，之后才能进行下一步操作。
