团队作业Week16

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

   我们的团队留有必要的文档，但不是每一个细节都花大量笔墨描述——所以只要新队员有充分的经验和正常的智力水平，是能够复现系统的（我们无法教会一个0基础的人布置这个系统)

1. 你的团队的源代码控制在哪里？用的是什么系统？如何处理文件的锁定问题？
   场景： 程序员果冻正在对几个文件进行修改，实现一个大的功能， 这时候，程序员小飞也要改其中一个文件，快速修复一个问题。怎么办？
   一个代码文件被签出 (check out) 之后，另一个团队成员可以签出这个文件，并修改，然后签入么？
   有几种设计，各有什么优缺点？
   例如，签出文件后，此文件就加锁，别人无法签出； 或者， 所有人都可以自由签出文件

   我们的团队源代码控制使用git，代码仓库位于github，我们在协作中约定尽量以文件为单位，即每个文件有一个主要负责人，一般这个文件由该负责人编写更新，所以避免了上述情况的发生。如果另一个人需要修改文件，可以让负责人修改，抑或确定负责人暂时不修改该文件的前提下，再修改该文件(通常是由于负责人没有时间才采取这个行为）

2. 如何看到这个文件和之前版本的差异？ 如何看到代码修改和工作项 （work item），缺陷修复 （bug fix) 的关系。
   场景： 程序员果冻看到某个文件被修改了，他怎么看到这个文件在最近的修改究竟改了哪些地方？
   场景： 程序员果冻看到某个文件在最新版本被改动了100 多行， 那么和这100多行对应的其他修改在什么文件中呢？ 这个修改是为了解决哪些问题而作的呢？ 那些问题有工作项 （work item，issue），或者bug 来跟踪么？

   通过github的代码变更提示以及每次commit的文字描述，即可大致了解该次改动的目的

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

   使用git的merge功能，由于已经做出了(1)中所提到的约定，git软件能够自动merge两个人的修改，无需人为merge
   

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

   同(1)，不存在两个人同时修改一个函数中的相同代码。如必须要这样做，说明该文件可一分为二。

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

   直接clone一份已在线的最新可用版本，完成bug的修复，然后push。这样做无需对正在修改的作任何处理

   命令：
   git clone git@github.com:default1406/PhyLab.git
   修复bugs
   git push origin master
   

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

   本项目暂无分支，因为目前均是增量修改。同时，不存在老版本软件，因为本项目是网站项目，所有访问必然是最新的。如果需要保留不同版本，可以使用git新建分支，该分支开发完成后，下一个更新采用新的分支进行，那么如果某老版本出现问题，可以使用该版本的分支修复。
   
   git push origin second

7. 一个源文件，如何知道它的每一行都是什么时候签入的，为了什么目的签入的 （解决了哪个任务，或者哪个bug）？
   场景： 一个重要的软件忽然出现崩溃的情况， 程序员果冻经过各种debug手段，发现问题是在某一个文件中有一行代码似乎显然出了问题，但是这个模块被很多其他模块调用，这行代码是什么时候，为了什么目的，经过谁签入的呢？如果贸然修改，会不会导致其他问题呢？ 怎么办？

   手动查阅该变更前后的commit内容以及commit的说明
   

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

   建立一个分支。操作同(6)

9. 你的项目的源代码和测试这些代码的单元测试，以及其他测试脚本都是放在一起的么？ 修改源代码会确保相应的测试也更新么？你的团队是否能部署自动构建的任务？
   在签入之前，程序员能否自动在自己的机器上运行自动测试，以保证本地修改不会影响整个软件的质量？
   在程序员提交签入之后，服务器上是否有自动测试程序， 完成编译，测试，如果成功，就签入，否则，就取消签入？
   团队是否配置了服务器，它自动同步所有文件，自动构建，自动运行相关的单元测试，碰到错误能自动发邮件给团队

   本项目采取了自动部署到开发服务器、手动部署到发布服务器的模式，由于发布间隔比开发提交的间隔要长，因此手动发布（手动运行发布脚本）也是可行的。测试程序与代码源文件一同发布，所有成员共享。但是目前测试不能够自动化进行，只能逐个测试运行，发布到服务器上也不会自动进行测试。对于本项目这个自动化测试不是十分必要。