20181113-1 版本控制报告

此作业要求参见：https://edu.cnblogs.com/campus/nenu/2018fall/homework/2380

 

项目名：弾球学成语

组名：杨老师粉丝群

组长：乔静玉

组员：吴奕瑶、公冶令鑫、杨磊、刘欣、刘佳瑞、卢帝同、张宇

 

一、回答问题

问题：

 

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

 

回答：

       没有，我们并没有准备这样一个文档。因为Alpha阶段实现功能有限，有新成员加入的话，通过老队员的指导（仅需一名老队员即可），就能快速（此处快速指新队员加入团队后，第一次每日例会当天）使新队员了解在此之前各个队员完成了哪些功能。至于源代码，组长会迅速把新队员的coding.net账号添加到我们的项目中（此处快速指新队员加入团队后，第一次每日例会当天），新队员可自由拖拽全部代码。题目要求的文档我们团队会尽快制作出来，在对项目的了解过程中，新老队员可以共同探讨研究。

 

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

 

回答：

          团队项目在 coding.net 上进行托管，采用 git 的方式进行版本控制。

          使用 win7 及以上系统。

          团队文件不会锁定，每个组员可自由签入和签出。这样既保证了项目开发的效率，也便于组内成员相互交流。

 

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

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

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

          

回答：

       TortoiseGit 可以查看某个文件的版本变更。如图所示菜单的前3个菜单项主要用于将该版本的文件与其他版本进行对比（查看具体做过哪些修改、修改部分会以高亮显示）。

 

 

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

 

回答：

      Git可以对有简单不同的修改进行自动合并，但对于有逻辑冲突的部分将会给出conflict的提示，这时需要手动解决冲突。

 

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

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

 

回答：

        团队尚未出现过这种情况。Git 本身就可以保证签入时的原子性，此外签入前尽量与组内队员进行协商。

 

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

 

回答：

        此时需要在本地建立一个新分支，在新分支上修复新 bug。

 

6、规范操作和自动化

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

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

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

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

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

 

回答：

        目前还没有。在以后的开发中会进行尝试。

 

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

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

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

 

回答：

         在coding.net 上可以构建新分支。

           本地都构建老版本 可以用 Git 进行版本回退。

 

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

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

 

回答：

       最后签入时会有commit的记录保留，在此可以知道是什么时候签入的。签入时会有标签注释，可知道签入目的。

      此外 coding.net 上会有每人每次的提交记录。

 

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

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

 

回答：

       可以在 Last know Good版本时建立分支，需要的时候从最后一个Last know Good版本导出，以此作为最终稳定版。

       此外还可以通过大家在每日立会时的讨论确定哪一个为 Last know Good版本。

 

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

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

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

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

 

回答：

       本项目还没有进入到测试阶段。

      

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

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

 

回答：

         Github是一个非常万能的工具。首先，他可以作为一个版本控制系统和协作工具，用它来发布工作。用GitHub，你可以将项目存档，与其他人分享交流，并让其他开发者帮助你一起完成这个项目。优点在于，他支持多人共同完成一个项目，因此你们可以在同一页面对话交流。缺点在于，Github操作复杂，如果你是Github新手，首先的挑战就是摆正心态——需要不断实践和时间。且国内的用户经常遇到访问速度太慢的问题，有时还会出现无法连接的情况。

  

         Coding.net 的有点在于操作简单，除了托管外，还能进行团队协作。缺点在于稳定性不高，可能会出现 http 错误码，导致效率降低。

        

         码云的优点在于提供免费的Git仓库。此外，还集成了代码质量检测、项目演示等功能。对于团队协作开发，码云还提供了项目管理、代码托管、文档管理的服务，5人以下小团队免费。缺点在于超过5人就要收费，因为是所有项目累计，所以一定程度上有点像是免费版本不支持多人协同开发了。

 

 

 

二、报告

 

1、α阶段以及β阶段（第一周）checkin次数记录

