Bug 报告指南

该文档描述了如何编写一个好的 Weex bug 报告。好的 bug 报告帮助开发者决定一个 bug 的优先级和严重性,并且增加了 bug 被快速修复的可能性,你能提供的具体信息越多越好。

Bug 报告原则

  • 避免重复:在报 bug 前先搜索!
  • 总是测试最新的可用版本。
  • 每个报告只报一个 bug。
  • 陈述有用的事实,而不是意见或抱怨。

如何编写一个好的 Bug 报告

一个好的 bug 报告应该包括以下信息:

标题

标题的目标是使 bug 能够被搜索并且唯一可识别。

一个坏的例子:List Crash

一个很好的例子:List Crashes when deleting a header

环境

Weex 版本: 请告知你在 bug 发生时使用的 WeexSDK 、Weex Playground 或 weex-toolkit 的版本

设备环境: 请告知你 bug 所发生的机型、平台和 OS 版本,例如:iPhone 6,iOS 10.3。

概述/描述

bug 报告的概述或描述是向开发者详细解释 bug,包括:

  • 为什么这是一个 bug
  • 可以重现 bug 的 dotwe 链接
  • 在视觉上可感知的 bug, 可以提供截屏
  • 对于 crash bug, 可以提供详细的堆栈

复现步骤

复现步骤的目标是帮助开发者在他自己的系统上重现 bug ,例如:

步骤1:使用 Weex playgroud 扫码打开上面提供的 dotwe 链接

步骤2:滚动到列表底部

步骤3:点击红色按钮删除头部组件

测试结果

测试结果,包括预期结果和实际结果,预期结果描述了应该发生的事情,实际结果描述了实际发生的事情,从而表明这是个 bug 。