团队作业Week14
零
- 如果你的团队来了一个新队员，有一台全新的机器，你们是否有一个文档，只要设置了相应的权限，她就可以根据文档，从头开始搭建环境，并成功地把最新、最稳定版本的软件编译出来，并运行必要的单元测试？（在这过程中，不需要和老队员做任何交流）
团队在初期书写了一份文档，用于指导其它成员搭建环境，并放在统一管理文档的坚果云下。
若有新成员加入，只需在坚果云中开放其权限，新成员即可通过该文档搭建和团队其它成员一致的环境。(该文档是Alpha开发中期转至Android Studio开发时书写)
截图如下：
壹
- 你的团队的源代码控制在哪里？用的是什么系统？如何处理文件的锁定问题？
- 场景：程序员果冻正在对几个文件进行修改，实现一个大的功能， 这时候，程序员小飞也要改其中一个文件，快速修复一个问题。怎么办？
- 一个代码文件被签出 (check out) 之后，另一个团队成员可以签出这个文件，并修改，然后签入么？有几种设计，各有什么优缺点？
- 例如，签出文件后，此文件就加锁，别人无法签出；或者，所有人都可以自由签出文件
我们用git控制代码版本。
代码签入签出的加锁方式有以下几种：
|
方式 |
优点 |
缺点 |
|
A签出后，A签入前，B无法签出签入 |
保证A工作的正确性，及不受干扰 |
他人无法修改版本，团队工作效率低 |
|
A签出后，A签入前，B可以签出，但无法签入 |
保证A工作的正确性，及不受干扰，B也能同时开始其它开发工作 |
B的任务提交受到阻碍，B如遇到紧急情况无法灵活处理。 |
|
A签出后，B可以自由签出签入 |
模式灵活，可以适应各种开发需求，团队开发效率高 |
各版本直接的提交无序，可能耗费大量时间用于处理合并冲突，如：一些解决了小bug的版本可能必须merge加入大量功能的新版本，并处理冲突。 |
对于该问题中的场景描述，在我们的版本控制中，我们会让小飞和果冻进行沟通，让果冻尽量在小飞快速解决完bug后提交，减少用于代码合并的时间。
贰
- 如何看到这个文件和之前版本的差异？ 如何看到代码修改和工作项 （work item），缺陷修复 （bug fix) 的关系。
- 场景： 程序员果冻看到某个文件被修改了，他怎么看到这个文件在最近的修改究竟改了哪些地方？
- 场景： 程序员果冻看到某个文件在最新版本被改动了100 多行， 那么和这100多行对应的其他修改在什么文件中呢？ 这个修改是为了解决哪些问题而作的呢？ 那些问题有工作项 （work item，issue），或者bug 来跟踪么？
上述场景中遇到的问题可以通过如下操作进行解决。
首先打开Git@OSC页面找到项目的仓库，然后从版本中找到提交记录，点击提交记录就可以看到历史commit版本
找到想要查看的历史版本点击其对应的哈希值，进入该版本commit时所做的所有修改
我们可以看到文件变化的概览，再向下拉就可以看到所有修改过的文件和之前版本的差异。粉红色为之前的版本，蓝色为当前的版本，非常直观。
Git@OSC中提供了一个Issues板块，其主要功能是创建新的issue然后指派给制定人员，让其对issue进行解决或响应，该issue可以是bug，也可以是enhancement等等。
不过我们没有找到这个板块和代码修改之间的联系，所以我们决定使用在工作项板块中更加成熟的TFS来进行项目的管理，至于工作项和修改的代码之间的联系，我们只能通过commit的备注来进行联系。
叁
- 如果某个文件在你签出之后已经被别人修改，并且签入了，那么你在签入你的修改的时候， 如何合并不同的修改（merge)? 你用了什么工具来帮助你？
Git可以方便地对有简单不同的修改进行合并，但对于有逻辑冲突的部分将会给出conflict的提示，这时需要手工修改。
同时Android Studio本身也支持Git管理，针对文件的不同状态（modified、untrack、conflict等）给出不同的颜色提示。
肆
- 你有20个文件都是关于同一个功能的修改，你要如何保证这些文件都同时签入成功（修改的原子性），或者同时签入不成功？
- 场景： 程序员果冻要签入 20 个文件，他一个一个地签入， 在签入完5 个 .h 文件之后， 他发现一些 .cpp 文件和最新的版本有冲突，他正在花时间琢磨如何合并... 这时候， 程序员小飞从客户端同步了所有最新代码， 开始编译， 但是编译不成功 - 因为有不同步的 .h 文件和 .cpp 文件！ 这时候， 别的程序员也来抱怨同样的问题，果冻应该怎么办？
在Git中，所有在本地仓库中修改的文件都要统一经过commit为新的本地版本后，再push至远程分支。这保障了本地修改提交的原子性，同时git服务器远程提供的修改操作也具有原子性。这样就保障了整体修改的原子性。
伍
- 你的PC 上有关于三个功能的修改，但是都没有完成，有很多文件处于半完工的状态，这时你要紧急修改一个新的 bug，如何把本地修改放一边，保证在干净的环境中修改这个 bug, 并成功地签入你的修改 --- changelist management。
针对这个问题，最笨但是直接的方法就是将远程工程clone到本地，然后在另一个git仓库中修改bug。然而，若前期用到了分支，即本身正在进行的大范围修改是在一个分支中进行的，那么可以新建一个branch，先将当前的branch放一边，在新的branch中reset到前一个版本，再进行修改和commit。
陆
- 如何给你的源代码建立分支？
- 场景：你们需要做一个演示，所以在演示版本的分支中对各处的代码做了一个临时的修改， 同时，主要的分支还保持原来的计划开发。 你们怎么做到的？ 在演示之后，演示版本的有些修改应该合并到主分支中，有些则不用，你们是怎么做到的？
- 场景： 你们的软件发布了，有很多用户，一天，一个用户报告了一个问题，但是他们是用某个老版本，而且没有条件更新到最新版本。 这时候，你如何在本地构建一个老版本的软件，并试图重现那个问题？
首先为了演示fork一个新的分支保存演示版本代码，并且为了演示做的代码修改只会push到演示分支，而对于master分支的开发计划正常，进行只需要将原来的开发代码push到master分支即可。
演示之后进行合并分支操作。
$ git merge branchname
这个命令把分支"branchname"合并到了当前分支里面。
如有冲突（冲突——同一个文件在远程分支和本地分支里按不同的方式被修改了），在有问题的文件上会有冲突标记，手动按自己的需求修改有冲突文件的代码，在你手动解决完冲突后就可以把此文件添加到索引(index)中去，用git commit命令来提交，就像平时修改了一个文件一样。
$ git add file $ git commit
在执行合并命令即可。
根据用户报告的老版本的版本号，因为对每个发布版本都会建立一个分支保存其代码，检查git仓库中的历史发布版本中所包含的版本号，找到对应的commit记录以及hash值。
然后在本地
$ git clone
该分支，再使用
$ git reset --对应的版本hash值
命令退回到有bug的版本，修补该bug
柒
- 一个源文件，如何知道它的每一行都是什么时候签入的，为了什么目的签入的 （解决了哪个任务，或者哪个bug）？
- 场景： 一个重要的软件忽然出现崩溃的情况， 程序员果冻经过各种debug手段，发现问题是在某一个文件中有一行代码似乎显然出了问题，但是这个模块被很多其他模块调用，这行代码是什么时候，为了什么目的，经过谁签入的呢？如果贸然修改，会不会导致其他问题呢？ 怎么办？
这张图代表的是某一处的提交记录中，都做了哪些改动，并且对每个文件的改动，都做出了前后对比。
结合上面的三张截图我们就能够知道有疑问的文件来自哪次修改，这次修改是由哪位团队成员进行的，并且在修改前后，相关文件的变化对比情况，这样我们就能够确定存在问题的代码，每一行的签入记录，至于签入的理由，我们也能够由实际进行签入的同学，由他进行前后的对比来回忆出进行修改的理由与目的。
捌
- 如何给一个系统的所有源文件都打上标签，这样别人可以同步所有有这个标签的文件版本？
- 代码每天都在变， 有时质量变好，有时变差，我们需要一个 Last Known Good （最后稳定的好版本） 版本， 这样新员工就可以同步这个版本， 我们如果需要发布，也是从这个版本开始。那么如何标记这个 Last Known Good 版本呢？
关于这一点，我们团队中的刘彦熙同学深有体会，在一次提交记录中，他疏忽地提交了一份有问题的代码，在发现解决当前存在的问题会花很长时间并且意义不大后，他决定要将当前的最终版本回滚到上一次能够稳定运行的版本。于是他打开了提交记录
由于在每次提交后面都附带了一些信息，这些信息虽说不是固定的能够表示源文件质量情况的标签，但是能够在一定程度上起到类似于标签的作用，通过与之前提交的同学沟通，很快，就将之前提交过的版本下载下来，重新提交，并以此作为当前的最终稳定版，解决了之前所犯下的错误。
玖
- 你的项目的源代码和测试这些代码的单元测试，以及其他测试脚本都是放在一起的么？ 修改源代码会确保相应的测试也更新么？你的团队是否能部署自动构建的任务？
- 在签入之前，程序员能否自动在自己的机器上运行自动测试，以保证本地修改不会影响整个软件的质量？
- 在程序员提交签入之后，服务器上是否有自动测试程序， 完成编译，测试，如果成功，就签入，否则，就取消签入？
- 团队是否配置了服务器，它自动同步所有文件，自动构建，自动运行相关的单元测试，碰到错误能自动发邮件给团队？
团队中并未采用自动测试的框架，git上也未支持。测试都是在本地由负责各个模块的组员手动完成的。团队中要求了各个组员在完成任务merge后，必须保证当前代码变编译通过，能够运行，并且通过人工测试后才能push。
