现代软件工程讲义 源代码管理

【现代软件工程课件】

源代码管理   -- 以实践促进学习

移山软件学院的学生果冻问老师： 为啥须要源代码管理? 我本身写代码多爽，别人要，就用QQ 传过去好了。

老师问：原始人怎么建房子？

果冻：或者找一个洞，或者本身挖一个洞，上面搭个棚子挡雨...

老师问：现代人怎么建房子？

果冻：那就要有楼房，固然还要搭脚手架，还要升降机，起重机，等等工具。

老师问：若是原始人穿越到如今，要盖房，是否能够不要脚手架，你们直接搬砖从一楼砌墙，而后站在一楼砌二楼，而后站在二楼砌三楼... 砌到十楼么？

果冻：这有不少问题：

　　- 人力搬砖效率底下，人的体力有限，必须有工具帮忙。

　　- 若是墙砌歪了，没有人来看，砌到五楼才发现从二楼开始就歪了，怎么办？

　　- 现代房屋有各类成型的模块（门框，窗框，各类预制板，各类管道线路），没有工具，光凭人力根本搞不定。

老师：对，咱们须要脚手架，升降机，起重机，水泥搅拌车，各类检测工具来保证一个大楼能顺利建好。 咱们说过，

　　软件 = 程序 + 软件工程

　　软件_的质量 = 程序_的质量  + 软件工程_的质量 

软件工程的质量要靠软件工具和软件流程来保证， 你们看过正在建设中的高楼， 半完工的楼顶上矗立着巨大的塔吊。这个塔吊不是用户需求的一部分 （用户但愿完工的楼房上面没有塔吊！），可是，这是建筑工程上不可缺乏的环节，那么怎么把塔吊顺利地安装上，随着楼房的增高而增高（动画，  迪拜塔的建设），让塔吊高质量地工做，怎么作安全检查，防止它倒下来？ 这就是工程的要求。

软件工程中，也有相似脚手架，塔吊这样的工程系统，工具和流程。 软件的源代码管理工具（source code control system），加上构建系统 （build system）, 能保证一个复杂软件能在多个角色，多个团队的合做下，按时以合适的质量发布。 若是你写一个Hello World 程序， 固然不须要这些工具， 就像你用儿童积木搭房子过家家，你本身高兴，但这不是建筑工程。

 

源代码管理的10 个实践问题：

 

 

源代码管理的重要性无需赘述，可是在实际中，  不少团队都是小和尚念经 - 有口无意。  嘴上说重要，可是实际上仍是经过QQ 传递源代码，或者演示一结束， 源代码马上没有能够工做的版本。  咱们请各个团队举出例子，说明本身是用什么样的源代码系统 (subversion,  CVS, github, TFS, etc) ，如何处理团队开发中可能会遇到的各类问题。若是团队仍是用QQ 传递代码，请说明QQ 如何解决下列的问题。

每一个团队写一个博客，回答下列问题，（每一个回答要加上截屏显示）：

0. 在吹牛以前，先回答这个问题： 若是你的团队来了一个新队员，有一台全新的机器， 大家是否有一个文档，只要设置了相应的权限，她就能够根据文档，从头开始搭建环境，并成功地把最新、最稳定版本的软件编译出来，并运行必要的单元测试？ （在这过程当中，不须要和老队员作任何交流）

 

1. 你的团队的源代码控制在哪里？用的是什么系统？ 如何处理文件的锁定问题？

   场景： 程序员果冻正在对几个文件进行修改，实现一个大的功能， 这时候， 程序员小飞也要改其中一个文件，快速修复一个问题。怎么办？

    一个代码文件被签出 (check out) 以后，另外一个团队成员能够签出这个文件，并修改，而后签入么？

   有几种设计，各有什么优缺点？

   例如，签出文件后，此文件就加锁，别人没法签出；  或者， 全部人均可以自由签出文件

 

 

2. 如何看到这个文件和以前版本的差别？ 如何看到代码修改和工做项 （work item），缺陷修复 （bug fix) 的关系。

   场景： 程序员果冻看到某个文件被修改了，他怎么看到这个文件在最近的修改究竟改了哪些地方？ （ 例子）

   场景： 程序员果冻看到某个文件在最新版本被改动了100 多行， 那么和这100多行对应的其余修改在什么文件中呢？ 这个修改是为了解决哪些问题而做的呢？ 那些问题有工做项 （work item，issue），或者bug 来跟踪么？

 

