Alpha版——版本控制报告（Thunder）

Part One

回答问题：

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

答：

如果我们的团队来了新的队员，有一台机器，我们没有一个文档，教他重新搭配环境，并成功地把最新、最稳定的版本软件编译出来。但我们的组员都很热心，可以教他完成上述步骤。

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

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

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

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

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

答：

我的团队版本控制的源代码在coding.net上，用的是windows或MAC，我们会对源代码和文档进行多份备份，如在u盘、手机、电脑的E盘。当多个程序员对同一个文件进行修改时，我们应该根据场景和开发任务来决定集成的次序，互相依赖的任务一起集成。我们设置所有人都能自由签出文件，指定规则签入。一个程序员修改其中一个文件的时候，另一个团队成员也可以签出这个文件，并修改。但团队成员不能直接签入，大家一起签入到邮件或者群里。
对于一个人签出文件后，此文件就被加锁，别人无法签出的情况，限制了代码的共享性，但保护了源文件的信息不会破坏。
对于所有人都可以自由签出文件的情况，大家可以充分达到文件共享，在代码和文档上添加自己的idea，可以发挥更多的想法和价值，但是有可能破坏源文件。

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

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

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

答：

使用GIT这个强大的版本控制的软件可以很方便的查看GIT库文件夹中，相应文件的修改历史信息。首先在GIT库的文件夹的空白处右键选择Git GUI Here。

如下图所示：

接着在打开的窗口的右上角的菜单栏中选择Visualize All Branh Histoy。在此窗口中可以看到详细的修改内容的作者以及修改时间，同时可以点击修改的文件看到详细的修改代码部分，同时也可以看到修改作者标注的修改意图以及想要修复的bug。

利用好GIT这款版本控制软件可以方便的对代码修改的作者、时间、内容、意图进行查看，这样可以在团队完成项目时大大提高了协同效率。

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

答：

如果文件在自己签出以后已经被别人修改并且签入，那么在签入自己对文件最新的修改的时候，就要用到GIT工具来合并不同的修改。在GIT库文件夹的空白处右键，选择Git Bash Here

如下图所示：

如果在提交的时候存在冲突，git status可以告诉我们冲突的文件，可以通过直接查看冲突的文件并且根据git的标记内容可以进行相应的修改，之后再做提交。

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

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

答：

在conding上创建分支，或者在tortoisegit创建分支，让任何一位开发者都能在他人的代码基础上进行自己部分的独立开发，然后将所有的分支合并到一个分支上，但是这样面临的风险也是有的，多个分支同时合并时如果出现了比较大的冲突，合并起来必须小心翼翼。

创建分支：

                                       

合并分支：

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

答：

通过查阅tortoisegit帮助文档知道stash的使用方法：

当你想记录的当前状态的工作目录和索引,但想回到一个干净的工作目录中,右键单击一个文件夹,弹出上下文菜单,然后选择命令TortoiseGit→储备保存的地方,会出现一个对话框,你可以选择进入这个状态的一个消息。

6.规范操作和自动化

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

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

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

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

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

答：

我们开发使用Android Studio自动化工具，方便代码的复审和运行单元测试，但没有代码提交相关bug自动更改fixed的高级功能。

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

场景：你们需要做一个演示，所以在演示版本的分支中对各处的代码做了一个临时的修改，同时，主要的分支还保持原来的计划开发。你们怎么做到的？在演示之后，演示版本的有些修改应该合并到主分支中，有些则不用，你们是怎么做到的？场景：你们的软件发布了，有很多用户，一天，一个用户报告了一个问题，但是他们是用某个老版本，而且没有条件更新到最新版本。这时候，你如何在本地构建一个老版本的软件，并试图重现那个问题？

答：

场景一：当代码突然需要临时紧急修改时，可以先创建一个bug分支，然后在此分支上进行修改，同时主分支继续开发，当bug分支修改完毕后，合并分支，就修改完毕了。

场景二：每个版本都会进行版本控制，所以当需要修改老版本时，直接切换到老版本的记录下载下来进行修改就可以了。

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

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

答：

查看commit信息，就可以看到什么时间什么人员为什么签入的。

可以建立分支，来进行修改。

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

代码每天都在变， 有时质量变好，有时变差，我们需要一个 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 request功能和issue用起来很方便。

缺点：对于企业费用有点高，对于个人访问速度略慢，会出现类似connect time-out的问题。中文实现的不是很好。

Coding.net 优点：适用于中国程序员，中文好，适合团队合作，私有库是免费的。

缺点：合作人数有限制。

Visualstudio优点：直接创建窗口，速度快。

缺点：界面设计不合理，没用充分利用好空间大小。输出显示过于简单，定位功能不强。

Part Two

报告

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

包括不限于check in (不是push)次数  check in log(时间、人员、message、动机、其他解释)  每位队员的代码贡献量，代码的作用  每位队员的代码贡献量比例

答：

（1）各成员代码量、代码作用及所占比例

成员	代码量	代码作用	比例
代秋彤	109	欢迎页切换	3%
王航	454	书架设计	9%
李传康	962	本地文件操作	19%
胡佑蓉	1951	阅读文件操作	38%
苗威	323	背景颜色切换	6%
邹双黛	281	屏幕亮度调节	5%
杨梓瑞	375	本机书籍导入	7%
宋雨	693	阅读进度和显示操作	13%

（2）代码提交情况

（3）提交次数

由上图可知提交在coding.net上的次数为11次

所有成员在自己电脑上的总次数约为70次

（4）提交地址

地址链接：https://git.coding.net/lick468/iReader.git