定制 bugzilla 进行项目管理

Apache Harmony 项目是 IBM 中国开发中心上海，近年来参加的一个开源项目。在这个项目中我们使用了开源软件开发中普遍使用的缺陷跟踪系统 —— Bugzilla。Bugzilla 是一个开源的缺陷跟踪系统（Bug-Tracking System），它可以管理软件开发中缺陷的提交（new），修复（resolve），关闭（close）等整个生命周期。针对项目的特性，我们将 Bugzilla 做为整个项目开发过程中的唯一管理工具。通过这种独特的使用方式，积累了一些经验，希望可以和广大开发人员一起分享。

Apache Harmony 开源项目的开发流程

Apache Harmony 的提案在 2005 年 5 月被 Apache 软件基金会（ASF）接受，并且按照 ASF 惯例成为一个孵化（incubator）项目。作为一个开源项目，所有参与的开发者需要遵循一个不同于一般产品开发的开发流程。在 Harmony 项目的主页上有一个链接 Get Involved，点开这个链接，您可以看到参与该项目的一些基本规则。

项目由广大的开发者提供的很多不同的捐献（contribution）推动，捐献包括代码，文档，反馈意见。该项目的一个主要特征是，希望所有的开发均发生在社区（透明性）。Harmony 项目提供了以下的基础设施保证了项目的透明性（图1）：

• 项目开发中产生的任何正式的想法和讨论均发表到 harmony 邮件组上。
• 任何非正式的讨论发表到 freenode.net 网络上的 #harmony IRC channel 频道。
• 所有的项目源码由一个公共的 svn 服务器控制。该服务器进行了严格的权限控制，以接受代码的捐赠。
• 新功能的提交，包括项目开发中产生的缺陷（bug）均会被提交到 JIRA 系统上，并且随后提交补丁。最后由具有权限的开发者将这些补丁提交到 svn 服务器上。
• 其他的一些相关的文档和讨论发表在 wiki 系统上。

可以看到，在这个开发流程中，任何关于项目的想法或是讨论均发生在项目的邮件组上。项目中所有代码包括文档等资产均通过提交补丁的形式，通过 JIRA 系统提交。然后由 committer 将 JIRA 系统中的补丁安装到 svn 代码库中。

在我们的开发团队中，大部分人扮演的是 Contributor 的角色，负责的主要工作是：

• 在邮件组上讨论需要开发的内容，获取邮件组上其他开发人员的意见，形成一个设计决定。
• 根据邮件组上形成的设计决定，开发并提交补丁。

补丁是开发小组的主要产品，而 bugzilla 系统正是面向补丁设计的系统。为了提高代码的质量，结合 bugzilla 系统提供的功能，开发小组在内部制定了一套自己的开发流程（图2）。

开发小组内部的开发流程

在这样一个流程中，小组成员被分为了两种角色，分别是开发者（DEV）和质量保证人（QA）。开发者如果有任何代码需要提交到 JIRA 系统中，他的这些代码就需要先经过小组内部流程的检验。开发者首先在 bugzilla 系统上新建一个 bug 报告（下文中将这种 bug 称为代码审查请求），将该 bug 的所有人（owner）设置为他自己，并将该 bug 分配给质量保证人（下文简称 QA）。这时代码审查请求的状态变为 ‘已分配’。这时如果开发者满怀信心的觉得自己的代码已经相当优美，他就将自己的代码作为当前 bug 的附件，上传到 bugzilla 系统中。当 QA 发现新的代码审查请求，他/她会按照特定的标准（代码和测试用例是否有逻辑错误，代码风格是否合适）进行代码审核。如果没有发现任何问题，QA 将代码审查请求的状态改为 ‘已解决’。这表示代码通过审核，可以被提交到社区里去了。

当然一般来说，代码总会出现一些小的问题。这时 QA 就会针对这些问题报告新的 bug，并将这些 bug 分配给开发者。这些 bug 不同于之前的代码审查请求，他们真正表示代码中的缺陷。这些代码缺陷会阻塞住原先的代码审查请求（通过 bugzilla 提供的功能），保证如果这些缺陷不被修复（状态不转变为 closed），则代码审查请求的状态就不能变为 ‘已修复’。当 QA 认为所有的缺陷都已经找出来之后，他/她会将代码审查请求分配给开发者。这时，开发者针对 QA 报告的缺陷，修正自己的代码，并提交新的代码补丁（将前一个代码补丁设置为废旧），将代码审查请求重新分配给 QA。这个过程将被重复，直到开发者提交的代码不会再被检查出缺陷为止。

下面的文章将结合上面介绍的流程，描述 bugzilla 的相应功能。

问题请求系统（Request System）

鉴于 Harmony 项目的特性，对代码质量的要求非常严格，仅仅通过一些代码审查（Review）工具无法完全保证其质量，所以开发中除了实际的开发人员，还增加了QA （Quality Assurance）的角色来保证代码质量。所有代码必须经过从开发人员到 QA 的反复检查才能发布。Bugzilla 为这个迭代过程提供了很好的支持。问题请求系统允许开发人员为一个补丁设置标签（flag）来请求对当前代码的复查。Bugzilla 共提供了两种类型的标签，分别用来表示 bug 和补丁的状态，我们在开发中只使用了补丁的标签功能。对于 QA 来说，他可以设置标签来表示接受或者拒绝这个补丁。通过这个标签无论是开发人员或是 QA 都可以及时掌握一个补丁当前所处的状态。以下我们详细展示怎么样通过 Bugzilla 的问题请求系统来进行代码开发的过程。

1. Bugzilla 管理员安装完 bugzilla 系统后，为当前开发的项目新建一个复查标签（图3）。