SAW客户端操作指南.docx
- 文档编号:4940789
- 上传时间:2022-12-11
- 格式:DOCX
- 页数:11
- 大小:236.31KB
SAW客户端操作指南.docx
《SAW客户端操作指南.docx》由会员分享,可在线阅读,更多相关《SAW客户端操作指南.docx(11页珍藏版)》请在冰豆网上搜索。
SAW客户端操作指南
SAW客户端操作指南
SAW软件为VSS版本管理软件的配套工具,能很好地解决VSS原有的安全性不足、难以远程访问等问题,是同类软件中使用情况最好的。
特在此作介绍,以便在配置管理实施中使用。
SAW和VSS的不同
●客户不再使用VSS自带客户端,改用SAW客户端。
而SAW客户端没有改变VSS客户端的基本功能和操作习惯。
切换客户端对使用者来说没有什么不习惯的。
●SAW客户端能够达到Internet访问VSS配置库的要求,即可以远程访问,满足分布式开发需要。
●SAW应用后,可以取消VSS配置库文件夹必须共享的要求,这样配置库文件夹读写共享带来的安全性问题得到解决。
●SAW可设立中间缓存服务器,以均衡负载。
术语及定义
1.Checkout—检出:
将文件从配置库取出到本地,获得修改权。
2.Checkin—提交:
将本地文件放回配置库中,本地文件属性改只读。
3.Createproject—新增项目:
即在VSS配置库中新建一个目录。
4.Label—标签:
在特定时间点,命名一个文件集合。
5.Getlatestversion—获取服务器上最新的版本,更新本地的文件。
1SAW客户端安装与设置
1.1SAW客户端安装
安装程序:
\\192.168.87.241\tools$\软件工程\配置工具\SAW5.3,安装中用默认选项即可。
1.2系统登录
登陆界面如图:
Server:
内网地址:
192.168.91.41或
外网地址:
60.191.25.162(电信)
221.12.171.172(网通)
Port:
8870
连接后,输入vss用户名和密码,和对应的数据库(database),如图:
用户名约定为域用户名。
为提高系统安全性,密码要求6位以上,并包括小写字母、数字、符号或大写字母。
如guest.123
如:
UserName:
zhangsan
Password:
Guest123
Database:
1021X-金融工程部
提醒选中“RememberPassword”,这样下次登录时就不用再次输入密码。
2SAW基本操作
2.1SetworkingFolder(设置本地工作目录)
登陆后,最好就先建立服务器端目录与本地目录的对应关系,一般设顶层即可,子目录会自动对应。
这样从服务器端的文件取得的文件,就会到本地对应目录中。
如图:
2.2新建服务器端目录、文件
如果想往服务端加目录和文件(如新建项目),可在本地先把目录、文件准备好,再拖入SAW对应目录窗口,类似windows资源管理器的操作。
SAW会提示写增加目录、文件的注释。
注意:
有子目录时,请选中recursive(递归)选项。
如图:
2.3GetLatestVersion(取服务器上最新文件,但不修改)
用于取其他开发员的工作成果。
选中服务端目录或文件,右键菜单中即可选择“GetLatestVersion”。
需取子目录内容时,同样选中recursive选项。
makewritable:
设置读/写操作的。
一般不用,但是想临时改变本地文件属性时用。
Replacewritable:
当本地目录中文件为可写时,设置系统如何执行拷贝:
Ask:
系统提示是否覆盖本地的同名文件;
Replace:
自动覆盖本地的同名文件;
Skip:
不覆盖本地的同名文件;
Merge:
将两个文件合并。
一般不用,应以配置库中文件为准。
在“setfiletime”中的三个选项如下:
current为文件最后的修改时间;
Modification为文件最近一次修改的时间;
checkin为文件最后一次checkin是的时间。
2.4Checkout(取服务器上的文件准备修改)
用于开发修改前,从服务器获得需修改的文件,取到后,服务器自动在文件上打红色标记,并防止其他人拿去修改。
其他人可看服务器上此文件的当前内容,但不能修改。
当我们要修改一个文件时,首先要把文件从配置库中复制到“workingfolder”中,文件属性为“可写”,这一系列动作的命令就是checkout。
具体使用方法如下:
正常情况下,只需选择要修改的文件,右单击后选择checkout,这时会弹出一个对话框。
按默认选项,点击“OK”键即可。
注:
“don’tgetlocalcopy”选项缺省是不选的,它的意义是这样的:
如果不选保持缺省状态,当本地的同名文件是只读时,则系统首先用配置库中的文件更新本地的文件,本地的文件变为可写。
当本地的文件是可写时,则会出现另一提示框,其中的选项leavethisfile:
本地文件保留当前状态,配置库中的文件也保留当前状态,这样有可能两个文件不一致。
选项Replaceyourlocalfilewiththisversionfromsourcesafe:
用配置库中的文件更新本地的文件。
如果选择don’tgetlocalcopy选项:
则不把配置库中的文件拷贝到本地。
文件checkout成功后,可以看到配置库该文件上有红色标记,这时你的本地文件是可写的,就可以修改文件了。
为了操作更简便,推荐一种checkout方法:
一般情况下,当配置库中文件比本机文件新时,则按照默认选项进行checkout即可;
当本地文件比配置库文件新时,选择don’tgetlocalcopy选项。
然后checkin使本地机与服务器内容同步;
注意:
VSS中使用了文件锁的概念,当一个文件被别人checkout时,其他人不能再checkout此文件;只有当该文件checkin后,其他人才能再checkout去修改。
因此,应养成良好习惯,只checkout需修改的文件,以免影响别人修改。
修改完、单元测试完后及时checkin。
2.5Checkin(文件修改完后放入服务器)
用于开发修改完后,将成果放回服务器,给其他人使用,并作备份。
此时本地文件自动改为只读方式,不要强行修改,以免混乱。
如图:
我们必须利用checkin命令来更新配置库文件,它的作用是用本地的文件更新配置库中被checkout的文件。
checkin与checkout应成对使用。
具体操作:
在SourceAnyWhere选中处于checkout状态的文件,右单击选择checkin即会出现一个对话框:
一般按默认选项操作即可。
Keepcheckedout选项,用于文件执行checkin命令后,仍然保持为checkout状态;
removelocalcopy选项,可以在checkin的同时,删除本机上的同名文件。
Checkin成功后,配置库和本地的文件是完全相同了,本地文件属性变成只读。
要再修改文件时,需再执行checkout操作,此时本地机的文件属性自动变为可写状态。
一定记住checkout后修改完要checkin,否则你的成果在配置库中没有得到保存。
另外,应保证你的代码正确、可编译后再CheckIn,否则会使得其他人也无法通过编译,那么整个工程就没法调试了。
3SAW高级操作
3.1添加项目
可以在根节点下添加项目,方法是:
File—AddFile出现AddFile对话框后选中相关文件,按Add之后,会弹出的对话框:
可以在Comment中添加注释。
选择Storeonlylatestversion,是表示只保存了最新的一个版本。
选择Recursive(只对Project标准),是指当选择整个folder添加时,该文件夹中的所有子目录一起添加。
FileType,允许你改变的filetype有:
Auto-detect、Binary和Text.
3.2添加文件
也可以通过File-CreateProject在根目录下创建一个项目后在此项目节点下添加文件。
3.3文件属性
添加完文件后,所添加源文件的属性自动变为只读。
(注:
在所添加文件的文件夹下生成一个vssver文件)
3.4文件类型
添加一个FileType,方法是:
Tools—options—filetypes—Add.
注:
当前测试到,在添加*.pdf或者*.sh类型的文件时,不能便用Auto-detect类型。
因为系统会默认为*.pdf,*.sh是二进制文件,会以二进制方式上传和保存。
3.5双击文件
在SourceAnyWhere中双击要打开的文件,会弹出一个对话框,如下图:
选择“ViewSourcesafe’copyofthisfile”点击OK,SourceAnyWhere会将文件拷贝一份到本地机的临时文件夹中(临时文件夹路径在tools-options-general下设置),因原文件前面提到已经变成只读,所以临时文件也是只读属性,而且文件名会通过系统自动更改。
选择“Checkoutthisfileandedititinyourworkingfolder”选项,系统会首先执行一个checkout的操作,然后在选择”Selectanexternaleditorapplication”中的应用程序来编辑文件。
”Selectanexternaleditorapplication”中的选项,其中“Usethesystemdefaultapplicationforthisfiletype”表示用系统默认的应用程序,”UseApplication”表示用操作员另外选择的应用程序来打开所选择文件。
3.6undocheckout操作
当一个文件被checkout后,如果希望撤销这项操作,可以使用undocheckout命令,操作步骤:
选中处于checkout状态的文件,右单击后选择undocheckout.
当配置库中的文件和本地的文件完全相同时,则不出现提示信息,文件恢复为普通状态。
当配置库中的文件和本地的这个文件不完全相同时,则出现提示窗口:
localcopy中包括三个选项:
replace选项:
选中后会出现系统询问是否覆盖的信息,如果单击yes则是用配置库上的文件最后一个版本覆盖本地机上的文件,如果选择no则保留本地计算机上文件的内容,配置库上的文件是上次checkin后的内容。
此时,两个文件是一样的;
leave选项:
保留本地磁盘上的内容,配置库的文件是上次checkin后的内容,两个文件可能出现不同;
delete选项:
删除本地计算机上的这个文件。
选择一个选项后,单击OK后,文件回到普通状态。
3.7edit操作
edit命令是一个组合命令,是先checkout再修改的命令的组合。
应当注意的是,执行edit命令后,我们修改了文件,但是配置库中的文件并没有同步的修改,还是需要通过checkin完成本地文件与配置库上文件的同步。
3.8showhistory操作
方法:
选中此文件,右单击选择showhistory,出现一个对话框:
Includefilehistory(projectonly):
除了显示project的历史记录之外,也同样显示在此project下的文件的历史记录。
Labelsonly:
如果已经选择了IncludeLabels选项,那么在file/project的历史记录中只包含了打上相同标签的记录。
DateRange:
Donotfilterbydate:
不筛选历史记录;
Onorbefore:
在指定的日期前,筛选file/project的历史记录;
Onorafter:
在指定的日期起,筛选file/project的历史记录;
Includerange:
按指定的日期范围,制约历史报告;
Includepastdays:
在给定的过去几天里,筛选历史记录。
经选择OK后弹出一个窗体,窗体中显示这个文件的所有版本,需要查看某个版本只要直接双击该文件即可。
如果需要下载某个先前的版本可以点击get按钮。
需要查看该版本的详细信息可以点击Details按钮。
在该窗体中有一个pin按钮,这个按钮的作用是:
锁定文件。
意思就是当选中某一个文件,执行pin命令后,那么就不能对该文件进行checkin/out等操作。
当对这个pinned文件进行Getlatestversion操作时,那么这个pinnedversion就被找回。
通过showhistory命令,可以快速地查找文件的更新/修改记录,也可以比较两个以上文件的差异,也可以通过该命令窗口,找回修改之前的版本。
3.9关于password的更改
password一般是由CM管理员分配的,如果需要修改密码,可以在tools-changepassword下修改。
需要说明的一点是当你的SourceAnyWhere密码和windows密码相同时,启动SourceAnyWhere,不会出现提示你输入密码的对话框。
3.10关于共享-share
选择SourceAnyWhere—share后,弹出一个对话框,在project选项中,显示了共享来自的project的名称;Filestoshare:
显示了共享来自的file的名称;ListFilesofType:
给出了文件类型,告诉SourceAnyWhere怎样对文件进分类;Branchaftershare:
共享文件,直接创建一个单独的副本。
文件共享后,虽然存在于不同的文件夹内,但无论是哪一个文件夹中的文件内容发生改变,所有文件夹内的文件内容都会发生变化,直到对文件进行Branch操作后,那么再改变任何一个文件内容时,不会出现同时改变的情况。
所以,文件共享其实就是存在于不同文件夹内的同一个文件。
3.11删除工程/目录文件
删除工程/目录文件:
delete
选中工程/文件,点击鼠标右键,会出现如图所示:
选中“Delete”出现下图:
注意“DestroyPermanently”为彻底删除不恢复选项,一般由管理员控制,开发员最好不去彻底删除,以免误删后无法恢复。
3.12重命名工程/文件
重命名工程/文件:
rename
选中工程/文件,点击鼠标右键,选中”rename”选项,执行即可。
3.13查看工程/文件属性
重命名工程/目录文件:
propites
选中工程/文件,点击鼠标右键,选中”propites”选项,执行就可以查看相应的工程项目属性。
3.14移动工程项目所在的位置
选中工程/文件,运行菜单”file->move”选项,就可以将相应的工程项目或文件移动到目标位置。
3.15CloakProject
选中工程,运行菜单”Tools->CloakProject”选项,就可以将相应的工程项目进行锁定,一个锁定的工程中,诸如“GetLatestVersion,CheckOut,CheckIn,UndoCheckOutandShowDifferences”这些命令均将无效,直到进行“UncloakProject”操作。
【修订记录】
批准日期
修订说明
编制部门
2009/03/02
基于公司的SAW操作说明的基础上修改为金融事业部的操作指南
金融项目总监办
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- SAW 客户端 操作 指南
![提示](https://static.bdocx.com/images/bang_tan.gif)