vss基础操作手册.doc

西部世纪软件公司程序文件
文件编号
WI-15-02-2002-1
编 制
马海燕
Visual sourcesafe 6.0使用手册
修订日期
2002年4月18日
审 核
技术委员会
执行日期
2002年5月1日
批 准
技术委员会

目 录

1．简介 2
2．安装 2
3．应用 2
3.1 工具分类 2
3.2 创建vss数据库 3
3.3 用户管理 5
3.4 用户权限管理 6
3.5 工程、文件管理 7
3.6 共享 16
4. 结语 17

1．简介
Visual sourcesafe 6.0(以下简称vss) 是Microsoft visual studio 6.0当中的配置管理工具,利用该工具主要可以实现配置标识、版本控制、历史追踪、变更控制等功能，尤其是它与visual studio 中其他工具如vb、vc、vfp等的结合性比较好，所以成为目前主流配置管理工具之一。
2．安装
此工具安装比较简单，只要运行vss安装包里面的setup.exe，然后按照提示进行即可，这里不再赘述。
3．应用
3.1 工具分类
安装完成以后，在开始——程序——Microsoft visual sourcesafe下可以看到四个工具（图3.1），其中：analyze & fix vss db 是对vss库进行查错并修复的工具；analyze vss db是查错但不修复；Microsoft visual sourcesafe 6.0 是普通用户级操作窗口；visual sourcesafe 6.0 admin 是管理员级应用窗口。后面两个窗口也是最常用的。
3.2 创建vss数据库
首先要强调的一点，这里所提到的数据库是被vss创建的，有特定存储结构和文件格式的数据存储区。
点击visual sourcesafe 6.0 admin，会有一个名为common的vss库被打开，这个库是安装vss完成后自动生成，为用户提供第一次进入的窗口（图3.2）。
用户可以用窗口上的工具在其他路径下建立新的vss库：tools——creat database(图3.3)，可以浏览路径也可以手输绝对路径（图3.4）。
确定后，系统会在d:\ll\下生成名为test的vss库。通过users——open database 浏览路径就可以打开新创建的test库(图3.5)，用户名为admin，密码空。

图3.1

图3.2

图3.3

图3.4

图3.5
3.3 用户管理
第一次打开的库，默认用户有两个：admin和guest，admin 具有最大管理权限，一般来说创建人员第一次打开系统会提示设置管理员密码，以防权限被盗用(图3.6)。

图3.6

对用户的添加、删除、编辑、以及密码的管理都在users菜单下进行(图3.7)。
添加一个用户“wz”，再把guest用户改为lgy，结果显示如图3.8

图3.7

图3.8
3.4 用户权限管理
默认情况下，用户权限只有两种：read—write和read—only ，如果要细分权限，需要改变tools—options中project security 选项设置(图3.9)。

图3.9
改变设置以后窗口下面的project security属性由off变为on（图3.10） ，就说明可以对用户权限进行更详细的分配了。

图3.10

管理员可以对每一个工程按照需要对不同用户赋予不同权限。权限总共分为四级，每一级都默认涵盖上面的一级权限，比如在图3.11中：配置与变更管理目录只需要给配置管理员三级权限，而开发组的其他人员则只要给第一级：read就可以了。
第四级权限destroy除了不能管理用户以外，拥有对工程、文件的最大管理权，一般来说，建议admin不要给用户这一级权限，以防止误操作引起的严重后果。

图3.11

3.5 工程、文件管理
新建的vss库里面只有一个默认工程$（有些类似于跟目录），所有的工程、文件都在下面创建、添加(图3.12)。

图3.12
vss中的工程（projict）有些类似于平常操作系统中目录的概念，但是又在它的基础上加了许多管理功能。如图3.13：在$下添加工程“国投中鲁”，下面的common框是对此工程作说明的区域，比如我们加上“此项目属流程工业事业部开发”，以后当用户察看此项目属性就可以看到这段说明。

图3.13
同样，我们在“国投中鲁”下建立子工程“项目管理”(图3.14)

图3.14
在“项目管理”下就可以加入相关文件，比如“项目开发计划”等(图3.15)。总之工程结构以及要加入的文件都是由用户自己确定。

图3.15
当用户加入一个文件后，系统会出现如下提示（图3.16），这是因为vss的管理机制是用户不能直接在服务器的vss库中更改文件，所以必须在本机建立工作目录（work folder），下面的提示信息就是询问“是否将当前目录设定为工作目录”，“是”或“否”由用户自己确定。

图3.16

工作目录可以在工程建立后就设定（图3.17）。

图3.17

文件被添加成功后显示如图3.18：包括文件名、当前使用用户、创建时间（更新时间）、工作区路径等信息。

图3.18
当vss库中的某个文件需要被更改时，用户需要通过check out操作来获得此文件，放进工作目录，具体操作是：找到需要的文件，单击右键选择check out 选项（图3.19）。

