使用VSTS的Git进行版本控制(六)——拉取请求
在将代码合并到主干之前,拉取请求让团队对特性分支的更改提供反馈。审阅人可以通过建议修改留下评论,并投票批准或拒绝代码。
任务1:在Visual Studio的Team Explorer中创建拉取请求
1.在Visual Studio中打开Team Explorer,进入Branches页面。签出dev分支。如果没有分支,创建一个。
2.打开01_Demos_ASPNET5解决方案
3.展开MyHealth.API项目,进入Controllers文件夹,修改任何一个控制器文件,同步变更推送提交,从其他分支拉取变更。
4.现在,变更会更新到远程开发分支。
5.打开Team Explorer Home页面
6.从Team Explorer 面板打开Pull requests。从开发分支提交变更到主干。
7.选择New Pull Request连接打开浏览器窗口,在web上创建一个新的拉取请求。
8.可以关联工作项并描述在分支上的变更,以便其他人更容易地看到你正在尝试解决的问题。还可以添加评审人员。
9.点击New Pull Request创建一个新的拉取请求。将会看到概述。可以批准、添加评论或做其他的更多操作。
任务2:管理拉取请求
在web上的Code视图中的Pull Requests选项卡,管理自己的或分配给你的拉取请求。
1.在web上查看repo,打开Pull Request视图。选择Active,以显示当前repo的所有有效的拉取请求。还可以通过选择Completed(已完成的)或Abandoned(放弃的)拉取请求,拉取已关闭的拉取请求历史记录。
2.选择已分配给你的任一拉取请求。Overview选项卡显示该拉取请求的当前状态。
3.查看标题、描述和讨论,以了解所建议的更改,并查看其他评审人员提出的问题。
4.选择Files选项卡,以查看请求的源和目标分支之间的最大更改的差异。
5.从All changes下拉菜单中,查看已推送到拉取请求的源分支以前版本的代码。每当在Team Services中更新分支时,在下拉菜单和Updates选项卡中就会添加一个新版本到列表中。
6.找到要添加新注释的文件。
7.在拉取请求中添加注释提出建议,回复之前的评论,和指出修改建议的问题。
8.可以更改Tree视图查看源代码的结构或仅列出文件。还可以查看所有评论/活动评论/隐藏评论。
9.使用Updates选项卡浏览作者的更改列表。
10.可以在Commits选项卡中选择和查看在分支中提交的更改。
11.返回到Files选项卡。点击comments,查看修改后的文件的详情和评论者的评论。
新评论从Active(活动)状态开始,可以使用评论中的下拉菜单更新为:
Active:评论仍在评审中。
Resolved:评论中提出的问题已经解决。
Pending:评论中的问题将被处理,但是还没有被修复。
Won’t Fix:注意评论中的建议,但是不在这个拉取请求中做出更改来解决它。
Closed:该评论的讨论已关闭。
12.在拉取请求视图的右上角单击Approve。
默认选项是Approve,但是可以从下拉菜单中选择其他选项:
Approve with suggestions:同意拉取请求,提供可选的建议以改进代码。
Waiting for the author:不批准更改,请作者评审该评论。当已经解决了关注点,在重新检查代码后,作者应该让你知道,。
Rejected:更改不被接受。如果以这种方式投票,应该在拉取请求中留下评论,详细说明拒绝更改的原因。
13.在拉请求视图的右上角单击Complete。
14.输入用于合并提交的信息,并在接下来的对话框中更新拉取请求描述。可以选择压缩合并拉取请求,并在合并完成后删除源分支。
Squash merging是一个合并选项,当完成一个拉取请求时,允许压缩主题分支的Git历史。与主题分支上的每个提交都添加到默认分支的历史中不同,squash merge会将所有文件更改添加到默认分支上的单个新提交中。squash merge使默认分支历史保持干净,并且易于追溯,而无需要求团队进行任何工作流更改。