fisheye代码评审详细培训教程

-Fisheye代码评审详述目 录一、浏览 Crucible 界面3二、设置用户信息41.Reviews Tab52.Author Mapping Tab6三、角色及状态的改变6四、评审过程81.创立评审92.添加评审113.开场评审134.进展评审135.回复评审146.完成评审171)完成评审的操作172)发送评审197.总结与关闭评审238.删除已取消的评审269.更改评审的工程26五、使用收藏夹301.添加一个评审至我的收藏夹。302.添加一条评审意见至我的收藏夹313.添加一个工程至我的收藏夹314.添加一个用户至我的收藏夹325.添加*个文件或文件夹至我的收藏夹336.添加一个代码库至我的收藏夹337.查看我的收藏夹338.重命名我的收藏项349.删除我收藏夹中的*项35六、Crucible中的快捷键351.常用的快捷键：352.评审意见导航快捷键：363.文件导航快捷键：36一、 浏览 Crucible 界面当你进入Crucible界面，首先看到的就是 Dashboard 界面, 在这下面显示了最近的一些活动SVN提交，评审：截图： Dashboard Crucible界面的说明如下表所示： 标题 功能出现的位置Dashboard Tab显示与你相关的系统活动与审查 所有页面Source Tab显示你连接的源代码库的所有活动只有当FishEYE被用于Crucible时Projects Tab显示具体工程的评审与容所有页面People Tab显示用户所有页面Reviews Tab 显示评审所有页面左侧导航栏导航栏显示在屏幕的左侧面，这里主要显示具体的过滤器。具体过滤元件，请查看左侧导航栏。左边的导航可以隐藏侧面边栏或点击蓝色的information图标显示二、 设置用户信息如果要查看您的用户配置，登陆Crucible，并单击用户菜单显示你的用户名的地，选择Settings项。截图: Settings参照 FishEye documentation文档中关于Display settings, Profile and Email and Watches.1. Reviews Tab如果设置了SMTP server ，Crucible中的活动都会通过发送给相关的人。你可以设置以下选项，来指定在哪个电子将被发送阶段。State change 默认Yes. Crucible通过不同的状态: Draft, Under Review. 当状态改变时就发送. ment added 默认 Yes. 当添加MENT时就发送. Participant finished 默认Yes. 只发送给 Moderator 当所有评审员都 pleted their review. General message 默认Yes.处于Under Review状态的评审员，添加或删除评审时，发送。 My actions 默认 No. 如果设置为 Yes, 你执行的任一项审查活动都会发给你自己。2. Author Mapping TabThe Author mapping 允你们进展关联。用户名可以在不同的仓库中，Crucible会检查用户名是否匹配。三、 角色及状态的改变Roles in CrucibleAuthorCreator/ModeratorReviewerUserStatus Classifications in CrucibleDraftUnder ReviewSummarizedClosedAbandoned DeadCrucible中的角色Author作者作者是主要负责人，是审查结果采取行动的负责人。在绝大多数的情况下，是由评审提出者修改代码。Creator/Moderator创立者/裁判员创立者就是创立一个评审REVIEW。在大多数的情况下，创立者也是裁判员 moderator. 裁判员就是负责评审，和批准审查的人可以创立，下载T*T，发，REOPEN，CLOSE，总结。在审查完毕后，由裁判员来总结和关闭审查。默认情况下，裁判员是创立者。Reviewer评审员评审员可以提出意见，并说明他们完成审查。而裁判员是可以对评审进展评论。User用户可以使用Crucible.Crucible中评审的状态分类Draft草稿Draft 评审是尚未完成或释放到评审中。Under Review正在评审Under Review可以进展评审或等待评审，等待进展总结。SummarizedSummarized 是过去的评审阶段。裁判员仍然可以添加结论或意见。ClosedClosed 是说明这个评审已完成。AbandonedAbandoned 是一个垃圾评审。正在创立的评审必须被放弃才能被删除已创立的评审在任状态都可被删除。四、 评审过程Creating a Review 创立评审Adding Reviewers 添加评审Issuing a Review 开场评审Performing the Review 进展评审，回复评审，完成评审Summarising and Closing the Review 总结关闭评审Deleting an Abandoned Review 删除或取消一个评审Moving a Review to Another Project移动一个评审到另一个工程中1. 创立评审在Crucible中创立评审翻开Reviews Tab，选择屏幕右上角的Tools菜单，然后再选择Create Review.截图: 创立一个评审(创立评审的第一步：以以下图是从FishEYE中创立评审，从Crucible中创立评审请参照上文所示操作步骤。)截图: 选择一个工程创立评审的第二步：选择需要评审的工程截图: Crucible管理文件对话框创立评审的第三步：选择需要评审的文件或容 截图: 在Crucible中创立评审创立评审的第四步：如需要跟Jira中Issues关联，请在Statement of objectives中写上Issues的关键字补充说明：在JIRA中创立评审截图:从JIRA中创立评审2. 添加评审翻开Reviews界面，选择新建的评审，单击右上角的Start Review，开场添加评审。截图: Crucible中新建的评审，该评审的为Draft状态点击Start Review后，为Under Review状态评审员可以随时删除，删除评审员的操作如下：以评审的创立者或裁判员的身份登陆Crucible. 翻开需要更改评审员的评审. 单击Edit Review 按钮:找到要删除的评审员，在旁边的复选框中去掉选择:单击 Save按钮，保存更改. 这个评审员就会从该评审中删除掉，并以的形式通知他. 评审员只能由创立者或裁判员删除.你不能从评审中删除创立者和裁判员.3. 开场评审开场评审：Crucible中被称为开场评审，它意味着评审可以正式开场.只有裁判员才能批准评审开场评审，作者可以推荐评审，而评审员则只能评审这个评审的动作可以在评审未完毕之前的任时候进展。截图: 批准评审请注意，只有作者才能推荐评审，裁判员才能批准评审。 4. 进展评审如查找和管理你相关的评审.浏览你的评审，在 Dashboard一栏中。 浏览所有的评审，在 Reviews 一栏中。 当一个文件在评审的过程中改变时，我们就要决定哪些需要评审。Crucible没有规定如和怎样评审代码。它只是提供了一种机制，记录意见。截图: 代码库版本从 File Outdated菜单，可以选择查看更新的文件的最新版本，或者对这个评审添加最新的版本:截图: File Outdated 菜单5. 回复评审在评审过程中添加评审，也可以回复其别人的评审。截图: 查看现有评审意见增加一条新的评审意见假设要添加评审意见，适用于整个评审，可以选择左边菜单栏中的Review ments，然后单击图标： 假设针对版本/更新来添加评审，可以从左边导航栏中选择这个文件，然后单击图标：要添加一个源代码级的意见，从左侧导航栏中选择这个文件，在源代码视力中，单击一行代码。你可以单击并拖动以选择一行或多行。注释将悬停在最后一行选定的源代码后面。要选择多行，请按住Alt键。回复一条评审, 在该评审的底部单击 Reply按钮. 只有拥有评审权限的用户，才能添加评审.关于flagging defects.截图: 添加评审草稿Draft评审可以将你自己刚创立的评审作为一个草稿.当你完成评审时，系统会提示你 ：是否发送取消编辑你的草稿评审. 截图: 草稿Draft 评审缺陷标识作为被评代码的作者，你可以自己为*行有缺陷的而未被他人评审的代码打上缺陷标识。截图: 缺陷标识6. 完成评审评审员已经对这个代码再也没有任评审的意见时，评审员可以将对这个评审作一个完成标识，以便其它评审员作者裁判员参考。1) 完成评审的操作为了完成评审员自己的评审,可以单击屏幕右上的 plete 按钮,紧挨 Tools 菜单:只有评审员拥有 plete权限.评审员可以设置：当完成评审时，以的式告知裁判员。当评审员完成评审后，评审员仍然可以添加评审，直到裁判员总结了评审；而裁判员总结关闭评审时，不需要所有评审员都完成评审。如果评审员有未完成的评审或草稿评审，当评审员完成评审时，系统会提示该评审员。截图: 草稿Draft评审的提示。截图: 完成评审2) 发送评审你可以将你的评审意见，以形式告知他人。这样可以让他人更快的了解你的评审活动，或监视你的评审活动的容。通过电子发送评审意见。在Crucible中,翻开该评审. 从 Tools 菜单中，选择 Email Review见截图1. 将出现 Recipients页面见截图2: To: 可以输入多个电子，以逗号分隔. Recipients: 你可以输入Crucible实例名，以将他们添加到通讯组. 你也可以简单地选择 Send to Review Participants 复选框，包括所有参与评审的评审员. 单击Ne*t 按钮. 将出现message页面见截图3: 完成相关信息后, 单击Send 按钮. 将出现 Status 页面见截图4,确认是否发送成功. 如果用户没有登陆Crucible，是不能发送的,但是可以以文本形式查看评审意见.截图 1: Email Review截图 2: Recipients 页面截图 3: Message 页面截图 4: 确认是否发送成功7. 总结与关闭评审裁判员可以在任时候对评审进展总结与关闭操作。通常地, 裁判员都是等所有评审员都完成评审后，才进展总结与关闭操作.总结评审：选择屏幕右上角的Summarize按钮. 可以进入评审总结页面. 如果没有评审意见了，单击Close Review 按钮;否则，单击 Continue Without Closing按钮. 截图: Summarize 按钮该图标标识：这个评审还未完成。从上图我们可以看出：Geoff Crain 没有完成评审，因为他旁边还有这个绿色的图标。而这时，裁判员总结或关闭评审，将会看到一些提示信息。 虽然有未完成评审的评审员，但裁判员仍然可以总结或关闭评审。一旦评审成为总结状态，裁判员可以添加评论的摘要，如成果任务等。截图: 总结评审截图:关闭评审这个总结会发送给所有参与者，且在上会显示 close或Reopen按钮.只有裁判员才可以对评审进展总结，其他参与评审者没有这个权限。即裁判员拥有last word权限.处于 Summarize 状态的评审，可以被关闭.处于 Summarize 或 Closed 状态的评审，可以被裁判员 re-opened. 裁判员Re-open评审之后，评审变为 Under Review状态, 这时就允所有参与者对该评审进展评审.我们也可以不用Re-opened一个评审，而是创立一个新的评审，将新评审父评审指向这个评审.8. 删除已取消的评审删除的评审不能被恢复。删除已取消dead的评审，操作如下:从Dashboard页面, 单击左侧导航栏中的My Abandoned Reviews. 将出现一个已取消评审的列表. 单击你想要删除的评审. 将显示这个评审的详细信息,从 Tools菜单中选择 Delete.这个评审就被删除掉了. 截图:在Crucible中删除评审9. 更改评审的工程你可以更改已创立评审的工程：翻开评审.单击 Edit Review. 在Project中， 选择一个新的工程. 单击 Done 按钮. 截图: 更改评审的工程Dashboard 页面简介截图: Crucible中的Dashboard页面默认情况下，这个页面显示所有用户相关的所有活动。这里的所有活动都与Crucible有关, 比方提出评审意见, 翻开或关闭评审, 提交文件至代码库,或更新Jira上的Issues。Reviews栏：根据评审的状态，对所有与你相关的评审进展分类总结。To Review 需要进展评论的评审 Require My Approval 当你被指定为裁判员或作者时，你可以推荐该评审，这类显示的是你所有推荐的评审. To Summarize 当你被指定为裁判员时，这类显示你已进展总结的评审. Out For Review 当前正在进展审查的评审。Drafts 这些评审已被创立，但尚未由裁判员批准。需要 Approval 或 Require Approval. Open 所有翻开的评审，所有参与者均可进展评审。Closed 所有已关闭的评审。 Abandoned 已取消的评审。右边栏：标签子项Activity Tab 子项：All Activity 显示所有活动。 mits 显示提交信息。 Reviews 显示评审。 Issues 显示JIRA issues. Show/Hide My Activity Show/hide你自己的活动. Show/Hide Revisions Show/hide 其他人的活动. Earlier / Later Activity (arrow buttons). Reviews Tab (显示过滤器的结果) 子项: RSS 从当前的选择翻开相应的RSS. Favourites Tab (显示你收藏的所有容.) 子项: 无. 五、 使用收藏夹1. 添加一个评审至我的收藏夹。要添加评审至我的收藏夹，将鼠标移至评审的名称上，将出现一个如截图所示的菜单。在该菜单的右上角选择Tools 菜单.再选择 Add Star. 则这个评审就被添加至我的收藏夹。截图: 添加一个评审至我的收藏夹2. 添加一条评审意见至我的收藏夹翻开该评审，在需收藏的评审意见的右下，单击 Add Favourites,则该评审意见就被添加至我的收藏夹。截图:添加一条评审意见至我的收藏夹3. 添加一个工程至我的收藏夹进入Projects 栏. 单击需收藏的工程前的灰色五角星，五角星变黄，则工程被成功地参加我的收藏夹. 截图: 添加一个工程至我的收藏夹4. 添加一个用户至我的收藏夹进入People栏，选择需收藏的用户，将鼠标移至该用户上，将出现如截图所示浮图，然后选择 Follow. 则该用户就被添加至我的收藏夹.截图:添加一个用户至我的收藏夹5. 添加*个文件或文件夹至我的收藏夹进入 Source 栏. 选择需收藏的文件或文件夹，单击灰色五角星，五角星变黄。则该文件或文件夹被添加至我的收藏夹。截图: 添加一个文件或文件夹至我的收藏夹6. 添加一个代码库至我的收藏夹进入Source 栏. 单击需收藏的代码库前的灰色五角星，五角星变黄。则该代码库被添加至我的收藏夹。截图: 添加一个代码库至我的收藏夹7. 查看我的收藏夹从 Dashboard栏中的选择 Favourites 栏。截图: 查看我的收藏夹8. 重命名我的收藏项单击需重命名的收藏项前的黄色五角色，将出现 Update Favourites 菜单. 在 Name 框中输入名字，并单击 Save label 按钮. 则该收藏项被重命名。截图: 重命名我的收藏项9. 删除我收藏夹中的*项单击需重命名的收藏项前的黄色五角色，将出现 Update Favourites 菜单，单击 Remove 按钮. 则该收藏项被删除。截图:从我的收藏夹中删除*项六、 Crucible中的快捷键1. 常用的快捷键：键 功能 翻开Crucible中的快捷键的参考列表。escape 关闭快捷键的参考列表。alt 按住ALT键，并拖动鼠标以选择多行源代码容，来进展多行评审. shift + f 全屏模式切换2. 评审意见导航快捷键：键 功能 n 转到下一个评审意见。 p 转到前一个评审意见. shift + p 转到第一个评审意见. shift + n 转到最后一个评审意见. l 转到下一个评审意见跳过回复. h 转到前一个评审意见跳过回复. 转到下一个未读评审意见。. 转到前一个未读评审意见. r 回复评审意见. m 评审意见标识，读/未读 状态的切换. 3. 文件导航快捷键：键 功能 j 转到下一个文件k 转到前一个文件shift + k 转到第一个文件shift + j 转到最后一个文件u 转到下一个未评审的文件。i 转到前一个未评审的文件。y 设置文件评审，并转到下一个未评审的文件. shift + y 切换文件的状态：reviewed/unreviewed. e 展开当前文件c 收缩当前文件shift + e 展开所有文件shift + c 收缩所有文件. z.