图3.19
如果用户在建立工程时没有设定工作目录，系统会提示创建工作目录（图3.20），在本机确定一个工作目录，确定。这个文件就被成功check out。

图3.20
在vss库中，被check out 的文件上面会出现红色对勾（图3.21），表示此文件正在被某用户修改，这个时候，在系统默认设置下，其他用户就不能再对这个文件执行check out 操作。如果实际情况的确需要多个用户同时更改一个文件，就要通过admin来更改默认设置。

图3.21

对本机工作区中的文件更改结束后，关闭此文件，通过check in 操作再一次纳入vss库中（图3.22）。这时vss会自动将文件当前状态与未check out前的状态做比较，如果没有发现内容变更，则对本次操作不做记录；如果发现内容有变更，则将显示状态的信息比如时间等改为最新，并且文件版本上升一次。

图3.22

关于文件是否被更改、版本是否提升可以通过show history 查看（图3.23）

图3.23
在窗口中可以看到以下信息（图3.24）：此文件总共有几个版本、分别创建的时间、每一次是在上个版本的基础上做了什么操作如add、delete、check in、操作由哪个用户执行等等。
其中version的数字是系统自动增长。初始数字为1，每执行一次操作，数字自动加1，并且vss自动保存以前的版本，随时可以恢复。
面板上其它按钮功能如下：
view：浏览文件内容，但是不能更改。
Details：查看文件细节信息，比如文件说明等
Get：拿出文件的只读版本到本地目录，对get到本地的文件所进行的操作对vss库中的文件没有影响。
Diff：比较两个文件的不同之处，这里的两个文件指无论windows系统还是vss库中的任意两个文件都可以做对比。
上述的操作对最新版本和旧版本都生效，这就在很大程度上保证了开发资料的完整性和可追溯性。

图3.24
对于一个工程做check out操作，可将此工程下的文件和所有子工程检出到本机工作区（图3.25），在窗口中有一个recursive复选框，这个框在很多窗口都会遇到，默认不选中，即：本操作只对此工程下的文件生效，如果选中，则表示本操作对此工程下所有文件及子工程都生效。

图3.25
由于单个文件的version号增长不受用户控制，而且在同一个工程中所有文件的version也不是时时统一的，这样很不方便整个工程的阶段确定和检索，所以在vss中还有另外一个做版本标记的方法：lable。
对所选工程单击右键，选择lable，输入标签，必要时也可以加上一些说明（图3.26）。

图3.26

做了标签的工程也可以通过show history 来检索（图3.27），做标签的版本前面有一个黄色的小图标，后面显示标签内容，同样，对于单个文件也可以做标签。

图3.27

在检索时选定lables only，就会得到所有做过标签的版本列表，如果是为了搜索某一个或几个特定版本，那么在搜索条件中再加入要搜索的具体标签号（图3.28），但是需要注意：标签内容前面应该加上大写的“L”，否则将搜索不到。

图3.28
图3.29为对国投中鲁进行标签为“1.0”版本搜索的结果，面板上的其他按钮与上面介绍的基本相同，只是view功能有所不同，这里的view将显示当前版本的工程所包含所有文件的名称及version号。

图3.29
3.6 共享
vss还有一个很大的特点就是支持共享，这为软件的复用提供了很好的支持(图3.30)。

图3.30
Vss的共享分为两种：share和branch
所谓share是指共享的文件可能从逻辑上来看是几个，但是物理存储上还是一个区域，也就是说任何一个文件的变更都会引起其他几个共享文件的变更，这样能保证共享的几个文件时刻保持同步。
Branch则是当共享文件不需要同步时采取的措施，也就是说，被共享的文件以共享点为分界，以前的记录、版本都是相同的，在这个时刻以后彻底被分为两个不同的文件，互不影响，当然在物理存储上也是两个文件。
到底使用哪一种也由用户视需要而定，在共享时系统也会给出复选框(图3.31)。

图3.31
4. 结语
以上是vss基本操作的简单介绍，当然还有一些功能需要在使用中发现和体会，需要注意的一点是：vss对于二进制文件的支持能力远不如文本文件强，所以有一些功能比如：文件对比等不能应用于二进制文件，这大约与它的内部处理机制有关系。
Vss本身是一个小巧但很好用的工具，开发人员在使用中自然会体会到它的好处。并且它的每一个界面都有help按钮，遇到障碍时请点击查询或者看更详细的msdn帮助文件，也可以请本部门配置管理员帮助解决。
此手册由研发中心软件工程组编写，由于时间关系，初版甚是粗略，只介绍了一些最基本的功能和操作，主要面向刚接触sourcesafe的开发人员，如果是配置管理员，了解这些内容是远远不够的。
此操作手册以后逐渐会有新版本产生，会包含更多更详细的功能和使用介绍，也希望能够得到使用者的反馈意见。

第 1 版
第 1 次
共 16 页
第 16 页