3. 若是某个文件在你签出以后已经被别人修改，而且签入了，那么你在签入你的修改的时候， 如何合并不一样的修改（merge)? 你用了什么工具来帮助你？

 

4. 你有20个文件都是关于同一个功能的修改，你要如何保证这些文件都 同时签入成功（修改的原子性），或者同时签入不成功？

    场景： 程序员果冻要签入 20 个文件，他一个一个地签入， 在签入完5 个 .h 文件以后， 他发现一些 .cpp 文件和最新的版本有冲突，他正在花时间琢磨如何合并... 这时候， 程序员小飞从客户端同步了全部最新代码， 开始编译， 可是编译不成功 - 由于有不一样步的 .h 文件和 .cpp 文件！  这时候， 别的程序员也来抱怨一样的问题，果冻应该怎么办？

 

5. 你的PC 上有关于三个功能的修改， 可是都没有完成，有不少文件处于半完工的状态，这时你要紧急修改一个新的 bug，如何把本地修改放一边，保证在干净的环境中修改这个 bug, 并成功地签入你的修改 --- changelist management。

 

6. 规范操做和自动化

    你的团队规定开发者签入的时候要作这些事情：

    - 运行单元测试，相关的 代码质量测试。

    - 代码复审 （要有别的员工的名字）

    - 和此次签入相关的issue 编号， 任务/task， 缺陷/bug 编号，等等， 以备查询。

    请问你的团队有这样的自动化工具让开发者方便地一次性填入全部信息而后提交么？  （高级功能， 代码提交以后， 相关bug 的状态会改动为  “fixed”， 而且有连接指向此次签入。）

     例子。

 

7. 如何给你的源代码 创建分支？

    场景：大家须要作一个演示，因此在演示版本的分支中对各处的代码作了一个临时的修改， 同时，主要的分支还保持原来的计划开发。 大家怎么作到的？ 在演示以后，演示版本的有些修改应该合并到主分支中，有些则不用，大家是怎么作到的？

    场景： 大家的软件发布了，有不少用户，一天，一个用户报告了一个问题，可是他们是用某个老版本，并且没有条件更新到最新版本。 这时候，你如何在本地构建一个老版本的软件，并试图重现那个问题？

 

8. 一个源文件，如何知道它的 每一行都是何时签入的，为了什么目的签入的 （解决了哪一个任务，或者哪一个bug）？

   场景： 一个重要的软件历经几年，几个团队的开发和维护，突然出如今某个条件下崩溃的事故， 程序员果冻通过各类debug手段，发现问题是在某一个文件中有一行代码彷佛显然出了问题， 可是这个模块被不少其余模块调用，  这行代码是何时，为了什么目的，通过谁签入的呢？  若是贸然修改， 会不会致使其余问题呢？  怎么办？

 

9. 如何给一个系统的全部源文件都打上 标签，这样别人能够同步全部有这个标签的文件版本？

   代码天天都在变， 有时质量变好，有时变差，咱们须要一个 Last Known Good （最后稳定的好版本） 版本， 这样新员工就能够同步这个版本， 咱们若是须要发布，也是从这个版本开始。  那么如何标记这个 Last Known Good 版本呢？ 

 

10. 你的项目的 源代码和测试这些代码的单元测试，以及其余测试脚本都是放在一块儿的么？ 修改源代码会确保相应的测试也更新么？你的团队是否能部署自动构建的任务？

    在签入以前，程序员可否自动在本身的机器上运行自动测试，以保证本地修改不会影响整个软件的质量？

    在程序员提交签入以后，服务器上是否有自动测试程序， 完成编译，测试，若是成功，就签入，不然，就取消签入？

    团队是否配置了服务器，它自动同步全部文件，自动构建，自动运行相关的单元测试，碰到错误能自动发邮件给团队

 

做业题，分析比较各类软件构建环境：

就像一个厨师要分析各类厨房用具，挑选适合本身的工具组合， 一个软件团队也要挑选适合本身的源代码管理和其余配套工具，请选择至少三种，比较各自的优势缺点，成本：

• github
• https://gitee.com/education 
• http://www.javashuo.com/tag/coding.net 
• code.csdn.net
• gitcafe.com
• www.visualstudio.com
• code.taobao.org
• Visual Studio Team Foundation Server
• gitblit， 在Windows系统下构建 git 服务，带网页端管理…
• Visual Source Safe (VSS)
• 本身搭建系统