Android神兵利器 | ChkBugReport输出网页版错误报告

-- 做者 谢恩铭 转载请注明出处

内容简介

---

1. 前言
2. 难读的 BugReport
3. ChkBugReport来拯救你
4. 写一个 Shell 快捷方式
5. 总结

1. 前言

---

从事 Android（嵌入式）开发，也许常要和 BugReport 打交道。

BugReport 是由 Bug 和 Report 这两个英语单词组成。bug 是英语「瑕疵，错误」的意思，在计算机领域专指程序中的问题。report 是英语「报告」的意思。

顾名思义，BugReport 就是「错误报告」的意思。不过，真实的 BugReport 不单单记录错误，不一样级别的日志也会记录下来，方便咱们 debug。

通常来讲 Android 的 BugReport 是 .txt 结尾的文本文件，好比咱们公司的 Android app 里的 BugReport 就是命名为 bugreport.txt。固然了，命名没有限定。

Google 的 Android 主页上有专页论述如何阅读 BugReport ：source.android.com/source/read…

上面的页面推荐好好阅读下，对你排查 Android 的问题颇有帮助。

2. 难读的 BugReport

---

Android 的 BugReport 里面包含了 dumpsys，dumpstate，logcat 命令输出的结果。内容通常来讲会不少。

要生成一个 BugReport，咱们能够运行如下命令：

adb bugreport > bugreport.txt复制代码

通常的 BugReport 是这样的：

这样的：

是否是以为很难阅读呢？有点望而却步的感受。

3. ChkBugReport来拯救你

---

幸亏，咱们有一个免费开源的小软件来拯救你。

这个软件是索尼（Sony）公司开发的，开源在 Github 上：github.com/sonyxperiad…

这个软件名叫 ChkBugReport。Chk 是 check 的缩写，表示「检查」。

ChkBugReport 并无什么安装程序或脚本，只有一个 JAR 包供下载。

软件下载连接：github.com/sonyxperiad…

咱们下载最新版，下载下来是这样一个文件：

要用它来解析 BugReport 文件并生成网页版报告，须要用 java 命令（请先安装和配置 Java 开发环境，网上有不少图文教程，就不赘述了）：

java -jar $HOME/chkbugreport.jar $HOME/bugreport.txt复制代码

$HOME 是一个环境变量，指示了你的家目录的路径。

ChkBugReport 会为你生成一个文件夹，叫作 bugreport_out，文件夹里有个 index.html 文件，这就是咱们的错误报告的网页了，是一个 HTML 文件。

你能够双击启动它 （若是你设置了 .html 文件用浏览器程序启动的话）， 或者用命令行，好比我用 firefox 浏览器来启动这个 HTML 文件：

firefox bugreport_out/index.html复制代码

打开后的网页以下所示，有不少栏目：

能够查看每个栏目，好比查看 System log 中的 log ：

4. 写一个 Shell 快捷方式

---

难道每次咱们启动 ChkBugReport 都要附上那个 JAR 包的路径吗？岂不是太麻烦。

不要紧，咱们能够写一个 Shell 脚原本做为快捷启动方式。

首先咱们把 chkbugreport-0.4-185.jar 更名为 chkbugreport.jar，并把它放到 $HOME/bin 目录中：

mv $HOME/chkbugreport-0.4-185.jar $HOME/bin/chkbugreport.jar复制代码

而后建立一个 Shell 脚本，起名叫 chkbugreport 好了，也放在 $HOME/bin 目录中 ：

vim $HOME/bin/chkbugreport复制代码

在脚本中加入如下代码：

#!/bin/sh

DIR=$HOME/bin
JAR=$DIR/chkbugreport.jar
CP=$JAR

if [ ! -f $JAR]; then
    echo "为了这个脚本可以运行，请把下载的 ChkBugReport 的 JAR 包拷贝到 $JAR 中"
    exit 1
fi

java -jar $CP "$@"复制代码

为脚本添加可执行权限：

chmod +x $HOME/bin/chkbugreport复制代码

确保 $HOME/bin 这个目录在 Path 环境变量中，请参看 Linux探索之旅 | 第五部分第二课：一入Shell深似海，酷炫外壳惹人爱 。

以后，你就能够在随便哪一个目录中运行

chkbugreport bugreport.txt复制代码

来生成错误报告的网页版了。

5. 总结

---

1. Android 因其开源特性，相比 iOS 能够应用在更多领域，好比 嵌入式。

2. 网上有很多 Android 开发有用的开源工具，Github 上更是一搜一大堆。善于使用工具，必将事半功倍。

3. ChkBugReport 能够基于 Android 的 BugReport 为咱们输出易读的网页版错误报告，是 HTML 格式的，能够用浏览器打开。

---

微信公众号「程序员联盟」ProgrammerLeague
我是谢恩铭，在巴黎奋斗的软件工程师。
个人简介
个人经历热爱生活，喜欢游泳，略懂烹饪。人生格言：「向着标杆直跑」