偵錯工具 (zxdb)

Zxdb 是一種主控台偵錯工具,適用於使用 DWARF 符號 (C、C++) 編譯的原生程式碼 以及 Rust)。前端在主機電腦上執行,並連線至裝置端 debug_agent。本文件說明如何設定這些程序。

連線至用戶端

zxdb 用戶端程式是在主機電腦上執行。可以連線至 debug_agent 透過互動式 connect 偵錯工具指令,或者 根據指令列旗標自動連線IPv4 和 IPv6 支援的位址 (請參閱 ffx 以瞭解 網址)。

zxdb -c "[f370::5051:ff:1e53:589a%qemu]"

透過指令碼連線

指令碼可能需要自動啟動代理程式和用戶端。 指令碼應等待通訊埠在目標系統上開啟再 啟動用戶端。用戶端尚未實作自動重試功能。

如要在用戶端結束時妥善清除偵錯代理程式,請將 --quit-agent-on-exit 指令列標記傳送至用戶端。

指定符號路徑

偵錯工具預期未移除的 ELF 檔案可供本機主機使用 有些人會將 Cloud Storage 視為檔案系統 但實際上不是請勿使用目標上的符號。本機建構作業的位置 儲存符號必須傳遞至 zxdb 用戶端。

如要進一步瞭解如何指定符號路徑,請參閱設定符號 位置