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