gradle wrapper --gradle-version 8.4
Windows + WSL 成功连接 Android 设备(用于 ./gradlew installDebug
)的完整过程总结:
✅ ADB 无线调试连接过程(Windows + WSL 环境)
📌 目标:从 WSL 中通过 adb
命令连接手机并部署调试 APK
🧩 步骤 1:在 Windows 中确认手机已连接
在 Windows 命令行或 PowerShell 执行:
adb devices
✅ 显示类似内容,说明手机通过 USB 成功连接:
List of devices attached
face8771 device
🧩 步骤 2:获取手机的 Wi-Fi IP 地址
执行:
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 中执行:
adb tcpip 5555
✅ 输出应为:
restarting in TCP mode port: 5555
🧩 步骤 4:在 WSL 中连接手机
切换到 WSL,执行:
adb connect 172.16.2.56:5555
✅ 如果连接成功,会显示:
connected to 172.16.2.56:5555
🧩 步骤 5:确认设备在线
继续在 WSL 执行:
adb devices
✅ 应该显示:
172.16.2.56:5555 device
📌 如果显示 offline
,说明连接未完全成功,可能是手机弹窗未点允许或网络不通。
🧩 步骤 6:开始部署 APK
在你的项目目录下执行:
./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