Android 系统日志报告的收集与查看方法。首先讲解了使用 adb bugreport 命令生成包含 Logcat、Dumpsys 等数据的完整报告，并说明了文件结构与手动搜索技巧。随后推荐了 ChkBugReport 和 Battery Historian 两款 GUI 工具，分别用于解析通用日志和电池功耗分析。此外，文章还深入分析了 ANR 日志的结构与排查要点，提供了 grep 命令示例及开发最佳实践，帮助开发者高效定位崩溃、卡顿及系统异常问题。
在 Android 应用开发与测试过程中，除了编写代码外，日志分析是排查问题最核心的手段之一。简单的 adb logcat 命令可以实时输出控制台日志，适合开发调试阶段。但在遇到复杂崩溃、ANR（Application Not Responding）或系统级异常时，仅靠实时日志往往不够，需要获取完整的系统快照。
本文将详细介绍如何使用 Android 内置的 bugreport 工具收集系统报告，并介绍两种常用的 GUI 工具来解析这些报告，帮助开发者快速定位问题。
在使用 adb bugreport 之前，请确保已完成以下基础配置：
adb 命令可在终端中运行。adb devices，确认设备状态显示为 device。adb devices
Android 系统提供了一个强大的内置工具 bugreport，它可以捕获当前系统的完整状态信息，包括日志、内存、CPU、电池、网络配置等数据。该功能在所有 Android 版本中均支持。
当发现应用出现崩溃、无响应或系统异常时，不要慌张，立即连接电脑并执行以下命令：
adb bugreport
执行后，系统会开始收集数据。根据设备性能和当前负载，这个过程可能需要几十秒到几分钟。结束后，会在当前工作目录下生成一个 .zip 格式的压缩包。
解压 zip 包后，你会看到一个主要的文本文件，命名格式通常为 bugreport_<品牌>_<型号>_<版本号>-<时间戳>.txt。这个文件包含了所有关键信息，主要部分包括：
main, system, events, radio, kernel 等分区日志。由于文本文件可能非常大（几十 MB），直接打开阅读效率较低。可以使用命令行工具进行过滤搜索。例如，查找崩溃堆栈：
grep -i "FATAL EXCEPTION" bugreport.txt
grep -i "ANR" bugreport.txt
grep -i "Exception" bugreport.txt
查找特定应用的日志（假设包名为 com.example.app）：
grep -A 50 "com.example.app" bugreport.txt | head -n 100
为了更高效地解析报告，推荐使用专门的图形化工具。
ChkBugReport 是由 Sony 开源的一款专门用于解析 bugreport 的工具，它可以将杂乱的文本报告转换为结构清晰的 HTML 报告。
该项目基于 Gradle 构建，可以通过源码编译，也可以寻找预编译的二进制文件。
git clone https://github.com/sonyxperiadev/ChkBugReport.git
cd ChkBugReport/core
./gradlew assemble
编译完成后，在 build/distributions 目录下可以找到发布包。解压后即可使用。
将生成的 bugreport zip 文件拖入工具目录，或直接通过命令行指定文件路径：
# Windows 示例
ChkBugReport.bat bugreport-meizu_18X_CN-RKQ1.210614.002-2022-12-07-11-11-54.zip
# Linux/Mac 示例
./ChkBugReport bugreport-meizu_18X_CN-RKQ1.210614.002-2022-12-07-11-11-54.zip
工具运行后会生成一个包含 index.html 的输出文件夹。双击打开 index.html，即可在浏览器中查看分类清晰的日志、ANR 堆栈、错误信息等。
Battery Historian 是 Google 官方提供的电池分析工具，主要用于分析设备的功耗情况，但也包含系统事件记录，有助于排查因资源占用导致的卡顿或发热问题。
由于工具基于 Go 语言开发且依赖 Web 服务，推荐使用 Docker 容器运行。
docker run -it -d -p 9999:9999 runcare/battery-historian --port 9999
启动后访问 http://localhost:9999，上传 bugreport 中的 zip 文件或特定的 battery history 文件进行分析。
ANR（Application Not Responding）是 Android 开发中最常见的问题之一。在 bugreport 文本文件中，ANR 信息通常位于 anr/ 目录下或直接在主文本的 VM TRACES 部分。
在文本文件中搜索 ANR 关键字，通常会找到类似以下的结构：
----- VM TRACES AT LAST ANR (/data/anr/anr_2022-11-28-16-37-21-918: 2022-11-28 16:37:30) -----
----- pid 30241 at 2022-11-28 16:37:23 -----
Cmd line: com.car300.activity
Build fingerprint: 'meizu/meizu_18X_CN/meizu18X:11/RKQ1.210614.002/1645597308:user/release-keys'
ABI: 'arm64'
重点关注 DALVIK THREADS 部分，这里列出了所有线程的状态。通常主线程（Main Thread）会标记为 main 或 Binder #1 等，如果主线程处于 WAITING 或 RUNNABLE 状态且耗时过长，则可能是死锁或阻塞操作。
bugreport 只能导出近期的报告，系统日志有循环覆盖机制。发现问题应尽快导出日志，避免关键信息丢失。adb bugreport 并在测试失败时保存附件，便于后续回溯。掌握 adb bugreport 及其配套工具的使用，是 Android 工程师必备的技能。通过规范的日志收集和科学的分析流程，可以大幅缩短问题定位时间，提升软件质量。建议在日常开发中养成定期备份日志的习惯，并熟悉常用 grep 命令以应对紧急排查场景。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online