Waydroid调错排障完全指南：log、logcat、bugreport、shell四大利器

Waydroid调错排障完全指南log、logcat、bugreport、shell四大利器【免费下载链接】waydroidWaydroid uses a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.项目地址: https://gitcode.com/gh_mirrors/wa/waydroidWaydroid 用容器在 Linux 上运行完整 Android 系统出问题时往往一头雾水。掌握waydroid log、waydroid logcat、waydroid bugreport、waydroid shell这四大排障利器就能快速定位 Android 应用崩溃、容器启动失败等各种疑难问题这份指南带你一次学会。一、先搞懂Waydroid 的日志到底分几层 Waydroid 架构中一次出错可能发生在三层层级说明对应工具宿主侧工具层Python 主控程序下载镜像、生成 LXC 配置、管理会话waydroid log容器内 Android 层Android 系统与应用自身的运行日志waydroid logcat内核/硬件层内核消息、设备节点、GPU 直通问题waydroid bugreport搞清楚问题出在哪一层再选工具排障效率翻倍。二、利器一waydroid log —— 看宿主侧主控日志快速查看与清空日志最常用的一条命令waydroid log # 实时滚动查看tail -F 效果 waydroid log -n 200 # 只看最近 200 行 waydroid log -c # 清空日志日志文件默认写在 /var/lib/waydroid/waydroid.log工作目录默认为/var/lib/waydroid如果当前以普通用户身份运行则落到/tmp/tools.log逻辑见 tools/init.py。排障时再叠加这两个开关信息量拉满-v打开 verbose 级别记录更细的执行过程见 tools/helpers/logging.py--details-to-stdout把调试细节直接打到终端不用翻日志文件见 tools/init.py什么时候该看它waydroid init/upgrade失败容器start卡住或秒退镜像下载、LXC 配置生成出错命令行分发逻辑log动作的处理位于 tools/init.py日志滚动策略5MB 轮转在 tools/helpers/logging.py。三、利器二waydroid logcat —— 看 Android 系统日志 waydroid logcat # 实时滚动 waydroid logcat -d # 打印一次即退出 waydroid logcat -b crash # 只看崩溃缓冲区 waydroid logcat -s ActivityManager原理很简单waydroid logcat会自动进入容器执行/system/bin/logcat后面所有参数原样透传给 logcat实现代码在 tools/helpers/lxc.py。也就是说你熟悉的 adb logcat 用法在这里全部通用。应用闪退、Unfortunately XX has stopped、服务启动失败第一站都来这里查。四、利器三waydroid bugreport —— 一键打包全部证据 自己一条条收集太麻烦waydroid bugreport会替你一次性采齐内核日志dmesg/kmsgAndroid 系统日志logcat 持续采集最长 5 分钟期间会提示你现场复现问题宿主侧 waydroid.log 与配置文件waydroid.cfg、waydroid_base.prop、waydroid.prop等最终生成压缩归档waydroid-bugreport.tar.xz直接附给开发者即可。完整实现见 tools/actions/bugreport.py。 报 bug 前记得脱敏日志里可能包含你的路径、用户名等信息。五、利器四waydroid shell —— 直接钻进 Android 容器 sudo waydroid shell # 进入容器内 /system/bin/sh sudo waydroid shell -- ps -A # 不进交互直接跑命令 sudo waydroid shell -- dumpsys activity top sudo waydroid shell -u 1000 -- pm list packagesshell底层调用lxc-attach带完整 Android 环境变量进入容器见 tools/helpers/lxc.py。常用排障姿势ps -A | grep 进程确认应用进程是否还活着dumpsys 服务查看 WindowManager、ActivityManager 等服务状态pm list packages/dumpsys package 包名排查安装与权限问题--uid/--gid、-L等特权选项定义在 tools/helpers/arguments.py⚠️ 特权选项会削弱隔离仅排障时临时使用。六、标准排障流程五步走 ✅按顺序执行绝大多数问题都能收敛waydroid status # ① 会话/容器是否在跑 waydroid log # ② 宿主侧有没有报错 waydroid logcat -b crash -d # ③ Android 侧是否崩溃 sudo waydroid shell -- ps -A # ④ 容器内进程/服务状态 waydroid bugreport # ⑤ 仍没解决打包证据waydroid status通过 D-Bus 查询会话状态并显示 IP、Wayland 显示等信息实现位于 tools/actions/status.py。七、高频故障速查表 症状首选工具关注点安装/初始化失败waydroid log -v镜像下载、LXC 配置生成容器启动后黑屏/秒退waydroid logshellGPU/DRI 节点、/var/lib/waydroid/lxc应用闪退waydroid logcat -b crashFATAL EXCEPTION 堆栈应用卡在正在启动shell -- dumpsys activity卡死的服务/权限说不清原因的偶发问题waydroid bugreport复现时采集内核系统全量日志八、相关源码导读 命令总入口与参数分发tools/init.py容器 shell 与 logcat 封装tools/helpers/lxc.pybugreport 采集与打包tools/actions/bugreport.py日志级别与轮转tools/helpers/logging.py默认路径/var/lib/waydroidtools/config/init.pyLXC 容器配置模板data/configs/把四大利器用起来Waydroid 的黑盒会变成透明的——下次再遇到问题你手里已经有了完整的答案拼图。【免费下载链接】waydroidWaydroid uses a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.项目地址: https://gitcode.com/gh_mirrors/wa/waydroid创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考