在 HarmonyOS 5 中調試 UniApp 應用的完整步驟如下，涵蓋環境配置、設備連接及調試方法：

?一、環境準備

1. ?開發工具?

   • 安裝 HBuilderX 4.64+（需啟用鴻蒙插件）
   • 可選安裝 DevEco Studio 5.0.3+（用于真機調試）
   • 配置 Node.js ≥18.x：

npm install -g @dcloudio/uni-cli  # 安裝 UniApp CLI

?2.項目配置?
在?manifest.json?聲明鴻蒙平臺：

"harmonyos": {"appType": "ohos","packageName": "com.example.app",  // 需與 AGC 應用包名一致"minPlatformVersion": 5
}

二、設備連接

1. ?USB 真機調試?

• 鴻蒙設備開啟開發者模式：
  設置 > 系統 > 開發者選項 > 啟用 USB 調試
• 連接電腦后，在設備彈窗點擊 ?允許 USB 調試?
• HBuilderX 選擇菜單：運行 > 運行到鴻蒙設備

2. ?無線跨設備調試

hdc tconn 192.168.1.100  # 連接設備 IP
hdc list targets         # 驗證設備狀態

需確保設備與 PC 在同一局域網

3. ?模擬器調試?

在 DevEco Studio 的 ?Device Manager? 啟動多規格模擬器（如折疊屏、橫豎屏）

---

🔍 三、調試方法

1. ?日志輸出?

• 使用?console?分級輸出日志：

console.debug('%{public}s', '敏感數據可見');  // public 確保日志可見
console.error('[MyApp] 網絡超時');           // 按 tag 過濾日志

2. ?可視化組件檢查?

• 打開 ?ArkUI Inspector?（DevEco Studio）：
  View > Tool Windows > ArkUI Inspector
• 查看編譯后的組件層級，通過?data-test-id?定位元素：

<button data-test-id="login_btn">登錄</button> <!-- 源碼 -->

3. ?斷點調試（uni-app x 項目）?

• 要求 HBuilderX 4.61+
• 步驟：
  1. 點擊控制臺右上角 ?蜘蛛按鈕? 開啟調試
  2. 在代碼行號左側雙擊設置斷點
  3. 運行應用，觸發斷點暫停后查看變量/調用棧

4. ?Webview 調試?

• 在?EntryAbility.ets?開啟調試支持：

import webview from '@ohos.web.webview';
webview.WebviewController.setWebDebuggingAccess(true); // 啟用 Web 調試

• Chrome 訪問?chrome://inspect?調試頁面5

---

四、常見問題解決

1. ?設備未識別?

   檢查開發者選項中 ?默認 USB 配置? 需設為?MIDI?或音頻

2. ?斷點失效?

   僅支持 uni-app x 項目（Vue3 語法）

3. ?權限缺失?

   在?module.json5?聲明所需權限（如網絡權限）：

"requestPermissions": [{"name": "ohos.permission.INTERNET","usedScene": { "abilities": ["EntryAbility"] }
}]

五、發布前準備

1. ?證書配置?
   • 在?build-profile.json5?關聯 AGC 正式簽名證書
2. ?隱私合規?
   • 敏感權限（相機/位置）需在 AGC 提交隱私協議說明

?調試效率提升?：

• 多設備同步測試生命周期鉤子與本地存儲一致性
• 使用?@ohos.hidebug?監控內存占用，避免重復渲染