《SVN使用规范_详解》由会员分享，可在线阅读，更多相关《SVN使用规范_详解（41页珍藏版）》请在金锄头文库上搜索。
1、 目 录第一章引言11.1Subversion的介绍11.2Subversion的特性11.3SVN链接模式21.4SVN操作流程3第二章SVN使用42.1SVN软件安装42.2事业部SVN库介绍42.2.1事业部SVN库42.2.2帐号注册、权限申请52.3基本操作52.3.1操作介绍52.4系统规范使用182.4.1规范操作182.4.2版本控制的使用192.4.3与目录无关内容192.4.4文件夹目录名称规范202.4.5文件上传格式212.4.6文件、数据放置212.5日常使用问题212.5.1版本库无响应212.5.2邮件中的路径链接212.5.3系统库最上层打不开222.5.4提交
2、失败（Commit fail）222.5.5SVN文件夹无法下载232.5.6特征图标的显示232.5.7冲突问题解决24第三章权限申请流程263.1权限定义263.2申请流程263.2.1普通权限申请263.2.2单位权限申请263.2.3特殊权限申请273.3表单使用28附录1参考文献5SVN使用规范第一章 引言1.1 Subversion的介绍SVN是Subversion的缩写。Subversion管理随时改动的文件和目录，以二进制格式存储所有的文件，使用高效的比较二进制差异算法来计算版本之间的改动。同时，它是一个时间机器，随时记录文件和目录的每次改动，例如：文件的增加、删除、重新排列文
3、件等。同时SVN允许你恢复以前旧版本的数据，或者检查数据变化的历史。SVN使用类似数据库事物的方式来处理用户提交入库的过程，整个改动要么成功的被提交，要么被中断并回滚。在数据提交完之前，其他人是看不到用户提交的修改文件，你看到的要么是改动之前的状态，要么是改动之后的状态。这样的行为被称为“原子提交”。原子提交很有用，因为它能保证所有相关人员看到的总是相同的东西。原子提交过程的其中一步就是包括把你的所有改动打包为一个“修订集”（有时被称为改动集），并且再给个改动标记的修订号（绿色勾变为红色叹号）。1.2 Subversion的特性1.2.1 版本化的目录 Subversion实现了一个可以跟踪目
4、录树更改的“虚拟”版本化文件系统，文件和目录都是有版本的。1.2.2 真实的版本历史 通过Subversion你可以对文件或是目录进行增加、拷贝和改名操作，也可以新增一个具有干净历史的文件。可以毫不夸张的将每一个版本都可以作为一个记忆片段定点。1.2.3 原子提交版本库采用二进制差异形式提交修改的数据内容，一系列的改动，要么全部提交到版本库，要么一个也不提交，这样可以让用户构建一个需要提交修改的逻辑块，放置部分修改提交到版本库。1.2.4 一致的数据操作Subversion表示文件是建立在二进制文件区别算法基础上的，对于文本（可读）和二进制（不可读）文件具备一致的草所方式，两种类型的文件都压缩
5、存放在版本库中。1.3 SVN链接模式其中本地工作副本与SVN系统链接的媒介是“.svn”隐藏文件夹，.svn隐藏文件夹中包含了系统链接、版本等信息，图1-1为本地工作副本与SVN系统链接后状态，绿色勾代表文件受系统控制（后面简称：受控）标志，红色叹号为受控文件改动标志。图1-1 链接状态1.4 SVN操作流程WorkingCopyWorkingCopyRepositoryNetwork版本库网络本地工作副本检出、提交图1-2 操作流程图图1-2总体概括了SVN整个操作过程：首先用户从版本库通过网络“检出”到本地工作副本中，然后，在本地工作副本中进行增加、修改、删除文件后“提交”到版本库中，如
6、果本地工作副本中版本较系统版本过时，用户使用“更新”功能与系统上版本保持一致。第二章 SVN使用2.1 SVN软件安装SVN的安装软件是公司受控软件，用户安装需要由各单位文员走软件安装的OA流程，在接到流程申请后电脑中心安排阳光服务安装。如果SVN软件在电脑重装系统后被卸载掉，请用户直接联系电脑中心（内线：63333）处理。2.2 SVN库介绍2.2.1 SVN库SVN库，分别是：办公库（office）、车型项目库（public）、公共资源库（public）、数据传输库（FTP 15b）。其中办公库、车型项目库、公共资源库为同一帐号密码；数据传输库为独立帐号，便于数据库后台的清理。各库的登录路
7、径如下：n 办公库（office）：各单位职能部门工作平台。登录路径：http:/10.8.5.9/officen 车型项目库（project）：事业部承接的所有车型项目工作平台。登录路径：http:/10.8.5.9/projectn 公共资源库（public）：事业部专利、共享资源、文件、表单等数据文档放置点。登录路径：http:/10.8.5.9/publicn 大数据传输：应用于事业部内部数据传输的数据传输库（FTP 15b），确保各单位之间递的便捷。登录路径：svn:/10.8.5.9/FTP 15b2.2.2 帐号注册、权限申请1. 用户帐号注册：新进员工没有SVN帐号，通过邮件联
8、系SVN管理员（管理员联系方式请见附录三），邮件正文注明申请SVN普通帐号，管理员处理完帐号注册事宜后，会邮件回复。 注：普通帐号，只对公共区域目录有读取权限。2. 权限的申请：用户一律通过各单位SVN干事（SVN干事联系方式请件附表一、附表二）申请SVN权限，由SVN干事统一汇总权限申请单。凡是涉及到事业部层面的权限申请或者是涉及到非本部门的权限申请，一律填写特殊权限申请单，在各方领导审核审批后，交由SVN管理员处理，在管理员处理完毕后回复用户。 权限的具体申请流程在后面的第三章中将详细介绍。2.3 基本操作2.3.1 操作介绍1. 系统登录点击鼠标右键出现功能选项，选择“TortoiseS
9、VN”中的“版本库浏览器”，这时系统弹出URL界面，用户在URL中输入需要进入的库路径，弹出登录认证框，用户输入用户名和密码进入系统主界面。 图2-1(a) 系统登录图2-1(b) 认证界面图2-1(c) public库系统界面图2-1（a）和图2-1（b）是系统登录操作界面，图2-1（c）是系统的主界面，三副图中整体描述了SVN系统的登录情况。注：图2-1（b）中“Save authentication”是保存认证选项，用户根据需要对自己的用户名和密码进行保存，以便在下次操作时不需要再次输入用户名和密码了。2. 设置功能的使用在上节类容中主要讲述了系统的登录方式和认证保存的方法，接下来继续讲
10、述系统“设置（Setting）”功能的使用。在设置中，用户可以根据需要选择系统的语言显示、清除已保存的数据、显示特征标志等等。（1） 系统语言显示选择图2-2 系统语言中-英文转换系统安装后全部默认为英文模式，这时需要用户手动切换到中文模式。图2-2中描述了中英文切换的过程，在选择“设置（Setting）”功能后弹出的对话框自动显示语言栏（Language），用户选择“中文（简体）”后确认即可。（2） 忽略上传文件SVN系统有一个似过滤器的功能，在本地工作副本中用户可以根据需要过滤一些不需要上传到服务器的文件，这个功能就是“全局忽略样式”。图2-3（a） 全局忽略样式忽略样式对提交文件扩展名进
11、行选择性忽略，忽略格式通常以*.X形式被系统识别，例如：用户不需要将编译产生的.o和.err文件提交到SVN上，这时用户在全局忽略样式中输入*.o *.err如图2-3（a），各条目之间以空格分隔。注意：当用户在本地工作副本中对新添加文件采用了系统添加功能操作，忽略样式功能对本地副本中的文件将不起作用，如图2-3(b)表蓝色加号表示文件已添加；另外还有一种情况，如果已经将想忽略的文件提交到了SVN系统上，是无法进行忽略的。图2-3（b） 添加文件样式（3） 保存清除在对系统保存认证后相应需要对认证进行清除，清除功能仍然在设置模块中，界面如图2-4。在保存清除中共可以对本地四种已保存数据进行清除
12、，分别有URL历史记录、日志信息、窗口大小、认证数据，在对这些数据完全清理后系统自动恢复到“零”状态。因此，用户在离机后也别忘记将保存认证数据清除掉，以保障资料的安全性。图2-4(a) 认证清除图2-4(b) 密码清除（4） 特征标志选择不少用户在使用SVN“检出”功能后，本地工作副本没有出现特征符号绿色勾或其他特征符号，这是由于系统无法识别默认的状态缓存，需要人工手推选择状态缓存方式，改变状态缓存方法如图2-5，在设置中选择“外观与样式”的“图标叠加”模块，再在“状态缓存”中选择“Windows外壳”。图2-5 特征显示设置中其他不常用的功能不再进行一一介绍，用户可以根据日常操作实践来理解。
13、3. 在SVN系统上进行日常工作SVN系统不支持直接在系统上对文件修改的操作。如果有受控文件需要修改，用户可以通过在本地工作副本中修改后提交到系统上，这中间的媒介就是.svn隐藏文件夹，系统的整个操作范围：“检出”“提交”“更新”，接下来给大家详细介绍各操作。（1）本机文件夹与服务器文件夹之间的链接首先，在本地电脑新建一个文件夹，并给文件夹重新命名；然后，鼠标选择文件夹，点击右键选择“检出（Checkout）”功能,使用检出功能后本地文件夹有一个绿色的勾，称之为本地“工作副本”。图2-6（a）中黄色框为SVN路径选择区域，绿色框为本地路径选择区域，用户根据需要在后面按钮处选择相关下载路径。图2
14、-6（b）中为系统文件夹检出到本地后的状态。 图2-6（a） SVN检出按钮图2-6（b） SVN检出视图另外，用户还可以在系统界面直接检出需要文件夹到本地，在服务器界面选择需要下载文件夹如图2-6（c），然后点击右键选择“检出”功能再继续按照以上操作即可。注：用户需要注意“检出”功能只针对系统文件夹，对于系统中单个文件是不能够使用检出的。图2-6（c） 界面SVN检出（2）日常操作上传SVN当创建了本地工作副本后，可以在副本中进行任何日常操作，如：增加文件夹、文件、修改文件、数据等，用户每天下班前将需要本地副本中做的修改提交（Commit）到SVN上，确保服务器上数据与本地副本中的数据保持同
15、一版本。需要强调的是，虽然用户在本地创建了工作副本，但如果所有执行操作没有提交到SVN上，一旦本机数据丢失，将无法追溯。用户在提交时需要注意两点，如图2-7： 选择提交无版本控制选项，避免出现新增文件漏提现象； 日志备注的填写，方便后续对文件的追溯。图2-7 SVN提交（3）文件修改差异比较SVN系统有一个非常适用的功能“修改差异的比较”，可以将本次修改内容和原稿作比较并显示出来，图2-8（a）为提交版本与修改前差异比较方法，图2-8（b）为追溯历史版本之间差异的比较方法。图2-8（a） 修改差异比较图2-8（b） 追溯差异比较1图2-8（b） 追溯差异比较2（4）历史追溯SVN系统的记忆犹如时间片段的集合，每一个版本代表了一个时间定点，当用户需要回顾或追溯之前的某一个时间节点时，通过系统的日志显示（sh
