VSS帮助说明文档实用教案

1、 1. VSS概要 . 3 2. 项目(xingm)组织形式 . 4 3. 普通用户常规操作 . 6 4. 版本管理 . 20 5. 客户端安装 . 32 6. 管理员操作 . 38 目 录第1页/共45页第一页，共46页。1. VSS概要(giyo) Visual SourceSafeVisual SourceSafe（以下简称VSSVSS）是一种(y zhn)(y zhn)版本控制管理工具 它通过将各种类型的文件存入其内部数据库的方式有效地管理工程 简单易用、方便高效、与WindowsWindows操作系统及微软开发工具高度集成第2页/共45页第二页，共46页。2. 项目组织(zzh)形式

2、ITPublicBOSMISCIMDocumentProjectProject1Project2CodeDocumentAP ServerClientDB-SOL所属科担当具有(jyu)所有权限，其他人只读项目担当具有(jyu)该项目所有权限项目成员具有(jyu)相关模块所有权限其他人只读各科担当(包括科助以上)具有所有权限，其他人只读第3页/共45页第三页，共46页。附：管控(un kn)文件的范围各科室(ksh)（CIM、BOS、MIS）Project： 项目(xingm)开发源代码（包括AP-Server、Client、DB-SQL等） 开发计划 项目(xingm)开发文档 设计文档 测

3、试文档 Release文档 会议记录 操作文档等Document：SOP文档 点检表（日常点检、ISO用点检表等） 设计仕样书-MES 系统文档 故障报告书 系统故障代码表 各类表格样式 Public部门级文档各类表格样式其它部门内共享的资料第4页/共45页第四页，共46页。3. 普通用户常规(chnggu)操作第5页/共45页第五页，共46页。创建(chungjin)新的Project（文件夹） 在选定的上级(shngj)文件夹下点击鼠标右键“Create Project”，如同新建文件夹。 填入Project name后点击OK。（可在Comment中添加备注(bizh)信息）第6页/共4

4、5页第六页，共46页。 在VSS Explorer中选中需要添加(tin ji)文件的文件夹后，在File菜单中选中Add Files 在文件列表(li bio)中选中需要添加的文件夹或文件。 注意：选了Recursive，就表示包含(bohn)所选文件夹下的所有子文件夹。注：此处如果选择的是文件夹，则添加文件夹及其下面的文件；如果选择的是文件，则只添加文件。添加文件方法1（Add Files）第7页/共45页第七页，共46页。添加文件(wnjin)方法1（Add Files）文件(wnjin)夹及文件(wnjin)被添加进了VSS数据库中。第8页/共45页第八页，共46页。添加文件(wnji

5、n)方法2（Add Files）鼠标拖放实现(shxin)直接(zhji)用鼠标从Windows资源管理器拖动文件夹或文件至VSS浏览器即可。第9页/共45页第九页，共46页。设置工作目录(ml)概念 VSS是存储和管理文件的工具，但是编辑和编译文件必须在VSS指定文件夹中进行，这个文件夹叫工作目录（位于本地机器上） ，它可以是现存的文件夹，也可以是VSS新建的文件夹。VSS浏览器在文件列表(li bio)右上方显示了文件的工作目录的路径。 在VSS系统中，工作目录是真正用于处理文档的地方。当要编辑或修改某个文档时，必须对文档实施check out 操作，VSS将该文档从项目中拷贝出来，放入工

6、作目录。当修改完毕并check in 文件之后，VSS又将文件重新拷贝到数据库中以记录这次的修改。 一旦将文件签出，VSS就开始在本地机上创建并管理工作目录。（一般VSS中Project的文件夹与本地机上的文件夹保持一致比较好。） VSS中的文件夹对应(duyng)本地机上的工作目录 建立VSS目录和本地目录的映射关系第10页/共45页第十页，共46页。设置(shzh)工作目录方法 在VSS浏览器中选定(xun dn)文件夹后点击鼠标右键选Set Working Floder 选定(xun dn)在本地机上的工作目录,按“OK”完成工作目录设定前工作目录设定后注：设置工作目录除了此方法外，在进

7、行Check Out操作时如果文件还没有设置工作目录，系统会提示用户为文件创建或指定工作目录，用户可以根据系统的提示对文件进行工作目录的设置。 第11页/共45页第十一页，共46页。Check Out 文件的“签出”(Check Out)：当需要编辑一个(y )文件时，必须将该文件“签出”，VSS会标志该文件已经被某个用户迁出，并确保其他用户不可编辑同一个(y )文件。 在VSS浏览器中选定需要签出的文件(wnjin)夹或文件(wnjin)后点击鼠标右键选Check Out 包含(bohn)子文件夹及其文件第12页/共45页第十二页，共46页。Check Out文件名前面被打上了红色“”,表示

