作者：deepin-mozart、toberyan

前不久深度科技旗下 deepin 社區發布了自己的 IDE：deepin-IDE，得到了全網用戶尤其是開源社區用戶的廣泛關注，目前在 GitHub倉庫的 star 數量已經達到 600 多個，說明大家的熱情還是很高漲的。

為了從技術層面給大家的熱情做一個反饋，本文試著將 deepin-IDE 內部的一些實現方法進行分享，希望能夠解答友友們的疑惑并得到積極的反饋。

本篇挑了大家關心的 “調試” 部分進行分享。需要說明的是，deepin-IDE 的調試功能是選用 DAP（Debug Adapter Protocol ）調試適配協議實現的，所以整體架構是圍繞該協議搭建的，至于DAP具體是什么，讓我們帶著問號往下看。

什么是DAP協議

DAP即調試適配協議 (Debug Adapter Protocol)，顧名思義，它是用來對多種調試器進行抽象統一的適配層，將原有IDE和調試工具直接交互的模式更改為和DAP進行交互。該模式可以讓IDE集成多種調試器變得更簡單，且靈活性更好。

在IDE中的調試功能有許多小功能組成，包括單步執行、斷點、查看變量值等，常規的實現方式是在每個IDE中去實現這些邏輯，且因為調試工具的接口不同，還需要為每個調試工具做一些適配工作，這將導致大量且重復的工作，如下圖所示：

調試適配器協議背后的想法是標準化一個抽象協議，用于開發工具如何與具體調試器通信。這個思想和LSP(Language Server Protocol) 和BSP(Build Server Protocol) 類似，都是通過協議去統一相同功能在不同工具之間的差異性。其所處位置如下圖所示，其中左邊為不同的開發工具，右邊為不能同的調試器，不同于開發工具和調試器直接交互的方式，DAP將這些交互統一了起來，讓開發工具和調試工具都面向DAP編程。

上圖中的交互是通過協議進行，所以不會像通過API的方式存在語言限制，可以更好的適應調試器的集成。

DAP 如何工作

以下部分解釋了開發工具（例如IDE或編輯器）和調試適配器之間的交互，包括具體的協議格式說明、交互流程等。

調試會話

開發工具有兩種基礎的方式和調試器進行交互，分別是:

【單會話模式】 在這種模式下，開發工具啟動一個調試適配器作為一個單獨的進程并且通過標準的 std 接口進行通信。在調試會話的結束時調試適配器就終止，對于當前的調試會話，開發工具往往需要實現多個調試適配。

【多會話模式】

在這種模式下，開發工具不會啟動調試適配器，而是假定它已經在運行并且會在特定端口上偵聽連接嘗試，對于每個調試會話，開發工具在特定端口上啟動一個新的通信會話并在會話結束時斷開連接。

在與調試適配器建立連接后，開發工具和調試適配器之間通過基礎協議進行通信。

基礎協議

基礎協議由兩部分組成，包括頭和內容 (類似于 HTTP)，頭部和內容部分通過 “ ” 進行分割：
【協議頭】


協議頭部分由字段組成， 每個頭字段由一個鍵和一個值組成，用‘:’（一個冒號和一個空格）分隔， 每個頭字段都以 “ “結尾。由于最后一個協議頭字段和整個協議頭本身都以 終止，并且由于協議頭是強制性的，所以消息的內容部分總是在（并唯一標識）兩個 序列之前。當前只支持一個協議頭字段：

協議頭部分使用的是 “ASCII” 編碼。

【內容部分】

內容部分包含了實際要傳輸的數據，這些數據用JSON格式來描述請求、響應和事件。內容部分用的是utf-8編碼

為了有個具體的認識，這里舉個簡單的例子。在調試過程中，開發人員經常會使用到下一步操作，在DAP中其協議為：

Content-Length: 119



{
  "seq": 153,
  "type": "request",
  "command": "next",
  "arguments": {
    "threadId": 3
   }
}

使用方法

詳細的使用方法這里就不涉及，因為用一個時序圖就可以說明：

可以看到，初始化、請求、響應等必要的步驟都在圖中。其中調試適配器可以理解為調試器的抽象，調試功能的最終執行者是由對應語言的調試工具實現的。

在 deepin-IDE 中的實現

在 deepin-IDE 中，調試功能的實現是結合cppdap+debugmanager實現的。

cppdap是一款基于 C++ 開發的SDK，基本實現了DAP的全量協議。deepin-IDE 的客戶端和服務端都是應用的該SDK進行開發，據此可以實現以下功能：

1. 通信功能，包括服務端的 TCP 監聽，客戶端的 TCP 連接等；

2.DAP協議的封裝，并實現協議的串行化和解串行化；

3. 提供注冊回調功能，從而可以在回調內處理各種事件、請求等；

它的層級結構如下：

用cppdap可以減少客戶端和服務端不少工作量，也統一了兩邊的協議數據。而 debugmanager 可以理解為調試器的抽象，包含所有必要的調試要素。整體結構如下：

左邊是客戶端，右邊是服務端，內部實現如下：

客戶端實現

客戶端包含了兩個個主要功能，一個是和DAP服務端進行交互，發送調試命令或處理返回的數據；另一個是將DAP數據轉換后顯示到用戶界面，并響應界面發送的事件。概括起來就包含業務模塊、事件模塊、DAP模塊和界面 4 個部分。
業務模塊

業務模塊包含了插件類、調試參數、調試管理類等，其中插件類負責插件加載、初始化、獲取上下文等，調試管理類用來組合事件、DAP、界面幾個模塊。事件模塊

事件模塊包含兩個子模塊，分別是事件發送和事件接收，比如頁面跳轉事件、添加 移除斷點事件等。DAP模塊

DAP模塊基于cppdap開發，采用層級結構，底層是原始DAP協議封裝，中間層是針對業務做的進一步封裝，簡化了向外提供的接口，最上層是對整個調試功能的整合，包括數據緩存、界面元素、命令收發。

界面部分 界面模塊包含堆棧界面、變量界面、斷點列表、異步對話框等，用于DAP的數據展示。

如上圖所示，灰色部分為DAP客戶端的界面呈現。

服務端實現

服務端的功能分為兩個部分，一個是基于cppdap實現命令的收發，另一個是與gdb交互，實現調試程序的啟動、暫停、退出等一系列動作。
DAP

和客戶端一樣，服務端也是基于cppdap實現的通信和協議封裝和解析。調試工具

和調試工具的交互是通過進程調用的方式實現，接收進程輸出得到返回信息。如果調試工具本身支持DAP協議，則可以直接交互。

至此，本次的分享就到這兒啦！不知道你對deepin-IDE中的調試功能有所了解了嗎？

溫馨提示，deepin-IDE 還包含很多有意思的功能，如果大家感興趣可以積極反饋，后續有機會再進行分享。

審核編輯：湯梓紅