✅ 前提条件
-
设备已通过 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