VSS简明培训教程.docx
《VSS简明培训教程.docx》由会员分享,可在线阅读,更多相关《VSS简明培训教程.docx(13页珍藏版)》请在冰豆网上搜索。
VSS简明培训教程
1说明
一、本教程针对不同使用对象提供VisualSourceSafe6.0的若干使用指导,阅读对象包括VisualSourceSafe的管理员和普通用户,以及希望了解如何采用VisualSourceSafe进行软件版本控制的管理人员。
管理员或普通用户在使用VisualSourceSafe的过程中,如果遇到不知如何操作,或者对某些操作的注意事项不甚了解等类似情况时,可以查阅本教程。
二、本教程的"管理员部分"是管理员必读的,如果管理员在除履行其自身职责之外,还兼任普通用户的角色,则可以参阅教程中的"普通用户部分"。
作为一般的普通用户,只需阅读"普通用户部分"即可。
三、教程中列举的操作,加星号者,为高级用法(AdvancedUsage),其余为基本用法(BasicUsage)。
所谓基本用法是指一些通常使用频繁的,或者是使用方法较为简单的操作。
所谓高级用法是指通常使用频率不多,或者较为重要的,或者用法复杂的操作。
四、本教程内容摘选并改编自VisualSourceSafe6.0英文版联机帮助,从中提取了诸多重要信息、容易忽略的内容以及若干注意事项。
一些基本内容(主要指某些基本操作的使用方法)只简单列举了条目,欲了解这些条目的详细情况请查看联机帮助的相关部分,可以通过列于这些条目之后的英文说明在联机帮助中搜索到相关内容。
五、本教程不涉及VisualSourceSafe图形用户界面操作的解释说明,对指定功能的具体操作步骤请查看联机帮助的相关部分。
可以通过列于该功能之后的英文说明在联机帮助中搜索到相关内容。
六、在其他VisualStudio产品中(例如:
VisualC++)可以集成VisualSourceSafe的功能,本教程不涉及有关在其他集成开发环境下如何使用VisualSourceSafe功能的内容,这部分内容主要针对普通用户。
对这些内容的了解,在阅读完本教程之后,将会变得容易。
此外,某些操作在VisualSourceSafe环境下使用更为方便。
2概述
VisualSourceSafe(以下简称VSS)是一种版本控制管理工具。
它通过将各种类型的文件(包括:
文本文件、图像文件、二进制文件、声音文件、视频文件等)存入其内部数据库的方式,帮助你有效地管理工程(Project,关于VSS中工程的概念请见下面)。
它允许你在多个工程间共享同一组文件;你可以将一个文件添加到数据库中,以便其他相关人员使用;任何对文件的更改将被记录下来,以便在任何时候可以恢复到该文件的某个旧版本。
VSS的工程组织方式使团队协作开发变得更为容易和直观。
一个工程是一组存放于VSS数据库内的任意类型的文件,一个工程类似于操作系统中的目录,但VSS为其提供了版本控制、历史记录、文件合并等更多的功能支持。
3管理员部分
3.1维护用户列表(MaintaintheUserList)
3.1.1添加用户(AddaUser)
3.1.2更改密码(ChangePasswords)
3.1.3创建用户列表(CreateaUserList)
3.1.4删除用户(DeleteaUser)
3.1.5编辑用户属性(EditUserAttributes)
3.2管理数据库(ManagetheDatabase)
3.2.1分析数据目录(AnalyzetheDataFolder)*
建议你定期备份完整的VSS数据目录(参见数据库打包)。
VSS数据目录中包含有全部工程和文件的数据库信息。
由于网络或操作系统的某些故障,VSS中的文件可能存在错误和不一致问题,AnalyzeVSSDB工具被用来查找和修复这些问题。
在运行该工具前,需要锁定(Lock)所有用户并要求他们退出VSS,用户可以在一个数据库被锁定时保持文件的签出状态(参见锁定数据库)。
建议分两次运行AnalyzeVSSDB工具,第一次修复错误,第二次核查是否仍然存在没有被修复的错误。
数据目录的具体位置是由Data_Path初始化变量在SRCSAFE.INI文件中指定的(参见定制SS.INI和SRCSAFE.INI文件)。
3.2.2数据库打包(ArchiveDatabases)*
你可能需要定期地备份VSS数据库,或者数据库的某一部分。
VSSAdministrator工具提供了此项功能。
它可以:
节省VSS数据库服务器的磁盘空间。
加快显示历史记录操作(ShowHistory)的速度。
便于在多个VSS数据库间传递文件和工程,保持历史记录完整无缺。
备份全部或部分VSS数据库内容并压缩成文件。
3.2.3清除临时目录(CleanTemporaryFolder)
VSS通常在运行时把临时结果放在临时目录里,并在退出前将之删除。
由于某些原因,例如非正常重启,可能导致临时内容残留在目录中。
作为管理员,你有责任定期清除临时目录的内容。
每隔几周一次,当没有任何用户运行VSS或VSSAdministrator时,请清除临时目录的内容。
临时目录的具体位置是由Temp_Path初始化变量在SRCSAFE.INI文件中指定的(参见定制SS.INI和SRCSAFE.INI文件)。
3.2.4锁定数据库(LockaDatabase)
数据库锁定功能将不会自动锁定那些当前已经登录的用户,你应该在锁定数据库之前要求登录用户退出VSS。
在重新允许用户使用VSS之前,需要解除对数据库的锁定。
3.2.5数据库恢复(RestoreDatabases)
3.2.6使用多个数据库(WorkwithMultipleDatabases)*
缺省时,VSS将所有文件集中放在一个数据库中。
如果可能,应尽量使用一个数据库存放所有文件,这比分多个数据库存放要好,因为:
你不能在多个数据库间共享(Share)文件(参见对文件和工程的Branch/Share操作)。
将位于多个数据库中的内容集中在一起是比较困难的,需要使用VSSAdministrator的Archive功能(参见数据库打包)。
出于安全的考虑,VSS的用户信息,包括密码在内,是和数据一起存放的。
如果为了安全起见,要将信息拆分成多个独立的数据库,这种信息存储方式将带来极大便利,但你必须为每个数据库都单独添加用户。
3.3有关权限的话题(AboutRights)
3.3.1权限的传递(RightsPropagation)
当你添加了一个新用户,并为该用户设置了针对某个工程的权限时,将在VSS数据库中建立起一个assignment。
该assignment将会沿着工程树向下传递直至遇到另一个assignment。
例如:
针对工程"$/",你为用户A指定了Add权限(参见安全访问权限),而对于工程"$/Sample",你没有为用户显式指定权限,则该用户将对工程"$/Sample"自动拥有Add权限。
当你在工程"$/Sample/BusinessObject"处为其指定了Read权限后,将阻止早先assignment的向下传递过程,所以用户A对该工程(指"$/Sample/BusinessObject")及其子工程都只具有Read权限了。
当你首次添加一个用户时,该用户在工程"$/"处被赋予的权限由"缺省权限"决定,缺省权限是通过在VSSAdministrator里设置ProjectSecurity属性页的内容来定义的。
你可以通过修改该页内容,全局性地变更所有用户的缺省权限。
3.3.2安全访问权限(SecurityAccessRights)
3.3.2.1缺省安全设置
当安装VSS后,缺省安全设置将被启用。
你可以利用定制的方式,使某些用户拥有对某些工程和某些VSS命令的特定权限。
缺省安全设置很简单,当添加新用户时,你只有两种级别的访问权限可供选择:
只读权限(Read-onlyrights):
用户可以查看VSS中的任何内容,但不能更改。
可读写权限(Read/writerights):
用户可以查看和修改VSS中的任何内容。
如果这样的访问权限级别足以应对日常使用,那么就无需再增强安全控制的级别了。
所有的VSS安全管理都在VSSAdministrator中进行。
任何能运行该程序的用户都可以改变VSS的任意特性,所以最好只有管理员才使用该程序。
3.3.2.2更高级别的安全控制
在VSS中,对工程的安全性控制,是通过制定用户访问权限来实现的。
每个工程仅能被那些具有相应权限的用户访问到,每个命令仅能被那些具有相应权限的用户使用。
可以通过VSSAdministrator来定制权限,以达到更高级别的安全控制。
以下是VSS的权限级别列表,下列每种权限都拥有该权限之前的全部权限。
例如:
拥有CheckOut权限的用户,也将同时拥有Read权限。
(参见附录A2:
VSS中部分命令的对应权限级别)
4普通用户部分
4.1对工程、文件的一般性使用(NormalUseaboutProjectsandFiles)
4.1.1打开/关闭数据库(Open/CloseaDatabase)
此处略,详细内容请查阅联机帮助。
4.1.2创建新工程(CreateNewProjects)
此处略,详细内容请查阅联机帮助。
4.1.3添加文件、目录、工程(AddFiles,Folders,andProjects)
此处略,详细内容请查阅联机帮助。
4.1.4删除和恢复文件、工程(DeleteandRecoverFilesandProjects)
VSS提供了3种删除文件的方法:
Delete:
VSS只把指定文件从当前工程中删除,而在VSS数据库中仍留有该文件的记录。
此外,其他共享了该文件的工程仍保留此文件(参见对文件和工程的Branch/Share操作)。
Destroy:
VSS将把指定文件从VSS数据库中彻底删除,其后将无法恢复。
Purge:
永久性删除已被Delete掉的文件,其后将无法恢复。
对于共享文件,Delete和Destroy仅将文件从当前所选工程中删除掉,其他共享了该文件的工程,以及VSS数据库中,仍留有此文件。
4.1.5移动文件和工程(MoveFilesandProjects)
移动一个文件的唯一方法是,在文件新所在位置的上一级工程(parentproject)处使该文件共享(参见对文件和工程的Branch/Share操作),然后将原有工程(originalproject)下的该文件Delete或者Destroy(参见删除和恢复文件、工程)。
移动后,文件的历史记录将被保留。
通过使用Move命令,你可以将一个子工程(subproject)从某个上级工程重置到另一个工程下。
该操作不会改变子工程的内容和历史记录,但它会影响上级工程的历史记录(包括子工程所在的原有上级工程和新的上级工程)。
当移动一个工程后,你将无法重建原有上级工程的某个旧版本。
4.1.6重命名文件、工程(RenameFilesorProjects)
若某个文件被多个工程所共享,对该文件的重命名将影响所有工程,而在Branch状态下,则不影响(参见对文件和工程的Branch/Share操作)。
4.1.7设置工作目录(SetWorkingFolders)
此处略,详细内容请查阅联机帮助。
4.2签入、签出、获取、查看及相关操作(CheckIn/Out、Get、ViewandOtherRelatedUse)
4.2.1签入签出操作(CheckInandCheckOutFiles)
此处略,详细内容请查阅联机帮助。
4.2.2撤销签出(UndoCheckOut)
执行该操作时,若用户选择了替换本地文件,则用户将丢失最近一次签出后对该文件在本地的更改。
4.2.3获取最近版本(GetLatestVersion)
此处略,详细内容请查阅联机帮助。
4.2.4获取早期版本(GetEarlierVersion)
此处略,详细内容请查阅联机帮助。
4.2.5获取和查看文件、工程(GetandViewFilesandProjects)
Get操作将文件或工程拷贝至本地的工作目录,并设置为read-only属性。
可以用View操作查看文件内容,此时用户无需设置工作目录。
尽量不要删除vssver.scc文件。
本地工作目录及每个子目录下都包含一个这样的文件,VSS利用其中记录的信息确定本地目录中哪个文件已经更改了。
删除后,将使新一次的Get操作速度减慢。
4.2.6回滚到以前版本(RollbacktoPreviousVersions)
该操作将使文件的内容恢复到先前某个版本时的状态,它将使所有在该版本后所做的改动丢失。
如果你所回滚的文件被多个工程共享,则操作只影响你所指定的那个工程,并且它会自动实行Branch操作(参见对文件和工程的Branch/Share操作)。
建议你使用虚拟回滚(VirtualRollback),它将不会使随后的改动永久丢失。
具体操作如下:
选择你要回滚的文件并签出
使用Get命令获取某个原有版本到本地
签入该文件
4.2.7多人同时签出一个文件(CheckOutMultipleFiles)*
缺省状态下,一个文件只允许一个人签出,管理员可以通过修改配置,允许多人同时签出。
此时,VSS将跟踪所有签出该文件的用户。
每当用户签入时,VSS都将和当前存于数据库内的最新版本进行比较,若用户修改的是同一文件的不同处,VSS将进行简单的合并(Merge),否则提示用户,并且不允许签入。
用户可以通过VSS提供的VisualMerge工具,比较存放于VSS数据库中的文件和本地文件的异同,手工修改本地文件,直到认为已经可以签入时,方才执行最终签入操作。
(参见合并)
4.2.8合并(Merge)*
在VSS中,合并可能发生在3种场合下:
使用MultipleCheckout的工作方式;合并原先已经Branch了的文件;获取(Get)文件。
MultipleCheckout:
若多个用户同时签出一个文件,第一个用户只要简单的签入就可以了。
后续用户也可以签入,但他们的更改将需要和其他所有用户的更改合并,VSS将得到完整的更改内容(参见多人同时签出一个文件)。
Branch:
当被Branch的文件合并到其中一个分支时,VSS将会把在另一个分支上所做的改动合并到该分支上(参见对文件和工程的Branch/Share操作)。
MergeonGet:
在MultipleCheckout工作方式下,当使用GetLatestVersion操作时可能引发合并操作,此时保存在VSS数据库中的内容将合并到本地文件。
但如果某个文件是排他性签出的,则不会引发合并操作(参见排他性签出)。
在完成一个合并之后,VSS遵循如下规则:
如果仍有冲突,VSS维持文件的签出状态,为了使文件能顺利签入,你必须排除这些冲突。
如果你使用MergeBranches命令,将一个文件合并到一个工程中,而该工程中的对应文件已被签出,该文件将继续保持签出状态(参见对文件和工程的Branch/Share操作)。
在任何其他时候,VSS将会提示你,或者在合并后自动签入,或者保持文件的签出状态以使你在更新VSS数据库中内容之前再核查一边。
缺省情况下,当发生冲突时,VSS将启用其VisualMerge工具。
4.2.9排他性签出(ExclusiveCheckOut)*
允许多人同时签出一个文件是针对整个VSS数据库而言的,但用户仍可以根据实际情况,针对某些文件修改该规则。
对某个文件实施排他性签出,则其他用户将无法签出该文件,直至该用户使用了签入操作。
4.2.10对工程的Cloak操作(CloakProjects)*
若对某工程实行了Cloak操作,则当对该工程的上一级工程进行Get/CheckIn/CheckOut/UndoCheckOut/ProjectDifference操作时,将不会影响该工程及其子工程。
而在该工程上进行类似操作时,则和平常得到的结果一样。
这一属性将传递给其下的子工程。
例如:
某个工程其路径为$/Application,下面有三个子工程:
$/Application/Code,$/Application/Test,$/Application/Docs,而Docs工程下的内容可能对你没有任何用处。
当你每次从$/Application处进行Get操作后,都需要从本地删除多余的Docs目录。
此时可以对Docs进行Cloak操作。
这样,每次的Get操作将只把Code和Test下的内容放到本地。
如果你需要获取Docs工程下的内容,则可以单独从Docs处进行Get操作。
4.3Branch、Share、Label和Pin操作(Branch、Share、LabelandPin)
4.3.1对文件和工程的Branch/Share操作(BranchandShareFilesandProjects)*
在VSS中,通过Share操作,一个文件可以被多个工程共享,在任何一个工程中对该文件的更改,都将反映到其他相关工程里。
Branch操作则消除这种共享,每次将一个被共享的文件拆成两个分支,在不同工程中分别跟踪该文件。
通过查看文件属性的Links属性页可以了解该文件被哪些工程共享,通过查看Paths属性页可以了解文件的分支状况。
例如:
产品目前的正式版本为2.0(工程路径为$/Application),在加入新功能后将升级为3.0。
但在开始升级的过程中,其间的一个过渡版本2.1存在bug,需要修改。
此时可以进行如下操作:
选择被Label标识为2.0的那个版本(参见给文件、工程指定标签),利用Share功能创建过渡版本(工程路径为$/Application2.1),此时两个工程中的文件是共享的,且$/Application2.1中的所有文件都处于Pin状态(参见Pin操作),即:
在向3.0升级的过程中,对$/Application中相关文件的更改,将不影响$/Application2.1下的内容,但此时文件仍是共享的。
仅对需要修改bug的文件采取Branch操作。
这样做的好处是,中间版本的bug修改工作和3.0的升级工作可以同时进行,并且最大限度的降低了所需的存储空间。
4.3.2给文件、工程指定标签(LabelFilesandProjects)*
VSS使用3种方式跟踪文件的历史记录:
内部版本号,日期,用户自定义标签。
标签可以是一个不超过31个字符长度的串,例如:
"1.0"、"2.01b"、"FinalBeta"、"ApprovedforQA"。
应用Label功能,用户就可以获取某个特定时期的软件内容了。
所有当前工程下的文件和子工程都将继承该标签。
注意下面几点:
当使用Label功能时,表明你在所选工程的历史记录里创建了一个新的版本,但文件和工程本身的内容并未发生变化。
对某个工程的某个标签再次使用Label操作将覆盖原来的标签内容。
请参见附录A1:
同时维护一个工程的多个版本
4.3.3Pin操作(Pin)*
该功能对共享文件很有用,尽管它的使用不仅限于共享文件,也包括其他任何文件。
当你对一个文件实施Pin操作后,你将不能对之做任何修改。
如果一个文件在Pin之后又被实施了Share操作,而被Pin的那个版本同时也是被共享的版本,则所有共享该文件的工程都不能更改该文件。
如果一个文件先被实施了Share操作,而后在某个工程中被Pin了,则除了这个工程外的其余工程仍可以更改该文件(参见对文件和工程的Branch/Share操作)。
4.4其他操作(OtherUse)
4.4.1扩展关键字(ExpandKeywords)*
VSS可以将某些指定信息(例如:
VSS内部版本号)直接插入文本文件中。
用户只要将某些关键字放入文件的注释中,每次添加(Add)或签入(CheckIn)文件时,VSS都会自动查找这些关键字,并将相关信息置于其后。
VSS中常用的关键字:
关键字
描述
$Archive:
$
文件在VSS中的路径名
$Author:
$
最近一次更改文件的用户
$Date:
$
最近一次签入的时间
$History:
$
文件的历史记录
$Revision:
$
VSS内部版本号
$NoKeywords:
$
使VSS对其后的所有关键字不进行扩展
例如:
在某文件中加入如下一行:
$Revision:
$
若当前该文件在VSS内部的版本号是22,则签入后VSS会将之修改为:
$Revision:
23$
4.4.2使用Shadow目录(WorkwithShadowFolders)*
Shadow目录位于服务器端,包含了工程中所有的文件。
这些文件既非位于VSS数据库中的mastercopy,亦非位于本地工作目录的localcopy,而是最近一次签入的所有内容。
Shadow目录应该由管理员来设置。
是否使用Shadow目录功能是可选的,通常在如下两种情况下可以考虑使用该功能:
为使某些用户能查看文件(但不能更改),这些用户可能没有对VSS的访问权限。
不让你的本地工作目录保留可编译的软件副本。
为使每个用户都能得到一个最新版本的软件,所有用户可能希望在某个目录下集中进行编译,而非在各自的工作目录下编译。
在这种情况下,Shadow目录功能通常和添加(Add)、签入(CheckIn)之后的RemoveLocalCopy结合使用。
Shadow目录不会跟踪子工程的变化,例如:
你有一个被Shadow的工程$/A,包含两个子工程:
$/A/1和$/A/2,而你又将$/A/2重命名为$/A/B,这种变化将不会被反映到Shadow目录中。
你可以手工修改,或者利用ReconcileAll功能,使之保持同步。
4.4.3性能优化(OptimizePerformance)*
有两种方法可以改善VSS的性能:
尽可能多的将内容通过网络拷贝至本地来做;修改初始化文件对VSS的性能进行微调。
具体优化措施:
在SS.INI或SRCSAFE.INI文件中设置如下变量:
Diff_Ignore(PC)=c-e-s-w-
使VSS在进行文件比较时忽略end-of-line标记,从而加快运行效率
CP_OnSelection=No
在使用VSSExplorer时,缺省状态下,用户使用鼠标单击或使用键盘的方向键在工程列表上移动时,就会选中工程。
设为No后,只有双击鼠标或按回车键才会选中。
设置临时目录
缺省情况下,VSS将临时文件存于服务器端,但管理员可以通过修改SS.INI中的Temp_Path变量,将临时路径设置在本地。
让管理员在SRCSAFE.INI文件中将Lock_Mode变量设置为Native
这是SRCSAFE.INI中该变量的缺省设置,把该变量设置为Native将使几乎所有的VSS操作都得到加速。
该变量只能由管理员来设置。
管理员通过Disable下面的功能,也可以一定程度地改善性能:
Shadowfolders(参见使用Shadow目录)
Journalfiles
Projectsecuritysystem(参见安全