SOP_CM_V1.0(SVN管理和使用作业指导书).doc

文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 05 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 SVN 管理和使用作业指导书管理和使用作业指导书 修改记录 日期版本作者 修改者描述审核人 2008 04 28V0 1林蓉初稿生成 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 目录目录 1目的目的 3 2SVN 管理管理 3 2 1库的建立 3 2 2SVN 库目录结构规划 3 2 3版本库的管理原则 4 2 4代码受控原则 4 2 5增加用户 5 2 5 1参与人员 5 2 5 2操作流程 5 2 6新增项目 6 2 6 1参与人员 6 2 6 2操作流程 6 2 7删除用户 6 2 7 1参与人员 6 2 7 2操作流程 6 3SVN 使用使用 7 3 1安装后的常规设置 7 3 1 1中文界面的设置 7 3 1 2忽略文件 7 3 1 3配置强制锁定文件 8 3 2常用 SVN 操作 8 3 2 1创建和使用工作副本 checkout 8 3 2 2设置文档和目录的属性 10 3 2 3加锁与解锁 10 3 2 4分支操作 12 3 2 5合并操作 13 3 2 6将别人的改动更新到你的工作拷贝 13 3 2 7解决冲突 14 3 2 8比较差异 Diff 14 3 2 9加入 Add 新文件 新文件夹 15 3 2 10删除 重命名 移动 15 3 2 11取消改变 revert 16 3 2 12修订日志窗口 17 3 2 13送交committing 18 3 2 14文件库浏览器The Repository Browser 19 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 1目的目的 本作业指导书规范应用软件开发部各项目开发中 SVN 使用和管理工作的内容和 流程 2SVN 管理管理 2 1 库的建立库的建立 运行 Subversion 服务器需要首先要建立一个版本库 Repository 可以看作 服务器上存放数据的数据库 在安装了 Subversion 服务器之后 可以直接运行 如 svnadmin create E svndemo repository 就会在目录 E svndemo repository 下创建一个版本库 我们也可以使用 TortoiseSVN 图形化的完成这一步 在目录 E svndemo repository 下 右键 TortoiseSVN Create Repository here 然后可以选择版本库模式 这里使用默认即可 然后就创建了一 系列目录和文件 一般选择 FSFS 2 2 SVN 库目录结构规划库目录结构规划 A 参考了国外一些主要的开发网站 如 SourceForge 大同小异 类似这样的 目录结构 SVN 库 tags 发布 1 1 rc1 1 2 1 5 1 9 trunk 主版本 project src classes WEB INF branches 分支 分支 主要的开发工作放在 trunk 分支放在 branches 发布版本放在 tags B 多项目情况 ProjectManagement 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 trunk branches tags SSO trunk branches tags ProjectManagement 和 SSO 是两个项目 trunk 是开发的主线代码 存放能够运 行的正确的代码 程序员如果开发新的程序或者改 bug 一般要先 branch SVN 的一个功能 trunk 目录下的代码到 branches 目录的一个子目录 在那里对代码 进行修改 确认无误后再提交到 trunk 主线下 但是有的时候为了效率 我们也多 人都在 trunk 目录下开发项目 tags 目录可以看做主线代码的快照 比如你做了 1 0 又做了 2 0 那每个不同版本的代码你就做快照放到 tags 文件夹下了 2 3 版本库的管理原则版本库的管理原则 1 版本库的管理原则 2 项目负责人和版本管理员负责架构项目目录结构 包括配置文件 第三 方控件 文档 3 项目负责人分配开发人员目录权限 由版本管理员负责实施 权限分 配粒度要细 4 trunk tags branches 项目负责人 协同版本管理员构建 tags 和 branches 5 项目负责人指定版本计划 版本管理员根据版本计划 提前通知开发人 员提交文档 并告知冻结时间 6 版本管理员负责解决开发人员在开发过程中的有关版本问题 7 开发人员每次修改 或者新增 删除 拷贝工作区对象后 应该立刻提 交到版本库 有效保持工作区与资源库的高度一致 每天下班之前提 交 更新 8 开发人员在每次修改工作区中代码或者文档时 首先更新该对象 可以 尽量减少冲突 合并 9 保证提交到的版本库的代码没有 BUG 以免影响开发组 可以适当利用 加锁机制 减少冲突 10 版本管理员根据计划线表 冻结开发库 并通知文件化负责人制作新的 版本 11 文件化负责人负责软件的测试版 构建测试环境 branches 由版本管 理员进行 checkout 12 项目负责人和版本管理员负责发布软件的发布版 13 版本管理员负责清理有关不需要的 branches tags 2 4 代码受控原则代码受控原则 以下类型的文件不需要受控到 SVN obj 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 idb pdb exp ilk pch res ncb suo user Debug Ankh Load 提交 commit 时 需要说明提交的 LOG 有相对应的 ticket 需要在 log 上写 上 ticket xx 2 5 增加用户增加用户 2 5 1 参与人员参与人员 SVN 管理员 新用户 2 5 2 操作流程操作流程 1 进入进入 http 192 168 9 129 trac Application wiki 启动 SVN 并用 Admin 管理员密码登录 2 点击按钮 左侧出现 选择 User 3 Username 统一采用姓 名声母的缩写 两个字的是全拼 三个字的是 姓全拼 名的首字母 比如 林蓉 linrong 郭妍华 guoyh 以能从 User name 看出实际用户 命名统一为标准 Password 输入密码 123 4 进入http 192 168 9 129 config application access conf 设置新增 用户在各个项目目录的权限 注 r read 读权限 rw read write 读写权限 5 权限确认 6 启动 SVN 客户端 并使用新增加的帐号和密码登录 确认用户已添加 7 修改配置文档 config config ini 给新增用户添加员工机器人修改信 息提示 8 通知用户 您的 SVN 帐号如下 Username linrong Password 123 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 登录http 192 168 9 129 trac Application prefs account 即可修 改用户密码 权限配置参考 http 192 168 9 129 svn application 99 日常管理 01 标准文 档 SVN 权限列表 xls 2 6 新增项目新增项目 2 6 1 参与人员参与人员 SVN 管理员 项目开发者 项目组长 2 6 2 操作流程操作流程 1 SVN 管理员了解要建立的项目名称 项目开发者和项目组长 2 启动 SVN 客户端 并用管理员帐号登录 3 在 下新建项目 退出 4 进入进入 http 192 168 9 129 trac Application wiki 启动 SVN 并用 Admin 管理员密码登录 5 点击按钮 左侧出现 选择 User 添加项目所有者和项目组长 6 修改配置文档 config config ini 给新增用户添加员工机器人修改信 息提示 7 通知项目开发者和组长 新建了 SVN 项目目录 NewProject 项目组员 ProjectMember 项目组长 ProjectLead 权限配置参考 http 192 168 9 129 svn application 99 日常管理 01 标准文 档 SVN 权限列表 xls 2 7 删除用户删除用户 2 7 1 参与人员参与人员 SVN 管理员 被删除用户 项目组长 下任项目所有者 可能有多个 2 7 2 操作流程操作流程 1 删除前要提醒该用户 项目组长 把所负责的项目中 check out 的内容 check in 2 进入http 192 168 9 129 config application access conf 检查此用 户拥有 Check out 权限的项目目录 3 启动 SVN 客户端 用该用户名和密码 123 登录 4 进入进入 http 192 168 9 129 trac Application wiki 启动 SVN 并用 Admin 管理员密码登录 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 5 点击按钮 左侧出现 选择 User 选择要删除的用户 删除此用户 3SVN 使用使用 3 1 安装后的常规设置安装后的常规设置 3 1 1 中文界面的设置中文界面的设置 将 TortoiseSVN 的操作语言设置为中文 点击 TortoiseSVN Settings 进行相 应的常规设置 3 1 2 忽略文件忽略文件 为防止在提交操作时将不必要的文件上传到 SVN 服务器上 可将项目 中不需要受 SVN 控制的文件和文件夹通过设置忽略选项的方式排除掉 常 被忽略的文件有 obj db resharper Load pdb bak 可以根据 实际需要来修改忽略参数 每个需要忽略的文件 文件夹 名称之间用空 格作分隔符 需要忽略的文件夹只要写文件夹名称就行 例如 obj 忽略 obj 文件夹及所包含文件 忽略所有 下划线 开头的文件夹及所包含 文件 注意 这个设置仅对本机有效 而且对本机的所有项目的本地工作 区有效 对其他项目组成员没有影响 被忽略的文件仍可以通过 添加 命令使其受 SVN 控制 操作界面如下图 只需将忽略参数填写在 全局忽略模式 后的文本 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 框中即可 3 1 3 配置强制锁定文件配置强制锁定文件 点击上图中的 设置 在打开的文件中找到 enable auto props yes 删除此行前面的所有 号 然后再找到 auto props 在后面添加一行 如图 表示所有类型的文件都自动上锁 3 2 常用常用 SVN 操作操作 3 2 1 创建和使用工作副本 创建和使用工作副本 checkout 为了获得一份工作副本 我们必须先 check out 仓库中的某一个子目录 check out 事实上只是简单的创建一份工作副本而已 例如 我们来 check out 一个 calc 项目的工作副本 Subversion 的档案库借助不同方法得到 本地磁盘 网络协议等 例 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 http build 88 prj template http build 88 prj template Dist 注 http build 88 是 Apache 设置的 URL prj 是通过 Apache 设置的位置 template 是档案库名称 Dist 是目录名 在资源浏览器中选定将要存放工作目录的拷贝 右键弹出快捷菜单 选择 SVN Checkout 将出现对话框 如果该目录已在版本控制下 则没有取出而是 更新 Update 和送交 Commit 如果文件夹不存在 会自动创建 注意 你只能将文件取出到一个空目录里 如果你想取出刚导入的文件 Subversion 将报错 你只能将文件取出到另一个目录或先删除已经存在的源文 件再执行取出 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 2 设置文档和目录的属性设置文档和目录的属性 右击文件 或目录 属性 选择 Subversion 页可以设置文件的属性 目前版本 可以设置如下属性 svn eol style 文档的结束符 svn executable 可执行文件 svn keywords 作者 日期等信息 svn needs lock 锁定后才能修改 锁定前为只读 常用 svn mime type mime 格式的文档 设置文档的属性 设置目录的属性 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 3 加锁与解锁加锁与解锁 加锁 右击要锁定的文档或目录之后选择 Get lock 注意 右击目录的话 默认是锁定目录下的所有文件 可以根据需要选择需要 锁定的文档 解锁 右击要锁定的文档或目录之后选择 Release lock 注意 右击目录的话 默认是解锁该目录下的所有加锁文件 可以根据需要选 择需要解锁的文档 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 4 分支操作分支操作 利用分支操作 可以很轻松的保存不同版本的文档 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 5 合并操作合并操作 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 Svn 提供 2 种 merge 方式 Merge 同一个目录的不同版本 一般用于误操作 导致覆盖了别人的文档文档时 将被覆盖的文档与最新版的 文档 merge Merge 分支 一般用于多个工程集成开发时 将开发分线上的 Release 版本 merge 到开发主 线的目录下面 3 2 6 将别人的改动更新到你的工作拷贝将别人的改动更新到你的工作拷贝 有时你想将他人的改动合并到你本地的工作拷贝 从服务器上取改动到本 地 的过程叫更新 updating 更新也许是单个文件 或选择的一组文件 或整个 目录 在资源浏览器中选择待更新的文件或目录 右键并选择更新 update 他人的修改将合并到你本地的文件中 你所做的改动保存在同一文件中 这 时档案库没有受变化 即合并只在本地进行 如果你和他人改动的是相同部分但改动不一样 就会在更新过程中产生冲 突 conflicts 冲突在对话框中用红色表示 冲突的文件图标将出现标志 双 击后用外部编辑器解决冲突 TortoiseSVN 也允许你将工作拷贝更新到指定版本 用更新至版本 Update to Revision 命令 在弹出的对话框中输入指定的版本号即可 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 7 解决冲突解决冲突 选择的文件 点击鼠标右键菜单中选择 编辑冲突 Edit Conflict 来打 开合并工具或冲突编辑器 做一些必要的修改 然后保存文件 然后选择菜单 中的 已解决的 Resolved 命令执行 接着提交 commit 修改到仓库 注意 命令 已解决的 Resolved 并没有真正的解决冲突 它只不过是 把 文件名称 扩展名 mine 和 文件名称 扩展名 r r 中星号代表任 意位数字 即版本号 删除 并允许你提交修改而已 因此 建议在有冲突发 生时要先执行 编辑冲突 Edit Conflict 再执行 已解决的 Resolved 如 果确信自己的修改是正确的 不需要保留他人的修改 可将文件名称 扩展名 mine 去掉 mine 后缀 并把 r 后缀的文件和 的文件删除 然 后正常 提交 Commit 版本库中将保存自己的版本 3 2 8 比较差异比较差异 Diff 本地工作区 修改后 被修改的文件出现标志 选择 比较差异 Diff 命令 可以查看该文件与版本仓库中文件具体差异 选择命令后出现对 应的差异察看窗口 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 3 2 9 加入加入 Add 新文件新文件 新文件夹新文件夹 想把在开发过程中创建的新文件 文件夹加入到 SVN 控制之下 可以这样 做 选中文件 文件夹 在新文件 文件夹所在父文件夹点击右键 然后在菜单 中选择 添加 Add 命令 不需要受 SVN 控制的文件请取消钩选 在把文件或文件夹加入到控制之下后 这些文件或文件夹就会显示为一个 Added 覆盖图标的样子 接下来必须对 本地工作区 执行提交 commit 操作 以便其他团队成员能够看到这些文件或文件夹 3 2 10 删除 重命名 移动删除 重命名 移动 选择要删除 或重命名 的文件 文件夹 点击鼠标右键选择相应命令 如果使用 TortoiseSVN 的 删除 Delete 操作删除了一个文件 文件夹 文 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVersion V0 1 时间时间Date 2009 04 28 应用软件部 件就已经从 本地工作区 中删除了 而被 删除 Delete 的文件夹将显示为 覆盖图标 要恢复被 删除 Delete 文件 文件夹 只需对他的上级文件夹 进行 SVN 还原 revert 操作即可 如果要在 本地工作区 内移动文件 可以使用鼠标来拖拽 1 选中要移动的文件或文件夹 2 用鼠标右键拖拽他们到 本地工作区 中一个新的文件夹 3 松开鼠标右键 4 在跳出的菜单中选择相应命令 如下图 如果一个删除操作不是使用 TortoiseSVN 的 删除 Delete 操作完成的 而是就像平常删除文件那样删除的 提交时 对话框窗口还是会显示这些删除 的文件 并提示自己把它们从版本控制下删除 所以如果忘记使用 TortoiseSVN 删除 Delete 操作来删除这些文件 仍可在这里补上 3 2 11 取消改变取消改变 revert 如果要取消对一个文件 文件夹所做的修改 只需用鼠标右键单击该文件 文件夹 选择 TortoiseSVN SVN 还原 revert 在操作窗口中会显示需要还原 的文件 文件夹 勾选文件 文件夹后按下 确定 OK 按钮即可 注意这里所做 的取消修改只能返回到该文件 文件夹上次 更新 Update 后的状态 文档名称文档名称 Name 配置管理计划作业指导书作者作者Author林蓉 文档编号文档编号 Num SOP CM 03 版本号版本号 VersionVe