8、(biosh)文件已被Check OutCheck Out的User第13页/共45页第十三页，共46页。Undo Check Out 取消签出(Undo Check Out)：不在VSS数据库中保存签出后所做的修改，使本地文件恢复到修改之前的状态(zhungti)，并且将文件签入。只有文件或项目中有文件被签出后才有这个选项。 在VSS浏览器中选定需取消(qxio)签出的文件夹或文件后点击鼠标右键选Undo Check Out第14页/共45页第十四页，共46页。Check In 文件的“签入”(Check In)：当完成(wn chng)文件的编辑后，需将文件签入，以让其他用户可以签出或者获

9、取最新版本。对于文件，仅当文件被签出后才有这个选项。 在VSS浏览器中选定需要签入的文件(wnjin)夹或文件(wnjin)后点击鼠标右键选Check In 包含(bohn)子文件夹及其文件第15页/共45页第十五页，共46页。Check In文件名前面(qin mian)的红色“”消失,表示文件已被Check In注意!：如果文件被Check Out后，在本地机的工作目录上将文件名修改了，VSS将跟踪不到该文件，需要手工(shugng)把该改名后的文件添加进VSS中，并且原先被 Check Out的文件VSS会认为找不到，需要手工(shugng)将对文件作操作（Undo Check Out或

10、Delete）。第16页/共45页第十六页，共46页。获取文件最近(zujn)版本 获取(huq)最新版本 (Get Latest Version) ：从VSS数据库中获取(huq)指定文件或项目的最新版本，而又不必签出文件。 在VSS浏览器中选定需要获取最新版本(bnbn)的文件夹或文件后点击鼠标右键选Get Latest Version 包含子文件夹及其文件第17页/共45页第十七页，共46页。文件共享直接(zhji)拖放文件实现共享 “文件共享” ：一个文件可以被多个项目共享，在任何一个项目中对该文件的更改，都将反映到其他相关项目里。在VSS数据库中只保存文件的一个版本，其它的只是(zh

11、sh)创建一个Link 。选定(xun dn)文件用鼠标拖动到需共享的项目中即可。第18页/共45页第十八页，共46页。4. 版本(bnbn)管理第19页/共45页第十九页，共46页。版本管理(gunl)（1）VSS内部版本号VSS内部版本号：这是由VSS维护的内部数码，用户对它没有控制权。每个文件和项目的每个版本（每次修改后作了Check In的）都有一个版本号，这些(zhxi)版本号总是一个整数且是递增的（从1开始递增）。查询文件(wnjin)的历史版本 在VSS浏览器中选定文件夹或文件后点击鼠标右键选Show History 包含标签Label VSS主要有3种方法跟踪文件或项目的版本：

12、1）内部版本号 2）日期 3）Label（标签） （这里我们主要利用Label标签进行版本的管理）第20页/共45页第二十页，共46页。 内部(nib)版本号第21页/共45页第二十一页，共46页。View：查看文件(wnjin)内容。Details：详细版本信息。Get：获取选定版本的文档指定存放文件的本地(bnd)路径版本(bnbn)管理（2）对历史版本(bnbn)的操作第22页/共45页第二十二页，共46页。Diff：版本比较可以比较两个不同(b tn)版本之间的差异。第23页/共45页第二十三页，共46页。Pin：锁定文件，使其不能被修改。 （可以利用Unpin取消(qxio)锁定）R

13、ollback：该操作将使文件的内容恢复到先前某个版本时的状态，它将使所有在该版本后所做的改动丢失。 有图形(txng)标记第24页/共45页第二十四页，共46页。设定(sh dn)Label（版本号）的方法：版本管理（3）*利用(lyng)Label标签进行版本管理 在VSS浏览器中选定Project或文件(wnjin)后点击鼠标右键选Label 填入Project或文件的版本号（可在Comment中进行该版本的备注说明）标签（Label）：是用户赋给某个项目或文件的某个版本的一个字符串，可以是任何格式的长度不超过31字符的字符串。 第25页/共45页第二十五页，共46页。确认(qurn)所

14、定义的Label（版本号）： 在VSS浏览器中选定(xun dn)Project或文件后点击鼠标右键选Show History 显示(xinsh)所有的版本号记录注：利用Label作的版本号前面有个图形标记。第26页/共45页第二十六页，共46页。显示(xinsh)历史版本的两种方法：只显示(xinsh)Label版本显示(xinsh)Label版本内部版本第27页/共45页第二十七页，共46页。版本管理版本设定(sh dn)的格式 项目(xingm)名 Version号大版本(bnbn) .中版本(bnbn).小版本(bnbn)如： visDa 1.0.1 visDa 2.0.0版本设定格式

