現象描述
Android Studio 偶發性無法偵測到已啟動的 Genymotion 裝置,導致 Run/Debug 找不到部署目標。重啟 Android Studio 可暫時恢復,但問題會復發。
根本原因分析
- ADB 連線衝突: Genymotion 內建 ADB 與 Android Studio SDK ADB 版本不一致或同時運行導致連線中斷。
- Genymotion 外掛未安裝/失效: Android Studio 缺少 Genymotion 整合外掛,無法自動同步裝置清單。
- 網路介面綁定問題: VirtualBox 橋接/NAT 模式切換導致 ADB 無法連線虛擬機 IP。
- 防火牆/安全軟體攔截: 本地回環或區域網路通訊埠(預設 5555)被阻擋。
標準修復步驟
1. 統一 ADB 路徑(最關鍵)
- Genymotion 設定 → ADB → 選擇 Use custom Android SDK tools → 指向 Android Studio 使用的 SDK 目錄(如
~/Library/Android/sdk 或 C:\Users\\AppData\Local\Android\Sdk)。
- 重啟 Genymotion 並重新啟動虛擬裝置。
2. 安裝/更新 Genymotion 外掛
- Android Studio → Settings → Plugins → Marketplace 搜尋 Genymotion → 安裝並重啟 IDE。
- 外掛會在工具列顯示 Genymotion 圖示,可直接啟動/管理裝置。
3. 驗證 ADB 連線
# 終端機執行
adb kill-server
adb start-server
adb devices
# 應列出 Genymotion 裝置(如 192.168.56.101:5555)
若未列出,嘗試手動連線:
adb connect 192.168.56.101:5555
4. VirtualBox 網路模式建議
- 預設 NAT 模式通常最穩定,Genymotion 會自動轉發 ADB 埠。
- 若需區網直連,改用 Host-only Adapter 並確保 IP 段與宿主機同網段。
5. 防火牆例外規則
- Windows:允許
adb.exe、Genymotion.exe、VBoxHeadless.exe 通過防火牆(私人/公用網路)。
- macOS/Linux:確認
pf/iptables 未阻擋 5555、5037 埠。
進階替代方案
若問題持續存在,建議改用 Google 官方 Android Emulator(支援硬體加速、快照、折疊裝置模擬),或使用實體裝置開發,穩定度更高。
快速檢查清單
- ☐ Genymotion ADB 指向正確 SDK
- ☐ Android Studio 安裝 Genymotion 外掛
- ☐
adb devices 顯示虛擬裝置
- ☐ VirtualBox 網路模式正確
- ☐ 防火牆放行 ADB 相關執行檔