bugfree安装及使用说明书

1 2 3 4 5

目的.................................................................................................................................. 3 范围.................................................................................................................................. 3 BUGFREE简介 .............................................................................................................. 3 访问BUGFREE .............................................................................................................. 4 BUGFREE 界面 ............................................................................................................. 4 5.1 主界面.............................................................................................................................. 4 5.2 创建界面.......................................................................................................................... 5 6 BUG管理 ........................................................................................................................ 5 6.1 BUG的3种状态 ............................................................................................................. 5 6.2 BUG 生命周期 ................................................................................................................. 6 6.3 BUG的七种解决方案....................................................................................................... 6 6.4 BUG 字段说明 ................................................................................................................. 7 7 TEST CASE管理 ............................................................................................................ 8 7.1 TEST CASE 状态 .............................................................................................................. 8 7.2 TEST CASE 字段说明 ...................................................................................................... 8 8 TEST RESULT管理 ....................................................................................................... 9 8.1 TEST CASE的执行结果 ................................................................................................... 9 9 查询结果.......................................................................................................................... 9 9.1 设置查询条件.................................................................................................................. 9 9.2 快速筛选........................................................................................................................ 10 9.3 自定义显示字段............................................................................................................ 10 9.4 查询结果排序................................................................................................................ 10 10 统计报表........................................................................................................................ 11 11 BUGFREE使用技巧 .................................................................................................... 11 11.1 发送邮件通知 ............................................................................................................ 11 11.2 使用快捷键 ................................................................................................................ 12 12 相关资料........................................................................................................................ 12

1 Bugfree 2.0安装指南

Bugfree是一款优秀的开源的缺陷管理工具。目前的版本为2.0版。 由于bugfree是用PHP开发的，数据库用的也是开源的mysql，所以安装时要配置apache、php、mysql，对于生手比较麻烦，且容易出错。基于此考虑，同样有一款开源工具xampp可以极大的减少配置工作量。以下就列出在我的机器上装Bugfree的详细过程，初装的朋友们可作参考：

安装步骤如下：

1. 在Windows上安装Apache，PHP，Mysql软件包，例如xampp, easyphp等，我用的是xampp-win32-1.6.3a-installer.exe，可以到其官方网站去下载。我的xampp安装目录为D:\\xampp\\。

2. 下载BugFree安装包BugFree 2.0 RC1 build ，解压完成后，把解压后的Bugfree目录拷贝到D:\\xampp\\htdocs\\目录下。

3.在ie中运行 http://localhost:81/bugfree/install.php，进入安装界面。选择“安装全新的 BugFree2”，一步步完成安装即可。注意，要选择“创建数据库”。安装完毕后，删除目录中的install.php文件。

4.在ie中运行http://localhost:81/bugfree/Login.php，即可进入登陆bugfree界面，如果没有修改默认用户名密码，则管理员为admin，密码为123456。

注： 如果是从BugFree 1.x升级，需要把1.1版的BugFile目录下的文件拷贝到2.0版的BugFile目录下。

安装注意事项： 端口冲突问题：

在我的机器上已经装了iis，安装xampp时，默认apache端口号为80，同iis(占用了80和443端口)冲突导致无法启动apache。这就需要手动设置apache的端口号。

察看当前端口占用情况netstat -an -p tcp -o。

修改apache端口：我的xampp装在了D:\\xampp\\目录下，所以查找D:\\xampp\\apache\\conf目录，修改 httpd.conf文件，把listen 80修改成所分配的端口，如listen 81. 修改ServerName localhost:80为ServerName localhost:81。 同时，为了解决iis占用了443端口的问题，修改D:\\xampp\\apache\\conf\\extra\\httpd-ssl.conf,将所有443 端口改为2117。然后，apache就可以启用了。

关于xampp的简介:

xampp-win32-1.6.3a-installer.exe。

该安装包适用于 Windows 98、NT、2000、XP 和 Vista 的发行版。Vista 注意事项: 由于vista默认设置时没有足够的c:\\program files 这个目录的写入权限, 我们建议把XAMPP放到其它目录、比如 c:\\xampp 或 c:\\myfolder\\xampp。 该版本包括：Apache、MySQL、PHP + PEAR、Perl、mod_php、mod_perl、mod_ssl、OpenSSL、phpMyAdmin、Webalizer、Mercury Mail Transport System for Win32 and NetWare Systems v3.32、Ming、JpGraph、FileZilla FTP Server、mcrypt、eAccelerator、