15、：第28页/共45页第二十八页，共46页。版本管理(gunl)父子项目之间的版本依存关系利用Label功能进行(jnxng)版本管理：CodeAP-ServerDB-SQLClient日期：8/1Ver 1.0.0 Ver 2.0.1 Ver 1.0.1 8/2Ver 1.1.0 8/3Ver 1.0.1 Ver 1.0.2 8/4Ver 1.0.2 8/5Ver 1.1.1AP-Server Ver 1.0.0Client Ver 2.0.1DB-SQL Ver 1.0.1AP-Server Ver 1.0.2Client Ver 2.0.1DB-SQL Ver 1.0.2食堂系统取出Cod

16、e的历史版本(Ver 1.1.0)取出Code的历史版本(Ver 1.1.1)注：可以利用Label功能为Project设置每个开发阶段的版本号，便于对不同(b tn)阶段 的源代码的版本管理。第29页/共45页第二十九页，共46页。版本管理(gunl)取出历史版本（Get）注意(zh y)!：Get操作是取出文件的历史版本，与Check Out操作不同，所以取出后是不能再Check In的，而且最好存放在不同的本地目录下，以避免覆盖本地工作目录上的版本。 在VSS浏览器中选定(xun dn)Project后点击鼠标右键选Show History 选定所要取出的历史版本，点击Get并指定存放P

17、ath后即可。第30页/共45页第三十页，共46页。5. 客户端安装(nzhung)第31页/共45页第三十一页，共46页。在VSS Administrator 中Add User 在VSS管理员界面菜单(ci dn)中选Add User 填入User name和Password在VSS Server 上进行(jnxng)操作 VSS客户端安装(nzhung)（1）服务器端设置第32页/共45页第三十二页，共46页。VSS客户端安装(nzhung)（2）安装(nzhung)Client连接(linji)VSS Server上共享目录 在客户端PC上填入VSS Server的IP Address

18、 填入用户名：vss 密码(m m)：111 在Vss目录下双击netsetup.exe安装在VSS 客户端操作 第33页/共45页第三十三页，共46页。 填入111-1111111，点击OK完成(wn chng)Client安装 输入(shr)用户名、单位Client安装(nzhung)第34页/共45页第三十四页，共46页。打开(d ki)VSS客户端程序登录(dn l)画面进入(jnr)VSS主画面VSS客户端安装（3）登录VSS填入Username、Password、选定Database或手工填入(172.16.4.238VssRoot)第35页/共45页第三十五页，共46页。VSS客

19、户端安装（4）修改(xigi)密码 用户首次登录VSS画面(humin)后请先修改Password 输入旧密码(m m)及新密码(m m)后点击OK首次登录VSS画面后请先修改Password第36页/共45页第三十六页，共46页。4. 管理员操作(cozu)第37页/共45页第三十七页，共46页。管理员操作(cozu)命令一览 管理员操作主要分3部分(b fen)：1）维护用户列表 2）分配用户权限 3）数据库管理打开(d ki)VSS管理员界面。1）进行用户的添加、修改、删除以及密码的修改操作2）用户权限的分配操作3）数据库的管理 注：管理员操作须在VSS Server上进行，目前为172

20、.16.4.238第38页/共45页第三十八页，共46页。管理员操作用户权限(qunxin)分配（1） 用户权限分配方法(fngf)一：为Project分配不同用户权限 在VSS管理员界面菜单(ci dn)中选Rights by Project 针对每个Project（文件夹）设定不同用户的权限第39页/共45页第三十九页，共46页。管理员操作用户(yngh)权限分配（2） 用户权限分配(fnpi)方法二：为用户分配(fnpi)不同Project的权限 在VSS管理员界面菜单(ci dn)中选Rights Assignments for User 针对某个用户设定对Project（文件夹）的权限第40页/共45页第四十页，共46页。管理员操作清除临时(ln sh)目录 VSS通常在运行时把临时结果放在临时目录里，并在退出前将之删除(shnch)。由于某些原因，例如非正常重启，可能导致临时内容残留在目录中。管理员需定期清除临时目录的内容。 在VSS管理员界面(jimin)菜单中选Clean up Temp Directory 选OK即可。第41页/共45页第四十一页，共46页。管理员操作数据库备份(bi fn)与恢复 管理员需对V