使用调试程序
https://source.android.google.cn/docs/core/tests/debug/gdb?hl=zh-cn
本页详细介绍了如何使用 LLDB 或 GDB 进行操作系统开发。对于应用开发,请参阅调试应用,其中介绍了如何使用 Android Studio GUI(基于 LLDB)。
GDB 已弃用,很快就会被移除。如果您是从 GDB 改用 LLDB,应该先阅读 LLDB 教程。如果您是 GDB 专家用户,那么在过渡期间,GDB 到 LLDB 命令映射表会非常有用。
前提条件
如需使用调试程序,请执行以下操作:
使用常规 envsetup.sh 命令设置构建环境。
运行您在构建时使用的同一 lunch 命令。
如需获得环境设置方面的更多帮助,请参阅设置环境。
调试运行中的应用或进程
如需连接到正在运行的应用或原生守护程序,请配合使用 gdbclient.py 和 PID。例如,如需调试 PID 为 1234 的进程,请在主机上运行以下命令:
gdbclient.py -p 1234
此脚本会设置端口转发,在设备上启动相应的远程调试桩,在主机上启动调试程序,配置该调试程序以查找符号,然后将该调试程序连接到远程调试桩。
注意:在 Android 6 及更低版本的系统中,该脚本是一个名为 gdbclient 的 Shell 脚本,而不是名为 gdbclient.py 的 Python 脚本。
调试原生进程启动
如需在进程启动时对其进行调试,请使用 gdbclient.py 及 -r 选项。例如,如需调试 ls /bin,请在主机上运行以下命令:
gdbclient.py -r /system/bin/ls /bin
然后,在调试程序的提示符处输入 continue。
调试应用启动
有时,您需要在应用启动时对其进行调试;例如在应用发生崩溃时,您需要逐步检查代码,以查看崩溃之前发生的情况。附加调试程序有时能解决问题,但有时不能,因为应用有可能在你还没来得及附加调试程序时已经崩溃。logwrapper 方法(用于 strace)不一定能解决所有的问题,因为应用可能没有权限打开端口,而 gdbserver 会继承这项限制。
如需调试应用启动,请使用“设置”中的开发者选项来指示应用等待附加 Java 调试程序:
依次转到设置 > 开发者选项 > 选择调试应用,并从列表中选择您的应用,然后点击等待调试程序。
启动应用。您可以从启动器启动,也可以在命令行中运行以下命令来启动:
adb shell am start -a android.intent.action.MAIN -n APP_NAME/.APP_ACTIVITY
等待应用加载,然后会出现一个对话框,它会提示您应用正在等待附加调试程序。
正常附加 gdbserver/gdbclient,设置断点,然后继续运行进程。
为了让应用运行,请附加 Java 调试网络协议 (JDWP) 调试程序,例如 Java 调试程序 (jdb):
adb forward tcp:12345 jdwp:XXX # (Where XXX is the PID
of the debugged process.)jdb -attach localhost:12345
调试崩溃的应用或进程
如果您希望 debuggerd 挂起崩溃的进程,以便您可以附加调试程序,请设置相应的属性:
Android 11 之后的版本
adb shell setprop debug.debuggerd.wait_for_debugger true
Android 11 及更低版本
adb shell setprop debug.debuggerd.wait_for_gdb true
Android 6.0 Marshmallow 及更低版本
adb shell setprop debug.db.uid 999999
在惯常的崩溃输出结尾处,debuggerd 将在 logcat 中提供复制和粘贴说明,说明如何将调试程序连接到崩溃进程。
无符号调试
对于 32 位 ARM,如果您的指令中没有符号,gdb 就不清楚自己正在反汇编哪个指令集(ARM 还是 Thumb)。如需指定缺少符号信息时选用的默认指令集,请设置以下属性:
set arm fallback-mode arm # or thumb
使用 VS Code 进行调试
LLDB 支持在 Visual Studio Code 上调试平台代码。您可以使用 VS Code 调试程序前端(而非 LLDB CLI 接口)来控制和调试在设备上运行的原生代码。
在使用 VS Code 进行调试之前,请安装 CodeLLDB 扩展程序。
使用 VS Code 调试代码的步骤:
确保运行 gdbclient.py 或 lldbclient.py 所需的所有构建工件(例如符号)都存在。
运行以下命令:
lldbclient.py --setup-forwarding vscode-lldb ANY_OTHER_FLAGS -p pid | -n proc-name | -r ...
这将输出一个 JSON 对象,并且 lldbclient.py 将继续运行。 这是预期结果;请不要终止 lldbclient.py 程序。
根据工具解析标记的方式,-r 标记必须是最后一个标记(如果存在)。
注意:GDB 已废弃,应尽可能使用 LLDB。如果需要使用 GDB,请安装 C/C++ 扩展程序并将 --no-lldb 标志添加到 gdbclient.py。GDB 和 LLDB 之间的所有其他用法都相同。
在 VS Code 的“调试”标签页中,选择添加配置,然后选择 LLDB:自定义启动。这将打开一个 launch.json 文件,并将新的 JSON 对象添加到列表中。
删除新添加的调试程序配置。
复制 lldbclient.py 输出的 JSON 对象并将其粘贴到您刚删除的对象中。保存更改。
如需重新加载窗口以刷新调试程序列表,请按 Ctrl+Shift+P 并输入 reload window。
选择新的调试程序配置,然后按运行。调试程序应在 10 到 30 秒后连接。
完成调试后,请转到运行 lldbclient.py 的终端,然后按 Enter 结束 lldbclient.py 程序。