SQLite 和 WEB-DAV + mod_auth_mysql。

2 目的

为了建立我们的bug跟踪系统，为了更好地管理我们开发出来的系统存在的bug，方便相关人员进行沟通，及时去发现，及时去回复，及时去处理，让开发人员开发出来的系统更加接近完美。

3 范围

本过程适用于测试项目类。

4 BugFree简介

BugFree基于PHP和MySQL开发，是免费且开发源代码的缺陷管理系统。服务器端在Linux和Windows平台上都可以运行；客户端无需安装任何软件，通过IE，FireFox等浏览器就可以自由使用。

BugFree 2 在BugFree 1.1的基础上，集成了Test Case和Test Result的管理功能。具体使用流程是：首先创建Test Case（测试用例），运行Test Case产生Test Result（测试结果），运行结果为Failed的Case，可以直接创建Bug。Test Case标题、步骤和Test Result运行环境等信息直接复制到新建的Bug中。如下图所示。

5 访问BugFree

hosts文件地址：C:\\WINDOWS\\system32\\drivers\\etc\\hosts

6 BugFree 界面

6.1 主界面

输入用户名和密码登录成功后，显示BugFree主界面：

? 项目选择框①：可以快速切换当前项目，项目模块框②和查询结果框⑥显示相

应的模块结构和记录。

? 项目模块框②：显示当前项目的模块结构。点击某一模块，查询结果框⑥会显示所选模块的所有记录。 ? 个性显示框③：

a) 指派给我：显示最近10条指派给我的记录。 b) 由我创建：显示最近10条由我创建的记录。 c) 我的查询：保存查询框⑤的查询条件。

? 模式切换标签④：切换Bug, Test Case和Test Result模式。默认登陆为Bug模式。

? 查询框⑤：设置查询条件。

? 查询结果框⑥：显示当前查询的结果。

a) 自定义显示：设置查询结果的显示字段。 b) 统计报表：显示当前查询结果的统计信息。

c) 导出：将查询结果显示的自定义字段导出到XML文件。最多可同时

导出5000条记录。

d) 导入（仅支持Test Case模式）：可以将导出的XML文件在Excel进

行编辑后，再导入到BugFree中，实现Test Case批量编辑。最大支持2M大小的XML文件。

e) 批量运行（仅支持Test Case 模式）：可以对查询结果的Test Case同

时创建Test Result。最多支持100个Test Case。

? 导航栏⑦：显示当前登录用户名等信息。

6.2 创建界面

为了保持用户体验的一致性，新建Bug, Test Case和Test Result的界面布局基本保持一致，只是具体填写字段有所不同。

以新建Bug为例，在主界面模式切换标签选择Bug，点击[新建 Bug]打开新建Bug页面。如下图，黄色标注字段为必填项。

7 Bug管理

7.1 Bug的3种状态

状态 Active(活动) Resolved(已解决) Closed(已关闭) 说明 Bug的初始状态。任何新建的Bug状态都是Active。可以通过编辑修改Bug的内容，并指派给合适的人员解决。 解决Bug之后的状态。 已修复Bug在验证无误之后关闭，该Bug处理完毕。如果没有真正解决或者重新复现，可以重新激活，Bug状态重新变为Active。

7.2 Bug 生命周期

新建的Bug处于Active状态，可以通过编辑指派给合适的解决者。解决Bug之后，Bug状态变为Resolved，并自动指派给创建者。创建者验证Bug。如果未修复，再重新激活，Bug状态重新变为Active；如果已经修复则可以关闭，Bug状态变为Closed，Bug生命周期结束。已经Closed的Bug如果重新复现，也可以直接激活。具体流程如下图所示。

7.3 Bug的七种解决方案

类型 三种无效的Bug 四种有效的Bug 解决方案 By Design Duplicate Not Repro Fixed External Won’t Fix

详细说明 设计需求就是这么设计的 这个问题别人已经发现 无法复现的问题 问题被修复 外部原因(比如浏览器、操作系统、其他第三方软件)造成的问题 是个问题，但是不值得修复 Postponed 发现的太晚了，下一个版本讨论是否解决

