ADB 无线调试连接(Windows + WSL 环境)

gradle wrapper --gradle-version 8.4

Windows + WSL 成功连接 Android 设备(用于 ./gradlew installDebug)的完整过程总结:


✅ ADB 无线调试连接过程(Windows + WSL 环境)

📌 目标:从 WSL 中通过 adb 命令连接手机并部署调试 APK


🧩 步骤 1:在 Windows 中确认手机已连接

Windows 命令行或 PowerShell 执行:

powershell 复制代码
adb devices

✅ 显示类似内容,说明手机通过 USB 成功连接:

复制代码
List of devices attached
face8771    device

🧩 步骤 2:获取手机的 Wi-Fi IP 地址

执行:

powershell 复制代码
adb shell ip addr show wlan0

✅ 输出中查找形如 inet 172.16.x.x 的行,例如:

复制代码
inet 172.16.2.56/22 brd 172.16.3.255 scope global wlan0

📌 手机的 IP 即为:172.16.2.56


🧩 步骤 3:启用 ADB TCP 模式

Windows PowerShell 中执行:

powershell 复制代码
adb tcpip 5555

✅ 输出应为:

复制代码
restarting in TCP mode port: 5555

🧩 步骤 4:在 WSL 中连接手机

切换到 WSL,执行:

bash 复制代码
adb connect 172.16.2.56:5555

✅ 如果连接成功,会显示:

复制代码
connected to 172.16.2.56:5555

🧩 步骤 5:确认设备在线

继续在 WSL 执行:

bash 复制代码
adb devices

✅ 应该显示:

复制代码
172.16.2.56:5555   device

📌 如果显示 offline,说明连接未完全成功,可能是手机弹窗未点允许或网络不通。


🧩 步骤 6:开始部署 APK

在你的项目目录下执行:

bash 复制代码
./gradlew installDebug

✅ 安装成功后,手机上将自动出现调试版应用。


✅ 补充建议

  • 如果手机 offline,先用 USB 连上,确保允许调试,再重复 TCP 流程。
  • 若遇连接失败,检查 Windows 和 WSL 是否能互通(ping 手机 IP)。
  • 推荐将 adb 服务监听改为 0.0.0.0 以避免局域网限制。

✅ 方法二:直接开放 5555 端口(可选)

如果你使用高级防火墙工具或系统策略更严格,可添加端口规则:

复制代码
# 以管理员权限运行 PowerShell
New-NetFirewallRule -DisplayName "ADB TCP 5555" -Direction Inbound -LocalPort 5555 -Protocol TCP -Action Allow

查看哪个目录占用空间最大

du -h --max-depth=1 ~ | sort -hr | head -n 10