α阶段checkin次数记录
日期	乔静玉	吴奕瑶	刘佳瑞	公冶 令鑫	杨磊	杨金铭	张宇	卢帝同
2018.10.16	0	0	0	0	0	0	0	0
2018.10.17	0	0	0	0	0	0	0	0
2018.10.18	0	0	0	0	0	0	0	0
2018.10.19	0	0	0	1	0	0	0	0
2018.10.20	1	0	0	0	0	0	0	0
2018.10.21	2	0	0	0	0	0	1	0
2018.10.22	0	0	0	0	0	0	0	1
2018.10.23	0	0	1	0	0	0	0	0
2018.10.24	0	1	0	0	0	0	0	0
2018.10.25	0	0	0	0	0	1	1	0
2018.10.26	0	0	0	0	0	2	0	0
2018.10.27	1	0	0	0	1	0	0	1
2018.10.28	0	0	0	0	0	0	0	0
2018.10.29	1	0	0	0	0	0	0	0
2018.10.30	0	0	0	0	0	0	0	0
2018.11.1	0	0	0	0	0	0	0	0
β阶段（第一周）checkin次数记录
日期	乔静玉	吴奕瑶	刘佳瑞	公冶 令鑫	杨磊	刘欣	张宇	卢帝同
2018.11.14	0	0	0	0	0	0	0	0
2018.11.15	0	0	0	0	0	0	0	0
2018.11.16	0	0	0	0	0	0	0	0
2018.11.17	0	0	0	1	1	0	0	0
2018.11.18	0	0	0	0	0	0	1	0
2018.11.19	0	0	0	0	0	0	0	1
2018.11.20	0	0	0	0	0	0	0	0

 

 

2、checkin log

时间	人员	message	所属功能
Oct 19 20:56:35	wuyy694 （吴奕瑶）	Initial commit	在coding.net上建立远程仓库，并将小组成员加入其中；建立新的分支
Oct 19 22:52:35	gongylx （公冶令鑫）		游戏界面功能实现
Oct 20 22:13:49	Qiaojingyu（乔静玉）	背景音乐	设置界面功能实现
Oct 21 00:53:26	Qiaojingyu（乔静玉）	背景音乐	设置界面功能实现
Oct 21 00:58:29	Qiaojingyu（乔静玉）	更新	设置界面功能实现
Oct 21 21:54:57	_Zy （张宇）	更新背景BUG	主界面功能实现
Oct 22 22:15:41	luditong （卢帝同）	更新Start按钮	主界面功能实现
Oct 23 19:01:10	Ljr6899 （刘佳瑞）	小球加文字功能	游戏界面功能实现
Oct 24 22:41:24	Wuyy694 （吴奕瑶）	成语变换	游戏界面功能实现
Oct 25 00:41:13	_Zy （张宇）	开始界面更新	主界面功能实现
Oct 26 23:33:05	Jimmy （杨金铭）	关于我们	“关于我们”界面功能实现
Oct 27 13:52:11	luditong （卢帝同）	更新游戏界面背景+修改小球碰壁bug	主界面功能实现 游戏界面功能实现
Oct 29 22:02:45	Qiaojingyu（乔静玉）	Alpha	主界面功能实现 游戏界面功能实现 设置界面功能实现 “关于我们”界面功能实现
Nov 17 00:02:05	gongylx （公冶令鑫）	add music	添加背景音乐
Nov 17 22:35:15	yanglei749 （杨磊）	修改背景音乐	更改游戏界面图 添加背景音乐
Nov 18 14:47:02	_Zy （张宇）	增加暂停功能（pause）	添加暂停功能
Nov 19 12:48:57	luditong （卢帝同）	更新暂停	添加暂停功能

 

3、小组成员代码量贡献

（1）数据表

小组成员	实际代码量（行）
吴奕瑶	482
乔静玉	309
张宇	217
公冶令鑫	212
卢帝同	209
杨磊	174
杨金铭	139
刘佳瑞	23

 

（2）饼状图