7.4 Bug 字段说明

Bug 标题：为包含关键词的简单问题摘要，要有利于其他人员进行搜索或通过标题快速了解问题。

项目名/模块路径：指定问题出现在哪个项目的哪个模块。Bug处理过程中，需要随时根据需要修改项目或模块，方便跟踪。如果后台管理指定了模块负责人，选择模块时，会自动指派给负责人。

指派给：Bug的当前处理人。如果不知道Bug的处理人，可以指派给Active，项目或模块负责人再重新分发、指派给具体人员。如果设定了邮件通知，被指派者会收到邮件通知。状态为Closed的Bug，默认会指派给Closed，表示Bug生命周期的结束。

抄送给：需要通知相关人员时填写，例如测试主管或者开发主管等。可以同时指派多个，人员之间用逗号分隔。如果设定了邮件通知，当Bug有任何更新时，被指派者都会收到邮件通知。

严重程度：Bug的严重程度。由Bug的创建者视情况来指定，其中1为最严重的问题，4为最小的问题。一般1级为系统崩溃或者数据丢失的问题；2级为主要功能的问题；3级为次要功能的问题；4级为细微的问题。

优先级：Bug处理的优先级。由Bug的处理人员按照当前业务需求、开发计划和资源状态指定，其中1的优先级最高，4的优先级最低。一般1级为需要立即解决的问题；2级为需要在指定时间内解决的问题；3级为项目开发计划内解决的问题；4级为资源充沛时解决的问题。

其余选项字段（Bug类型、如何发现、操作系统、浏览器）：可以通过编辑Lang/ZH_CN_UTF-8/_COMMON.php来自定义。

创建Build：Bug是在哪个版本（Build或者Tag）被发现的。 解决Build：Bug是在哪个版本（Build或者Tag）被解决的。

解决方案：参考Bug的七种解决方案。如果解决方案为Duplicated，需要指定重复Bug的编号。

处理状态：Bug处理过程的附属子状态，例如Local Fix表示已在本地修复；Checked In表示修复代码已经提交；Can’t Regress表示修复的问题暂无法验证等。

机器配置：测试运行的硬件环境，例如Dell G280 2G/200G。

关键词：主要用于自定义标记，方便查询。关键词之间用逗号或者空格分隔。例如，对于跨团队的项目开发，可以约定一个关键词统一标记项目。

相关 Bug：与当前Bug相关的Bug。例如，相同代码产生的不同问题，可以在相关Bug注明。

相关 Case：与当前Bug相关的Case。例如，测试遗漏的Bug可以在补充了Case

之后，在Bug的相关Case注明。

上传附件：上传Bug的屏幕截图，Log日志或者Call Stack等，方便处理人员。 复现步骤：[步骤]要描述清晰，简明扼要，步骤数尽可能少；[结果]说明Bug产生的错误结果；[期望]说明正确的结果。可以在[备注]提供一些辅助性的信息，例如，这个bug在上个版本是否也能复现，方便处理人员。

8 Test Case管理

测试用例（Test Case）是在测试执行之前设计的一套详细的测试计划，包括测试环境、测试步骤、测试数据和预期结果。在导航栏点击Test Case，即切换到Test Case模式，点击[新建Case]，创建测试用例。可以通过页面上方的[复制]按钮快速创建类似的测试用例。

8.1 Test Case 状态

Case状态 Active Blocked Reviewed 详细说明 标示有效的测试用例。所有新建Case都默认为该状态 当前Case因为其他原因，无法正常运行。通过编辑Case进行修改 通过测试用例评审的用例。通过编辑Case进行修改 Investigating 待研究确认的测试用例。通过编辑Case进行修改 8.2 Test Case 字段说明

Case 标题：测试点的简单描述（30字以内）或测试的目的。 项目名/模块路径：指定测试用例对应的项目名称和模块路径。 指派给：执行Test Case的人员。如果不知道具体的用例执行人员，可以指派给Active 。

