首页 > 代码库 > 版本控制报告

版本控制报告

0.在吹牛之前,先回答这个问题: 如果你的团队来了一个新队员,有一台全新的机器, 你们是否有一个文档,只要设置了相应的权限,她就可以根据文档,从头开始搭建环境,并成功地把最新、最稳定版本的软件编译出来,并运行必要的单元测试? (在这过程中,不需要和老队员做任何交流)

如果我们团队来了一个新队员,我们会有相应的文档以及配置,他可以根据文档进行环境搭建,以及运行相应的单元测试。(最终解释权归团队所有)

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

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

    一个代码文件被签出 (check out) 之后,另一个团队成员可以签出这个文件,并修改,然后签入么?

   有几种设计,各有什么优缺点?

   例如,签出文件后,此文件就加锁,别人无法签出或者所有人都可以自由签出文件

在这个场景下,可以划分优先级,

如果小飞要修复的问题需要马上立刻更新补丁,那么,小飞应该直接签入修改的文件,发布完以后,果冻先备份自己写好的文件,然后把小飞签入的文件更新到本地,然后在本地将自己备份的文件和更新的文件进行merge即可。

签出文件后,此文件就加锁,别人无法签出:

这种情况,可以保证每个人获取的文件版本是最新的,也不会产生修改冲突。但是这种方式花费的时间相对要长一些,因为其他人要等签出这个文件的人签入完毕以后才能签出下来进行修改。

所有人都可以自由签出文件:

所有人都可以自由签出文件,这种情况大家各自修改自己需要修改的模块,但是到合并代码的时候,需要人工Merge,这种方式风险会大一些,特别是同一个人修改一个文件涉及到相同函数的修改。

我们小组的源代码采用coding进行版本控制,采用win7系统 。

2. 如何看到这个文件和之前版本的差异?如何看到代码修改和工作项work item),缺陷修复bug fix) 的关系。

   场景: 程序员果冻看到某个文件被修改了,他怎么看到这个文件在最近的修改究竟改了哪些地方? (例子)

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

对于场景一:

有很多开发工具都自带有提交历史的功能,对于文件的提交历史以及提交修改可以查看到,如github,可以查看代码提交的历史,登录github进入项目,在左侧工具栏选择代码,页面右上角处,点击提交历史即可查看代码提交历史。如图:

  

技术分享

 

 技术分享

对于场景2的情况:

通过查看提交时候的comment来确定这次提交的修改原因是什么。Bug和功能列表通常在另外一个系统记录,对于100多行的修改一起签入的其他修改,在团队开发采用svn可以查看相关修改的文件以及修改原因,也就是在team中有一个资源记录。

 技术分享

 技术分享

 

3. 如果某个文件在你签出之后已经被别人修改,并且签入了,那么你在签入你的修改的时候, 如何合并不同的修改(merge)? 你用了什么工具来帮助你?

 通常我会备份本地自己开发的一份代码,先把别人签入的代码更新到本地,然后在本地手动合并修改,我会采用Beyond Compare(文件夹和文件对比工具。使用他可以很方便的对比出两个文件夹或者文件的不同之处。并把相差的每一个字节用颜色加以表示,查看方便并且支持多种规则对比)关于它的链接:http://www.scootersoftware.com/download.php

 技术分享

 

 

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

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

通常如果是我的话,我肯定会在签入之前先查看处理相关冲突的文件。Eclipse和Apache的Subsversion有一个与资源库同步的功能,这个功能可以显示有冲突的文件(用红色标注),在签入的时候,先把冲突文件更新下来,与本地自己要签入的文件进行一轮merge,然后再把20个文件一起签入即可。  

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

我会先备份本地修改的整个工程,然后把工程还原稳定的版本然后进行修改bug并签入,最后通过 Beyond Compare 工具来对比本地备份的版本和最新的版本,并合并。

6. 规范操作和自动化

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

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

    - 代码复审 (要有别的员工的名字)

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

    请问你的团队有这样的自动化工具让开发者方便地一次性填入所有信息然后提交么?  (高级功能, 代码提交之后, 相关bug 的状态会改动为  “fixed”, 并且有链接指向这次签入。)

我们的团队单元测试采用的是jUnit,目前团队没有一次性填入所有信息的自动化工具。

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

    场景:你们需要做一个演示,所以在演示版本的分支中对各处的代码做了一个临时的修改, 同时,主要的分支还保持原来的计划开发。 你们怎么做到的? 在演示之后,演示版本的有些修改应该合并到主分支中,有些则不用,你们是怎么做到的?

    场景: 你们的软件发布了,有很多用户,一天,一个用户报告了一个问题,但是他们是用某个老版本,而且没有条件更新到最新版本。 这时候,你如何在本地构建一个老版本的软件,并试图重现那个问题?

场景1:

我们团队使用的github,首先打开分支,然后有条件的控制合并分支以及主分支。

场景2:

需要在本地新建一个分支,然后回滚到相应用户所使用的老版本。在github中可以采用git log 命令来 查看历史提交记录。可以通过git reset—hard和哈希值来回滚指定的版本。回溯分支前采用的是branch -a

8. 一个源文件,如何知道它的每一行都是什么时候签入的,为了什么目的签入的 (解决了哪个任务,或者哪个bug)?

   场景: 一个重要的软件历经几年,几个团队的开发和维护,忽然出现在某个条件下崩溃的事故, 程序员果冻经过各种debug手段,发现问题是在某一个文件中有一行代码似乎显然出了问题, 但是这个模块被很多其他模块调用,  这行代码是什么时候,为了什么目的,经过谁签入的呢?  如果贸然修改, 会不会导致其他问题呢?  怎么办?

如果之前的开发时采用github来开发的,可以采用git blame命令,来查看代码是什么时候,为了什么目的,经过谁签入的呢? 以及签入人是谁。

9. 如何给一个系统的所有源文件都打上标签,这样别人可以同步所有有这个标签的文件版本?

   代码每天都在变, 有时质量变好,有时变差,我们需要一个 Last Known Good (最后稳定的好版本) 版本, 这样新员工就可以同步这个版本, 我们如果需要发布,也是从这个版本开始。  那么如何标记这个 Last Known Good 版本呢? 

我认为通常系统上线发布,会有备份每一个版本的源代码以及发布包,无论是Last Known Good稳定的版本还是处于不稳定,都会有相应的备份。

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

    在签入之前,程序员能否自动在自己的机器上运行自动测试,以保证本地修改不会影响整个软件的质量?

    在程序员提交签入之后,服务器上是否有自动测试程序, 完成编译,测试,如果成功,就签入,否则,就取消签入?

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

  源代码和测试时分开的,单元测试以及测试脚本是放到一起的。修改源代码会进行相应的更新。签入前,程序员可以自驾运行测试。不会影响整个软件质量。团队是配置好服务器的,运行相应的单元测试。

作业题,分析比较各种软件构建环境:

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

  • github
  • 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)
  • 自己搭建系统

github优点:功能设计简洁实用上手很快,可用性好在哪里都可以获得代码,提交而且pull requestissue都是比较好用的。

github缺点:费用太高了对于企业,对于个人国内访问速度太慢,经常出现connect time-out,不能很好的解决GB2312/GBK,中文不够友好。

Coding.net 优点:面向中国码农,主打团队,项目协作,私有库免费

缺点:限制协作人数

Visualstudio优点:可以直接创建窗口,开发速度快。

缺点:界面设计没有充分考虑空间占用、输出显示过于单调、代码行定位功能不如Eclipse

版本控制报告