Bug 报告

此页面包含的信息可帮助您通过报告 Ubuntu Touch 的可操作错误来帮助我们。 它不包含有关报告应用程序中的错误的信息,大多数情况下,它们在OpenStore中的输入将指定在哪里以及如何执行该操作。

获得最新版本的 Ubuntu Touch

这似乎很明显,但却很容易错过。 请转到(设置 - 更新)以确保您的设备没有任何可用的 Ubuntu 更新。 如果没有更新,请继续阅读本指南。 如果有可用更新,请更新您的设备并尝试重现该错误。如果问题仍然出现,请继续阅读本指南。 如果没有出现,请开心一下! 该错误已被修复,您可以继续使用 Ubuntu Touch。

检查是否已报告错误

打开 ubuntu-touch 的问题跟踪器

首先,您需要确保您尝试报告的错误在以前没有被报告过。 请先搜索报告的错误。 搜索时,请使用几个词来描述你所看到的错误。 例如,“锁定 屏幕 透明”或“锁定 屏幕 显示活动”。

如果您发现错误报告已存在,请选择 “Add your Reaction” 按钮(看起来像笑脸)并选择 +1(竖起大拇指)。 这表明您也遇到了这个错误。

If the report is missing any of the information specified later in this document, please add it yourself to help the developers fix the bug.

重现您发现的问题

Next, find out exactly how to recreate the bug that you’ve found. Document the exact steps that you took to find the problem in detail. Then, reboot your phone and perform those steps again. If the problem still occurs, continue on to the next step. If not

获取日志

We appreciate as many good logs as we can get when you report a bug. In general, /var/log/dmesg and the output of /android/system/bin/logcat are helpful when resolving an issue. I’ll show you how to get these logs.

请参阅 :doc:`设置 ADB </userguide/advanceduse/adb>`以准备就绪。

现在,你可以得到两个最重要的日志。

dmesg

dmesg显示消息驱动消息)命令显示来自内核的调试消息。

  1. 使用您之前记录的步骤,重现您报告的问题。
  2. 切换到您能够记录日志的文件夹
  3. 运行命令:adb shell dmesg > UTdmesg.txt

这个日志现在应该位于您工作目录下的 UTdmesg.txt 文件中,以备日后上传。

logcat

**logcat**(日志连接器) 命令显示 Android 系统底层各个部分的调试信息。

  1. 切换到您能够记录日志的文件夹
  2. 运行命令: adb shell /android/system/bin/logcat -d > UTlogcat.txt
  3. 使用您之前记录的步骤,重现您报告的问题。

此日志将位于当前工作目录中的 UTlogcat.txt,因此您以后可以上传它。

制作错误报告

恭喜您终于等到提交错误报告的那一刻!提交错误报告需要用到英文 。

首先,打开`问题跟踪器 <https://github.com/ubports/ubuntu-touch>`_ 并点击 “New Issue”。如果没有登录 GitHub 请先登录。

接下来,您需要为您的 bug 命名。 选择一个名称,说明发生了什么,但不要太罗嗦。 四到八个字应该就够了。

现在,请书写您的 bug 报告。好的 bug 报告应该包含以下内容:

  • 发生了什么:错误行为的概要
  • 我想要发生的事情:如果没有错误,应该发生的事情的概要
  • 重现的步骤:您之前已经写下了这些,对吧?
  • 日志:请通过单击并将其拖入 GitHub Issue 来附加日志。
  • 软件版本:进入(设置 - 关于)并列出出现在此屏幕的“操作系统”那一行中的内容。这还包括您在此手机上安装 Ubuntu 时使用的发行频道。

一旦您完成了 bug提交,将无法自行添加标签,因此请不要忘记在说明中说明您遇到问题的设备,以便维护者稍后可以轻松添加正确的标签。

A developer or QA-team member will confirm and triage your bug, then work can begin on it. If you are missing any information, you will be asked for it, so make sure to check in often!