抄送给：需要通知相关人员时填写。可以同时指派多个，人员之间用逗号分隔。 优先级：Case执行的优先级。1：冒烟测试及每次测试都需执行的用例，严重程度最高；2：覆盖产品所有主要功能；3：次要功能；4：细节功能（资源有限时，可以不执行）。其余选项字段（Case类型、测试方法、测试计划等）：可以通过编辑Lang/ZH_CN_UTF-8/_COMMON.php来自定义。

标记删除：用来标记已失效的用例，再通过查询条件进行排除。

关键词：主要用于自定义标记，方便查询。关键词之间用逗号或者空格分隔。例如，对于跨团队的项目开发，可以约定一个关键词统一标记项目。

显示顺序：通过输入0~255之间的任一整数实现对TestCase的自定义排序。例如，按照业务执行的流程重新排列Case的显示顺序。

9 Test Result管理

Test Result只能通过运行已有测试用例来创建。打开一个已有的测试用例，点击页面上方[运行]按钮，进入创建Test Result页面。Case标题、模块路径和步骤等信息自动复制到新的Test Result中。同时，Test Result相关 Case自动指向该测试用例。记录执行结果（Passed或Failed）和运行环境信息（运行Build、操作系统、浏览器等信息），保存测试用例。针对执行结果为Fail的Test Result，点击页面上方的[新建 Bug]按钮，创建新Bug。Result标题、模块路径、运行环境和步骤等信息自动复制到新的Bug中。同时Test Result相关Bug指向新建Bug。

9.1 Test Case的执行结果

Case状态 Passed Failed

详细说明 运行成功的Test Case 运行失败的Test Case 10 查询结果

10.1 设置查询条件

BugFree默认显示2个查询组，每组有3个查询字段（总共6个查询字段）。假设要查询项目Project 1, Project 2和Project 3从2008年1月1日起所有未关闭的Bug，可以设置如下的查询条件：

查询技巧：

1. 点击[保存查询]按钮，可以将当前的查询条件保存到右下角个性查询框“我的查询”标签页。点击已保存的查询，可以对查询条件进行编辑和修改。 2. 日期类型字段支持相对日期的查询。例如，创建日期 = -1将查询所有昨天创建的Bug。

3. 通过“包含”操作，可以指定多个查询值。例如，创建者包含user1,user2，搜索结果将显示两个创建者的Bug。

10.2 快速筛选

在搜索结果列点击某一字段的值，可以快速进行筛选，筛选列高亮显示。例如，要查看所有解决方案为By Design的Bug，如下图，点击任一解决方案为By Design的Bug。

注意：筛选会忽略当前设置的查询条件。

10.3 自定义显示字段

在查询结果框右上角，点击[自定义显示]链接，可以显示或隐藏查询结果的字段和显示顺序。

10.4 查询结果排序

点击搜索结果标题某一字段的标题栏，可以按该字段对搜索结果进行排序。再次点击则切换升序或降序。例如，需要查看最近更新的Bug，首先添加“最后

修改日期”自定义字段，再在查询结果标题栏点击该字段。

11 统计报表

在查询结果框右上角，点击[统计报表]链接打开新窗口。统计报表可以显示Bug, Test Case或Test Result当前查询结果的统计信息。

在统计报表页面的左侧选择统计项，点击[查看统计]按钮，右侧显示Flash统计图表。如下图：

12 BugFree使用技巧

12.1 发送邮件通知

BugFree可以实时和定时发送邮件通知。在新建Bug或Test Case并保存后，指派给和抄送给将收到实时邮件通知。可以在“抄送给”编辑框输入多个用户帐号或者邮件地址，地址之间用逗号分隔。如下图，BugFree自动按照输入的字母对用户名进行筛选。

12.2 使用快捷键

以下快捷键需要浏览器支持。

页面 主页面 快捷键 Ctrl + G 说明 弹出一个对话框。输入ID后，直接打开相应编号的Bug，Case或Result Bug, Case和Result Alt + P 通用快捷键 Alt + N Alt + E Alt + S Bug页面 Alt + R Alt + C Alt + A Case页面 Result页面 Alt + C Alt + R Alt + B 显示查询结果的上一个记录 显示查询结果的下一个记录 编辑当前记录 保存记录 解决Bug 关闭Bug 激活Bug 复制Case 运行Case 创建Bug

13 相关资料

序号 1 2 3

编号 文档名称

本文来源：https://www.bwwdw.com/article/9kq6.html