1、 技术管理部资料WINCVS用 户 手 册编 写： 相 伟 版本号： 2008 年 4 月 18 日黑龙江傲立信息产业有限公司WINCVS 用户操作手册 1 目 录1. 环境要求 .22. wincvs 界面与基本设置 .23. 登录 CVS 服务器 44. 导入文件（Import）与检出文件（Checkout） .65. 同步（Update）-将服务端文件更新到本地 156. 文件提交修改 (Commit) .177. 删除文件 .188. 找回被删除的文件 .199. 添加目录到模块中 .1910. 删除模块中的目录 .2011. 标签( Tag )操作 .2112. 分支 ( Branc
2、h )版本操作 2113. 查看文件的状态 2214. 需求要特别注意的事项 2415. 创建分支的注意事项 .24WINCVS 用户操作手册 2 CVS（Concurrent Version System）版本控制系统是一种 GNU 软件包，主要用于在多人开发环境下的源码的维护。实际上 CVS 可以维护任意文档的开发和使用，例如共享文件的编辑修改，而不仅仅局限于程序设计。CVS 维护的文件类型可以是文本类型也可以是二进制类型。CVS 用 Copy-Modify-Merge（拷贝、修改、合并）变化表支持对文件的同时访问和修改。它明确地将源文件的存储和用户的工作空间独立开来，并使其并行操作。CV
3、S 基于客户端/服务器的行为使其可容纳多个用户，构成网络也很方便。这一特性使得 CVS 成为位于不同地点的人同时处理数据文件（特别是程序的源代码）时的首选。 所有重要的软件项目都可以使用 CVS 作为其程序员之间的中心点，以便能够综合各程序员的改进和更改。 CVS 的基本工作思路是这样的：在一台服务器上建立一个源代码库，库里可以存放许多不同项目的源程序。由源代码库管理员统一管理这些源程序。每个用户在使用源代码库之前，首先要把源代码库里的项目文件下载到本地，然后用户可以在本地任意修改，最后用 winCVS 的 Commit(提交修改)功能进行提交，由 CVS 源代码库统一管理修改。这样，就好象只
4、有一个人在修改文件一样，既避免了冲突，又可以做到跟踪文件变化等。下面将详细说明该系统的操作使用方法。1. 环境要求 CPU ：P3-450 以上、内存 64M、8M 以上显卡、自由硬盘空间大于 2G。 操作系统 ： Windows2000 操作系统（pack2 /pack3） 。 WNCVS ：websrvsoftwarewin CVS 1.3.11 wincvs1.3.11.1beta11.exe2. wincvs 界面与基本设置安装好 wincvs 后，启动该系统，可以看到如下图的操作界面：WINCVS 用户操作手册 3 现在需要进行基本配置。配置步骤如下：1. 点击菜单 Admin-lo
5、gin，弹出的窗口如下所示: 2. Authenticatio ：pserver （认证方式，这里选择的是 PC 机连接服务器） ；3. Path ：输入 CVS 服务器上配置的路径，即 “数据库根” ；4. Host address ：输入 CVS 服务器端的 IP 地址或主机名；5. User name ：输入自己在 CVS 服务器上的用户名；6. 选择此窗口的 Globals 标签；7. 注意“checkout read-only“选项，表示“ 检出时文件只读 ”（建议选中此项） 。8. 注意 “prune（remove ）empty directories“选项，表示 “自动删掉空目录
6、”。9. 点击【确定】按钮，配置完成。10.公司服务器数据库根、CVS 服务器 IP 及主机名由配置管理员通知。WINCVS 用户操作手册 4 3. 登录 CVS 服务器配置完后，开始登陆 CVS 服务器端，登陆过程如下：1. 点击菜单 Admin-login，弹出的窗口如下所示:2. 点击【确定】按钮，出现选择本地工作目录窗口（建议选择一个空目录） ；例如选择：“D:CVS”3. 选择目录之后，点击【确定】按钮，会弹出如下所示窗口：4. 输入用户口令之后，点击【OK】按钮，出现界面如下：WINCVS 用户操作手册 5 5. 查看上图所示红色圈选部分，如果提示为“cvs exited norm
7、ally with code 0”则登陆成功。接下来就是系统的具体使用了，它的工作流程如下图：图中名词定义：WINCVS 用户操作手册 6 导入(Import):将本地原始工作目录中的文件或文件夹导入到 CVS 的仓库中。检出(Checkout):将自己或其他人员上传到 CVS 仓库中的文件或文件夹下载到本地的一个工作目录中（服务器端已有相应模块）。提交(Commit):将本地作完修改后的文件提交到 CVS 的仓库中。同步(Update):将 CVS 仓库中最新的修改后文件下载到本地工作目录中。4. 导入文件（Import）与检出文件（Checkout）将本地文件导入到服务器端相应的“数据库根
8、”中的模块中。若服务器端没有建立相应的模块，则需自己导入模块； 若服务器端己建立好模块，则直接导入文件即可。 服务器端未建模块时，操作步骤如下：1. 如图：选择放置模块（项目）的目录，即本地工作目录，如下图选择：“D:CVS”为本地工作目录:2. 设置好本地工作目录后，首先在资源管理器中将要导入到服务器端的模块及模块下的文件拷贝到本地工作目录中，回到 CVS 界面，如下图所示:WINCVS 用户操作手册 7 3. 选中模块名，例如下图中的“源代码” ，然后选择菜单“Create-Import module.”选项，出现如下界面：Wincvs 会自动检测所添加的目录中的文件类型，分成两类：bin
9、ary 和 TEXT 类，并请求确认4. 点击【Continue】按钮，出现如下界面：WINCVS 用户操作手册 8 5. 在“Enter the log message”中输入“注释”信息，点击 【确定】按钮6. 看到如下图所示提示，显示“CVS exited normally with code 0”，即操作成功，将本地文件导入到服务端后，本地并没有跟服务端建立联系。如要建立联系，必须再将模块从服务端检出（checkout ）才行（与服务器端建好模块的操作相同） 服务器端己建好模块时（公司服务器，配置管理员己建好相应模块） ，操作步骤如下：1. 按如下图所示红色圈选的按钮，选择放置模块（项
10、目）的目录，即本地工作目录。下图例中选择了：“D:CVS”作为本地的工作目录：WINCVS 用户操作手册 9 2. 点击菜单 Createcheckout module，输入模块名即可，例如：输入模块名为 “源代码”：3. 此时要注意，如果服务器端的模块是空的，即模块里没有文件（如初始配置管理员建立模块时，模块是空的） ，则必须在 Globals 标签上将“prune（ remove）empty directories“选项去掉，如下图所示：按此按钮选择本地工作目录WINCVS 用户操作手册 10 4. 点击【确定】按钮，即将服务器端的模块下载到本地了。可以左边“Modules”中看到当前目录
11、中，下载的模块名为“源代码”的目录，源代码的文件夹显示前有黑色箭头显示，表明其是 CVS 模块。5. 在资源管理器中将文件拷入本地工作目录中，然后回到 WINCVS 操作界面，点右上角的刷新按钮，可看到如下图所示界面：WINCVS 用户操作手册 11 6. 先选中文件，然后点击“添加按钮“ 。出现如下图所示界面：注意此处有三个按钮，第一个添加一般的文件；第二个添加二进制文件，如图片文件；第三个添加采用双字节对字符进行编码的文件。 （除.txt 文档可以第一个按钮外，其它均用第二个按纽，建议全部用第二个按钮添加）7. 点击【Ignore】按钮，出现如下界面：WINCVS 用户操作手册 12 8.
12、 Commit（提交修改） 添加后的文件显示为红色，其属性“Rev”中显示“0” ，即文件己添加到本地工作目录中，然后保持选中状态，右键选择“Commit selection.”选项，如下图所示：9. 则会出现如下所示界面：WINCVS 用户操作手册 13 10. 在“Enter the log message”中输入注释信息(这里一般输入的是软件在公司的版本号) ，点击【确定】按钮，则界面如下所示：11. 此时文件己提交到服务器端，默认版本号为“1.1” ，即初始版本（注：初次提交文件时，一定要有初始版本，即每个文件都应有 1.1 版本。 ）12. 同步（Update） 同步的操作：使用鼠标
13、选择一个目录或者一个文件，也可选择多个，使用下面三种等效操作即可：1)菜单: Modify-Update2)快捷键：Ctrl+U3)点击 Update 工具按钮， 如下图所示WINCVS 用户操作手册 14 点击该选项后，出现下面界面使用后三项，更新服务器上最新版本的文件，若要按 rev 版本（tag 标签、branch 分支）更新则使用WINCVS 用户操作手册 15 输入相应版本号（标签、分支） ，则更新到本地的文件与输入的版本相同，而不是服务器上的最新版本。好习惯“先同步 后工作” 。每次使用 WinCvs 开始工作前，应该先 Update 一次，这样我们就能在文件的最新版本上工作。Up
14、date 与 Checkout 之间的区别Checkout 是把 CVS 服务器上的 module 下载到本地进行工作。Update 主要同步本地文件（目录）和 CVS 服务器库中相应文件（目录）之间的差异，使本地相应文件是最新版本，另外 Update 也能执行获取文件旧版本的操作。5. 同步（Update）-将服务端文件更新到本地在对本地的文件修改前，最好先从服务端更新文件，因为多人操作同一个文件时，没有及时更新容易引起冲突。如甲乙检出的版本同为 1.2，甲修改提交后的版本为 1.3，乙此时没有更新，在本地 1.2 的基础上修改提交， CVS 服务器此时不允许提交动作。同步（Update）的
15、操作方法如下：点击选中文件（可多选） ，从右键菜单中选择“update selection”。出现提示窗口（如下图）后直接点击【确定】按钮命令，即可将服务端的最新文件更新到本地。此方法只适用更新此时所在的分支上的版本。WINCVS 用户操作手册 16 模块级同步同步本地模块时，可选中本地模块，从右键菜单中选择“update selection”。出现提示窗口（如上图） ，选中后三项，点击【确定】按钮，则更新主干版本；若要更新分支版本，可继续在“update ptions”标签页中选中“Retrieve rev/tag/bran”选项，输入分支名称，点击【确定】按钮即可。Update setti
16、ngs 标签中选项的含义： Reset any sticky date/tag/-k options ：不按本地模块所在的分支进行下载。如果不与“Update options”标签中的“Retrieve rev./tag/bran”输入框进行配合，下载的文件会按本地模块所在的分支进行下载。 Create mission directories that exist in the rev ：当下 Check out 到本地后，其它开发人员对此模块又作了提交或删除文件的动作，选择此选项可下载这些错过的文件。Update options 标签中选项的含义： Before date ：按时间更新文件；
17、 Retrieve rev./tag/bran ：按版本、tag、分支号更新文件；WINCVS 用户操作手册 17 6. 文件提交修改 (Commit)从服务端 checkout 项目后，会在本地建立文件的拷贝，在客户端修改后提交（Commit）到服务端即可将最新的文件保存到服务端，如下图，修改后的文件显示为红色。此时的修改只修改了本地的文件，如果要提交到服务器端，点击选中被修改过的文件，从右键菜单中选择“commit selection”命令即可提交到服务器。提交之后，文件版本会自动加1。也可在提交时强制提交后的版本号，原则是在本分支中，版本号要比提交前的版本要大。可选择要提交的模块名称，如
18、上图中选中“源代码”模块，从右键菜单中选择“commit selection”命令，提交时的选项如下图：WINCVS 用户操作手册 18 此时可强制提升到 1.5 版本。在文档没有经过改动的情况下，也可使用此方法。注意：当提交单个未经改变的文档时，有时需选中“Force commit”选项。7. 删除文件1. 选中文件后，点击删除按钮，或菜单命令：“Modify Remove”,将文件从本地删除。2. 删除后，从右键菜单中选择“commite selection“命令，才能将服务端的文件删除。WINCVS 用户操作手册 19 8. 找回被删除的文件1. 如果只是点击删除按钮删除文件，则点击添加
19、按钮即可将文件找回。2. 如果已执行了提交操作，将文件从服务端删除，则应在本地建立一个同名的文件（若为文本文档，可为空） ，将文件添加并提交到服务器端。此时，可以找到丢失的文件，只不过会在原来被删除版本的基础上将本地的创建的文件升级一个版本。文件的历史版本仍然存在。3. 纯文本文档可实现历史版本覆盖当前版本，办法是合并（merge） 。4. 二进制格式文档实现历史版本覆盖当前版本，只能人为的增加内容之后，提交新版本。9. 添加目录到模块中1. 当加入一个不包含文件的空文件夹时首先下载要将文件夹添加入的模块，见操作“4、检出（checkout）文件” ，再把要添加的目录加入本地 CVS 工作目录
20、的此模块文件夹中（此操作在资源管理器中完成） 。例如添加了一个文件夹 NewFlod。选中此新加的文件夹，点击右上角的红色“添加”按钮，如下图所示：最后进行 Commit（提交修改） 操作即可。注意，此操作时在 Perferences 菜单中的 Globals 中 “prune（remove）empty directories”选项为未选中状态，否则提交动作失败。2. 当加入一个包含文件的非空文件夹时此项操作可以按上节的方法作，按上节的方法做时，首先应该加入目录，然后添加文件；也可参见“导入文件”一节中的“服务器端未建模块时”的操作，只是在添写的模块名称变为要提交的“模块名称”加上要添加的“目
21、录名称” 。如下图： WINCVS 用户操作手册 20 例如：我们准备在“源程序”模块中加入一个名为“NewF”的文件夹，则可以按照导入模块的方法加入。多作的工作只是执行“Import module”命令后出的的提示窗口（如下图）中的模块名称中要写成：要将文件夹加入的“模块名称/要添加的文件夹名” ，即可。10. 删除模块中的目录先下载包含此目录的文件的模块。首先，在本地 CVS 工作目录中删除要删除的文件夹中的内容，使之变成空目录，然后在 WinCvs 中选中要删除的文件夹，在右键中选择 ”WINCVS 用户操作手册 21 Commit Selection”并在弹出的窗口中选择“prune（
22、remove）empty directories”选项，确认即可。11. 标签( Tag )操作在 modify 菜单下有 “create a tag onselection“条目，可给文件创建 tag。在 create 菜单下有“create a tag by module“，可对模块创建标签。创建分支跟 tag 一样，也在 modify和 create 菜单下，只不过条目不同而已。具体步骤如下：首先选中要为其创建标签的文件或模块名，在 modify 菜单下有“create a tag onselection“条目，出现如下界面：在“New tag name”中输入标签名称( 建立规则为 C
23、S_0.0.0001 即 CS_ + 公司版本号)，点击 【确定】按钮，即创建标签成功；删除标签时，首先选中己创建过标签的文件或模块，然后选择 modify 菜单下有 “delete a tag “。12. 分支 ( Branch )版本操作Branch：分支是个很有用的概念，当我们在原来的版本基础上需要创建另外一个版本（项目）时，可创建一个分支，分支跟主版本可独立开发，又可以相互合并。如我们的双厂项目跟富厂基本上相同，可直接在双厂的基础上创建一个分支 v_ds。双厂上有用的地方直接合并到富厂分支上。创建分支方法如下：首先选中要创建分支的文件或模块，选择菜单“modify” 中的“Create
24、 a branch”选项，出现如下界面：WINCVS 用户操作手册 22 可在“New branch”中输入分支标识（建立规则为 branch_jx 即 branch_ + 分支名） ，点击【确定】按钮。此时仅创建了分支版本，但并未在分支版本上工作，若要在分支版本上工作，则须将分支版本“checkout”到本地工作目录中。在 cvs 中，checkout 或 update 某个 tag 或 branch 或 revision 是通过同一个界面选项，如下图，红色部分输入所要下载模块的 tag 号、branch 标签或 revision，点击【确定】按钮即可。13. 查看文件的状态1. 右键菜单中
25、选择“status selection“可查看文件的当前状态，如下例其中，Sticky Tag 项可表示此文件所在的分支名称，或不在分支上。下例就是不在分支而在主干上，因为 Sticky Tag 项为“none” 。 =WINCVS 用户操作手册 23 File: test.txt Status: Up-to-dateWorking revision: 1.4Repository revision: 1.4 /usr1/tt/test1/test.txt,vSticky Tag: (none)Sticky Date: (none)Sticky Options: (none)Existing T
26、ags:v_zs (revision: 1.3)v_ds (branch: 1.1.4)v_xj (branch: 1.1.2)test (revision: 1.1)V2 (branch: 1.0.4)v1_2 (branch: 1.0.2)2. 右键菜单中选择“log selection“可查看文件的历史信息，包括修改者，修改时间等，如下例=Revision : 1.4Date : 2002/1/16 2:14:25Author : lixinState : ExpLines : +1 1Description :no message-Revision : 1.3Date : 2002/1
27、/16 2:1:59Author : lixinState : ExpLines : +4 0Description :no message3. 通过菜单命令：“Query Graph”或快捷键“Crtl + G”，我们可以利用图的形式查看文件的状态及分支情况：WINCVS 用户操作手册 24 14. 需求要特别注意的事项1. 二进制文件在添加时，一定要用添加二进制文件的按钮，否则，下载的二进行文件会出现错误，不能进行正常的打开动作或根本打不开。2. 在添加二进制文件时，一定要有初始版本，即第一次添加二进制文件时不能强制升版本，缺省形成 1.1 版本，导入模块时文件缺省版本为 1.1.1.1。
28、15. 创建分支的注意事项1. 创建分支时，版本号多加两位，且多加的第一位一定是偶数且按数字大小顺序排列即2，4，6，8，10。2. 创建了分支标签后，当以分支标签 Check out 或 Update 时，文件的版本号并没有变。这是因为您并没有给此分支提交初始版本（第一次提交的初始版本一定是主干版本号+2.1，此版本不能强制提交版本号，公司要求分支必须在主干的初始版本上建立，所以版本号一定是 1.1.2.1） 。当您在此分支上作了一次提交动作后，就会发现版本号变成了分支的预期的版本号。3. 如果分二次创建了分支版本（即加入了分支标签）后，第一次创建的分支版本号是*.*.2.*，第二次创建的分支版本号是*.*.4.* ，则可以不必为分支版本提交初始版本，当需要对分支进行开发时再提交初始版本（分支的初始版本同样不能强制升版本号一定要有*.*.*.1 版本，就是说即使没有进行初始版本的提交，在提交修改时会自动生成相WINCVS 用户操作手册 25 应版本，按公司要求建立则分支的版本号一定是 1.1.2.1 和 1.1.4.1）即可，以此类推。4. 在分支上删除文件，并不影响主干或其它分支上的此文件。
