SVN用户使用指南SVN用户使用指南.doc

SVN用户使用指南 文档变更记录 文件状态： [ ]草稿 [√]正式发布 当前版本： V1.0 作 者： 谭斌 审 核 人： 发布日期： 修订号 修改内容描述 修改人 修改日期 备注 目 录 1. 引言 1 1.1. 目的 1 1.2. 范围 1 2. SVN基础知识 1 2.1. SVN简介 1 2.2. SVN特性 1 2.3. SVN的架构 3 3. SVN的基本应用 4 3.1. 客户端的安装 4 3.2. 版本库浏览 Repo-browser 6 3.3. 版本库的基本操作 8 3.3.1. Add file（folder）添加文件(文件夹) 8 3.3.2. commit 提交 9 3.3.3. Show log 查看日志 9 3.3.4. Export 导出 11 3.3.5. Revision graph 版本树显示 12 3.3.6. Check out 检出 13 3.3.7. Refresh 刷新 13 3.3.8. Delete 删除 14 3.3.9. Rename 对目录或文件进行改名 14 3.3.10. Copy to working copy 把当前目录拷贝到本地 15 3.3.11. Copy to 拷贝到 16 3.4. 客户端操作 17 3.4.1. 客户端的基本操作 17 3.4.2. 常用功能介绍 20 3.4.3. 分支与合并 23 4. SVN API 25 4.1. 使用API 25 4.2. URL和路径需求 27 4.3. 使用C和C++以外的语言 27 4.4. 代码样例 28 4.4.1. 使用版本库层 28 4.4.2. 使用Python处理版本库层 35 4.4.3. 一个Python状态爬虫 40 4.5. 参考资料 45 引言 目的 为了对配置管理工具(Subversion,以下简称为SVN)应用过程提供指导，编制此指南. 范围 本规范适应于北京高伟达软件技术有限公司内部使用 SVN基础知识 SVN简介 SVN 是一具开源的版本控制系统，SVN 将文件存放在中心版本库里，这个版本库很像一个普通的文件服务器，不同的是，它可以记录每一次文件的修改情况。 这样我们就可以籍此将数据回复到以前的版本，并可以查看的更改细节。也就是说，一旦一个文件被传到SVN 上面，那么不管对它进行什么操作，SVN 都会有清晰的记录，即使它在N 天前被删除了，也可以被找回来。所以，许多人将版本控制系统当作一种神奇的“时间机器”。 SVN特性 版本化目录 SVN 实现的“虚拟”版本化文件系统可以跟踪目录树的变更。也就是说，在SVN 中，文件和目录都是版本化的。 真实的版本历史 由于实现了文件和目录的版本化，SVN 可以记录如文件拷贝和改名这些常见操作带来的版本变更，即在SVN 中，对文件或目录都可以进行增加、拷贝和操作，并有版本历史记录。 原子提交 一系列相关的更改，要么全部提交到版本库，要么一个也不提交，这样用户就可以将相关的更改组成一个逻辑整体，防止出现部分修改需另一部分未修改的情况提交到版本库中。 可选的网络层 SVN 在版本库访问的实现上具有较高的抽象程度，利于人们实现新的网络访问机制。SVN 可以作为一个扩展模块嵌入到Apache 之中，这种方式在稳定性和交互性方面有很大的优势，可以直接使用服务器的成熟技术----认证、授权和传输压缩等。此外，SVN 自身也实现了一个轻型的、可独立运行的服务器软件。这个服务器使用了一个特定的协议，这个协议可以轻松用SSH 封装。我们目前选用的是SVN 自身的服务器，即Svnserver 方式，本文主要是对Svnserver 方式的使用方法介绍。 一致的数据操作 SVN 用一个二进制差算法描述文件和变化，对于文件（可读）和二进行制（不可读）文件其操作方式是一致的。这两种类型的文件压缩存储在版本库中，而差异信息则在网络上双向传递。 高效的分支和标签操作 在 SVN 中，分支与标签操作的开销与工程的大小无关，SVN 的分支和标签操作是一种类似于硬链接的机制拷贝整个工程。因而这些操作通常只会花费很少且相对固定的时间。 可修改性 SVN 没有历史负担，它以一系列优质的共享C 程序库的方式实现，具有定义良好的API。 SVN的架构 SVN的基本应用 客户端的安装 点击Yes,重启电脑，完成安装。 版本库浏览 Repo-browser 完成安装之后,点击鼠标右键,会出现下图,这是SVN的基本功能,下面一一介绍. 点击Repo-browser之后，会出现下面的小对话框： 在里面输入你要键接的版本库: 输入方法为：https://服务器IP:端口号/所在版