基于TortoiseSVN客户端的SVN用户手册.doc

svn 安装及使用说明书 1 中国民航总局第二研究所中国民航总局第二研究所 信息分公司信息分公司 软件配置管理软件配置管理 基于基于 tortoisesvntortoisesvn 客户端的客户端的 svnsvn 用户手册用户手册 v1.0.0(v1.0.0(版本号版本号) 中国民航总局第二研究所中国民航总局第二研究所 20102010 年年 0808 月月 svn 安装及使用说明书 2 修改历史修改历史 2009-6svn 服务端安装及使用说明书 2010-7-29基于 tortoisesvn 客户端的 svn 用户手册 2010-8-4部分文字修改 svn 安装及使用说明书 3 目录目录 1.编写目的编写目的4 2.tortoisesvn 的主要功能特点的主要功能特点4 3.术语术语4 4.安装安装5 4.1.系统环境要求5 4.2.tortoisesvn 客户端安装.5 5.tortoisesvn 基本操作基本操作6 5.1.vpn 使用说明.6 5.2.连接服务器上的配置库8 5.3.在线修改用户密码10 5.4.新增和提交文件12 5.5.修改和提交文件15 5.6.删除文件、修改文件名18 5.7.创建分支和标签19 5.8.合并（merge）21 5.9.解决冲突23 6.状态图标说明状态图标说明24 svn 安装及使用说明书 4 1.编写目的编写目的 阐述在 windows 操作系统下，基于 tortoisesvn 客户端的用户的使用方 法。 2.tortoisesvn 的主要功能特点的主要功能特点 tortoisesvn 是 windows 下的一种 subversion 客户端。 tortoisesvn 是 subversion 版本控制系统的一个免费开源客户端，可以超 越时间的管理文件和目录。文件保存在中央版本库，除了能记住文件和目录的 每次修改以外，版本库非常像普通的文件服务器。你可以将文件恢复到过去的 版本，并且可以通过检查历史知道数据做了哪些修改，谁做的修改。这就是为 什么许多人将 subversion 和版本控制系统看作一种“时间机器” 。 3.术语术语 branchesbranches（分（分 支）支） 可以创建一个分支离开开发的主线来添加一个新特性，而不必影响主线的 稳定，或者你可以创建一个分支用来发布 bug 修正，而新的开发发生在不 稳定的主干。在 svn，分支是使用“廉价的复制”实现的。 tagstags（标签）（标签） 给一组文件取的符号名称，每个都有一个特定的版本号。可以把标签看着 项目仓库切片，标记其中的每一件东西。在 svn 中要打一个标签，只需要 把代码拷贝到项目的 tags 目录中。标签只是分支在特定时刻的一个简单 拷贝。在 svn，标签是使用“廉价的复制”实现的。 trunktrunk（主干）（主干） 项目开发过程的主线。 版本库版本库 版本库是进行数据存储和维护的中心。版本库既可以由分布在网络上的若 干数据库或者文件组成，也可以存放在用户不需要通过网络就可以直接访 问的某个位置。 版本版本 每当提交一组修改，就会在版本库创建一个“修订版本” ，每个修订代表 了版本库树在历史上某一点的状态，如果希望回到历史，可以回到以前的 修订版本 n。 版本属性版本属性 (revprop)(revprop) 就像文件，版本库的每个修订也可以有属性。一些特殊的修订属性会在修 订版本创建时自动生成，例如: svn:date svn:author svn:log 代表了提 svn 安装及使用说明书 5 4.安装安装 4.1. 系统环境要求系统环境要求 tortoisesvn 可以运行在 win2k sp2，winxp 或更高的版本， tortoisesvn 1.2.0 以后不再支持 windows 98, windows me 和 windows nt4， 但是如果需要的话，你仍旧可以下载以前的版本。安装时，必须有系统的管理 员权限；如果没有系统管理员 权限，就只能为当前用户安装。 . tortoisesvn 客户端安装客户端安装 1.安装客户端软件 交的时间，提交者和日志信息。这些属性可以编辑，但是这些属性都不是 版本控制的，所以任何修改都是永久的，不可回退的。 基础版本基础版本 (base(base revision)revision) 当前工作副本里的文件或目录的基础版本。是文件或目录最后被检出、更 新或者提交时的版本。基础版本通常和 head 版本不一致。 添加添加 向工作副本中增加文件或者目录。在提交的时候新的项就会被加入到版本 库中。 检出检出在空目录中，通过从版本库下载版本控制的文件来创建本地工作副本。 提交提交将本地修改的内容传递回版本库，创建一个新的版本库修订版本。 复制复制 在 subversion 服务器版本库，可以创建一个文件或整个目录树的副本， 这是通过“廉价复制”实现的，看起来很像链接到原来的位置，几乎不占 用任何空间。创建一个保存历史的副本，这样可以跟踪副本之前的修改。 更新更新 将最新的修改从版本库下载到工作副本，合并其他人的修改和工作副本的 本地修改。 删除删除 当删除了一个版本控制的条目(并且提交这个修改)，这个条目将不会存在 于版本库以后的修订。但它还是存在于版本库的以前的修订版本里，如果 必要，你可以复制一个删除的条目回来，并且保持所有的历史。 锁锁 当一个版本控制条目的被锁定，就是将它在版本库里标示为不可提交，只 有作出锁定的工作副本可以提交。 合并合并 这个过程会查看版本库添加到工作副本的的修改，而不会破坏本地的修改， 有时候这些修改可能不会自动的结合，也就是冲突了。 在更新工作副本时会自动合并，也可以使用 tortoisesvn 的合并命令从另 一条分支进行合并。 冲突冲突 当版本库的修改合并到本地修改，有时候修改发生在同一行，这种情况下， subversion 不能自动决定使用文件的那一行，在提交之前，需要手工编辑 文件解决冲突。 svn 安装及使用说明书 6 1)双击图标，按提示一步步往下安装。安装完成后重新启动计算机。 2)在任意空白处点击右键，右键菜单会增加两项，表示安装成功。 注：客户端安装程序请向质控部索取。 5.tortoisesvn 基本操作基本操作 . vpnvpn 使用说明使用说明 1. 浏览器地址栏中输入 4:10443/，如下图所示，出现安 全提示框，点击“是”按钮。 svn 安装及使用说明书 7 2. 出现 vpn 登陆界面，输入用户名密码。如下图所示： 3. 点击左上侧的激活 ssl-vpn 通道模式。如下图。 4. 右下角出现登陆成功提示框。如下图所示：vpn 连接成功。现在就可以正常 访问公司内部部分服务器啦！ svn 安装及使用说明书 8 . 连接服务器上的配置库连接服务器上的配置库 1.在硬盘上创建一个空的文件夹，取名为 aiis（深圳 t3 航班信息集成系） 。 千万不要放任何文件进去！ 2.选中空文件夹“aiis” ，鼠标右键选择 svn checkout 弹出对话框。 svn 安装及使用说明书 9 注：“url of repository”是服务器地址： 0:2222/svn/szx/trunk/aiis_2010；“checkout directory”为本地目录地址；其它设置不变。 3.点击“ok” 弹出对话框，输入你的用户名和密码。把复选框勾上保存密 码，下次连接就不用再次输入了。 4.点击“ok” ，进入对话框，取服务器文件到本机，如果文件数量太大就需 等待几秒钟，取完文件后点击“ok”退出。 svn 安装及使用说明书 10 5.完成前四步后，就成功将服务器上的目录结构和文件取到本机上了，本 地工作副本成功创建，本地机上的文件夹状态如下图。 . 在线修改用户密码在线修改用户密码 打开浏览器，在浏览器栏中输入项目项目地址，例如深圳项目集成系统 0:2222/svn/szx/trunk/aiis_2010 出现以下界面： svn 安装及使用说明书 11 点击左上角的“修改密码”，即可在网页的最上部弹出一个修改密码的表单： 输入密码信息之后，点击“确认修改”，即可实现密码修改功能。如果信息有 误，则会提示相应的信息： svn 安装及使用说明书 12 这些提示信息都是在 ini 文件里定义的。修改密码成功后，提示信息会显示操 作成功。 . 新增和提交文件新增和提交文件 向工作副本中增加文件或者目录。在你提交的时候新的项就会被加入到版 本库中。 1.在本地文件夹（连接上服务器的文件夹）里新建一个文件（从其他地方拷 贝过来的文件一样） ，文件状态为。 2.选中文件，点击右键选择“tortoisesvn”“add” ，添加文件。文件状 态变为。 3.选中文件，点击右键选择“svn commit” ，在“message”中写明提交原因， 选中提交文件，点击“ok” 。 svn 安装及使用说明书 13 4.弹出对话框，点击“ok” ，文件提交成功。文件状态变为。 svn 安装及使用说明书 14 恭喜你！完成这四部后，你新增的文件成功提交到了数据库。 . 修改和提交文件修改和提交文件 1.在修改文件的时候记得先同步服务器库，因为别人有可能修改和提交了 新的东西和版本。选中要修改的文件，点击右键选择“svn update” ，如 下图。弹出对话框，点击“ok” ，完成和服务器同步。 2.锁定要修改的文件，右键点击“tortoisesvn”“get lock.” ，弹出 对话框，点击“ok” ，锁定文件完毕。文件状态改变成有锁状态。 svn 安装及使用说明书 15 注释：如果没有锁定文件就修改文件，文件状态会变成红色叹号。 3.现在可以修改文件了，修改完后提到服务器上面。选中文件，点击右键 选择“svn commit”然后弹出对话框，点击“ok” ，文件提交服务器完 毕。 svn 安装及使用说明书 16 4.释放锁定文件如下。选中文件，右键选择“tortoisesvn”“release svn 安装及使用说明书 17 lock”弹出对话框，点击“ok” ，文件锁被释放。文件状态改变。 恭喜你！完成这四部后，文件成功修改并提交到了数据库。 . 删除文件、修改文件名删除文件、修改文件名 当删除了一个版本控制的条目(并且提交这个修改)，这个条目将不会存在 于版本库以后的修订。但它还是存在于版本库的以前的修订版本里，如果必要， 你可以复制一个删除的条目回来，并且保持所有的历史。删除本地副本时，服 svn 安装及使用说明书 18 务器上的文件依然存在，下次更新本地副本时，被删除文件同样会更新下来； 只有删除服务器上的文件才能彻底删除，下次更新本地副本时就不会在有此文 件。 1.在空白处点击鼠标右键，选择“tortoisesvnrepo-browser” ，如下 图操作。弹出 url 服务器地址输入框，输入服务器地址，点击 ok。 2.点击 ok 后，弹出如下对服务器项目的操作界面，我们可以在上面修改 文件名字、删除文件等操作如下两图。 svn 安装及使用说明书 19 . 创建分支和标签创建分支和标签 1.选择要创建分支或标签的文件，点击右键选择“tortoisesvn branch/tag” ，操作如下图。 2.弹出如下界面，from wc at url指主干上准备创建分支标签的文件 路径；to url将要在哪里创建分支标签的文件路径；head revision in repository数据库最新版本；specific revision in repository 选择要对哪个版本创建分支标签；working copy工作复制；log svn 安装及使用说明书 20 message写明创建分支标签的原因、人员、时间等相关信息。如果 选上 switch working copy to new branch/tag，以后修改了分支标签的工作 副本，提交时也自动提交到主干了。然后点击 ok。 3.点击 ok 后，弹出如下对话框，在点击 ok，分支标签就建立好了。 4.分支标签成功建立，如下图 . 合并（合并（mergemerge） 分支用来维护独立的开发支线，在一些阶段，你可能需要将分支上的修改 合并到最新版本，或者将最新版本的修改合并到分支。 svn 安装及使用说明书 21 这里建议不要使用合并，svn 只能高版本向第版本合并，低版本向高版本 合并会发生冲突。svn 只支持文件夹合并，不支持单个文件合并。 1.打开分支文件，在空白处右键点击 tortoisesvnmerge。 2.弹出对话框 merge type，选择类型 merge to different trees，点击 next。 3.弹出如下对话框，from url:填写主分支的 url（意思是要合并到主分支去） ， revision：填写建立分支的版本；to url：填写主分支的 url（意思是要合 并的分支） ，直接选择 head revision。让后点击 next。 svn 安装及使用说明书 22 4.弹出如下对话框，test merge 测试是否可以合并成功。如果能够合并成 功，点击 merge，合并完成。 . 解决冲突解决冲突 冲突的原因冲突的原因：有时当从版本库中更新文件时，有时会有冲突。冲突出现的 svn 安装及使用说明书 23 原因是在本地的修改和版本库中的版本修改的地方重叠了，也就是说两个开发 人员修改了文件中相同的几行。这个就需要你自己手工去解决了。当冲突发生 时，要注意如果修改的文件的内容很多，需要先备份一下本地文件。 tortisesvn 冲突的标志冲突的标志：在冲突的文件上会有一个三角标志，里面有一个 感叹号。 tortisesvn 冲突的解决冲突的解决：首先找到冲突文件，右击会出现 tortoisesvn 的选 择列表。选择“编辑冲突”，你