安卓無線調試
? 前提條件
-
設備已通過 USB 正常調試(你已確認 ??)
-
設備和開發電腦在同一 Wi-Fi 網絡
-
已啟用“開發者選項”和“USB 調試”
-
(推薦)設備已 Root 或支持 ADB over Wi-Fi(大多數 Android 11+ 原生支持)
?? 注意:.NET MAUI 本身不關心是有線還是無線 ADB,它只依賴
adb能識別到設備。
?? 無線調試設置步驟(無需 Root,適用于 Android 11+)
方法一:使用 Android 原生“無線調試”功能(推薦,Android 11+)
從 Android 11 開始,系統原生支持配對式無線調試(更安全)。
步驟:
-
在設備上進入:
設置 → 開發者選項 → 無線調試-
開啟“無線調試”
-
點擊 “使用配對碼配對設備”,記下 IP 地址、端口、配對碼
-
-
在電腦的終端(以管理員身份運行)執行:
adb pair <IP>:<配對端口>例如:
adb pair 192.168.1.100:37265-
輸入配對碼(如
123456)
-
-
再連接調試端口:
adb connect <IP>:<調試端口>例如:
adb connect 192.168.1.100:41237 -
驗證:
adb devices應顯示:
List of devices attached
192.168.1.100:41237 device -
在 Visual Studio 2022 中:
-
部署目標會自動出現你的設備(如
L209B (192.168.1.100:41237)) -
直接點擊 “啟動” 即可無線部署和調試!
-
方法二:傳統 ADB over TCP(適用于 Android 10 及以下,或無“無線調試”選項)
需要先用 USB 連接一次。
步驟:
-
用 USB 連接設備
-
在電腦終端執行
:
adb tcpip 5555 -
拔掉 USB
-
連接 Wi-Fi
:
adb connect <設備IP>:5555 -
在 VS2022 中選擇該設備部署
?? 缺點:重啟設備后需重新插 USB 執行
adb tcpip 5555
??? 在 Visual Studio 2022 中使用無線設備
-
確保
adb devices能看到你的無線設備 -
打開 MAUI 項目
-
在頂部工具欄的
設備下拉菜單
中,你會看到類似:
L209B (192.168.1.100:5555) -
選擇它,按
F5 或點擊“啟動”
-
VS 會自動:
-
構建 APK
-
通過 ADB 無線安裝
-
啟動應用并附加調試器
-
-
? 支持:斷點、日志、熱重載(Hot Reload)等全部調試功能!
?? 常見問題 & 解決方案
| 問題 | 解決方法 |
|---|---|
| VS 找不到無線設備 | 確保 adb devices 能看到;重啟 ADB:adb kill-server && adb start-server |
| 連接后立即斷開 | 檢查防火墻是否阻止 5555 端口;確保設備不休眠(設置“保持喚醒”) |
| Android 10 以下無法配對 | 使用方法二(adb tcpip) |
| 部署失敗:INSTALL_FAILED_USER_RESTRICTED | 在開發者選項中關閉“USB 安裝限制”或“MIUI 優化”(小米)等 |
? 推薦工作流(日常開發)
-
早上插一次 USB,執行
adb tcpip 5555 -
拔掉線,全天無線調試
-
如果設備重啟,再插一次 USB 執行
adb tcpip 5555(或使用 Root 自啟腳本)
?? 提示:可以寫個批處理腳本(Windows)一鍵切換:
@echo off
adb tcpip 5555
timeout /t 2 /nobreak >nul
adb connect 192.168.1.100:5555
echo Wireless ADB connected!
pause
? 總結
| 項目 | 是否支持 |
|---|---|
| .NET MAUI + VS2022 無線調試 | ? 完全支持 |
| 需要 Root? | ? 不需要(Android 11+ 原生支持) |
| 支持斷點/日志/熱重載? | ? 全部支持 |
| 首次是否需要 USB? | ? 是(用于授權或開啟 TCP 模式) |
現在你就可以擺脫 USB 線束縛,自由移動調試 MAUI 應用了!??
如果遇到具體錯誤(如連接失敗、VS 不顯示設備),歡迎貼出 adb devices

浙公網安備 33010602011771號