版本控制报告

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

　　没有，我们的开发环境相对简单，只要在coding.net我们团队的公开项目中下载α发布版本的源码，并安装新版本的java JDK， 并下载Myeclipse就能运行，而这一开发环境已经在前面发布的博客相关文档中给出过了。无法保证不需要任何交流，但是可以保证只需短暂的交流就能完成环境的搭建和软件的编译。在后序开发过程中，我们会考虑编写文档解决这个问题。

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

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

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

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

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

 

　　我们采用coding.net进行源代码控制，使用windows系统，TortoiseGit进行本地相关操作

　　通过查阅资料，个人对于这两种签出的理解是：

　　优缺点：签出文件后，文件就加锁：优点是有效避免冲突的发生，可以保证修改的正确性。

　　　　　　　　　　　　　　　　　　而缺点是一个人修改时其他人无法签出，会影响其他人修改的效率。

　　所有人可以自由的签出文件：优点是可以保证团队编写的效率和灵活性

　　　　　　　　　　　　　　　缺点是整合更加困难，修改了小bug的版本可能会影响到实现了大功能的版本。

　　通过讨论，我们认为我们更适合使用第一种方式进行签出，这样可以尽量避免出现冲突的问题，对于没有经验的团队更友好，因为解决问题会花费更多的时间。在实际项目中，如果出现上述问题，我们会先等大功能完成，再进行小bug的修改，最后由负责的同学对代码进行整合。

 

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

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

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

 TortoiseGit提供了这样的功能，可以对比版本间的差异。

 对于第二个场景，我们没有太好的办法解决这个问题，都是通过团队成员之间及时的沟通。通过详细的注释来说明修改的目的或许是一个比较好的办法，我们会在以后的工作中进行尝试。

 

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

　　

　　同样是使用 TortoiseGit，先对比最新版本中修改的部分，在自己的版本中加入这些修改，然后签入你的版本。在项目目前的阶段，我们通过将修改的部分传递给负责代码整合的同学，由她做修改的签入工作。

 

　　

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

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

　　我们的项目目前没有出现这一问题，我们会通过沟通在代码整合完成之前不能获得最新的版本。如果以后出现了这样的问题，解决的方法可能是新建一个分支，在分支中进行代码的签入，而其他人会同步修改前的版本直到签入全部成功。

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

　　在coding.net的帮助文档（https://coding.net/help/doc/practice/git-principle.html#stash）中，我们找到了这样的解决方案。

　　

stash

有时，我们在一个分支上做了一些工作，修改了很多代码，而这时需要切换到另一个分支干点别的事。但又不想将只做了一半的工作提交。在曾经这样做过，将当前的修改做一次提交，message 填写 half of work，然后切换另一个分支去做工作，完成工作后，切换回来使用 reset —soft 或者是 commit amend。

git 为了帮我们解决这种需求，提供了 stash 命令。

stash 将工作区与暂存区中的内容做一个提交，保存起来，然后使用reset hard选项恢复工作区与暂存区内容。我们可以随时使用 stash apply 将修改应用回来。

使用TortoiseGit，可以在未完成的工作上右键——>TortoiseGit——>保存贮藏。

想要回到原来的环境中，选择弹出贮藏。

　　

6. 规范操作和自动化

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

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

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

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

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

　　我们没有这样的自动化工具可以一次性填入所有信息然后提交。

 

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

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

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

　　

　场景一：在coding.net上新建一个演示用分支，对演示用的分支做临时修改，同时主分支继续开发，最后演示完毕后合并分支，出现冲突由负责人进行判断并修改。

　场景二：目前还没有遇到这样的问题，但是通过搜索找到了解决的办法。

　1. 选择tortoisegit  ---> 显示日志　

　

    2. 选择想要回退的版本， 选择重置master到这个版本

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

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

　　

　　同样通过查看日志的方式可以看出文件是什么时候由谁签入的，修改了哪些部分，对于我们的项目来说，可以直接与本人取得联系。

 

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

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

 

　　

　　右键--->创建标签，可以为版本创建标签，将经过测试的稳定的版本标记为Last Known Good 即可。

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

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

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

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

 

　　并没有如此完备的测试系统。

 

11.

作业题，分析比较各种软件构建环境：

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

• 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与coding.net都有着非常强大的版本控制的功能，在我使用的过程中都能满足我的需求，但是github的访问速度慢而coding.net更加友好。

报告

报告Alpha阶段2周中，项目的版本控制情况，包括未在coding.net的部分。

包括不限于

check in (不是push)次数

check in log(时间、人员、message、动机、其他解释)

每位队员的代码贡献量，代码的作用

每位队员的代码贡献量比例

 check in 次数大概在30次左右。

 

coding地址：https://git.coding.net/clairewyd/toReadSnake.git