Visual Studio Emulator for Android (VSEA) 採用 Hyper-V 架構，效能遠優於傳統 HAXM/QEMU 模擬器，且不依賴 Visual Studio 即可獨立運行。完整部署與 Android Studio 深度整合流程。
前置需求
- Win10 64 位元 (Pro/Enterprise/Education，Home 版需手動啟用 Hyper-V)。
- CPU 支援 SLAT (Intel EPT / AMD RVI)。
- BIOS 啟用虛擬化 (VT-x / SVM)。
- 啟用 Hyper-V：控制台 > 程式和功能 > 開啟或關閉 Windows 功能 > 勾選 Hyper-V 全套 > 重開機。
VSEA 安裝
- 下載
vs_emulatorsetup.exe（約 40MB，官網/Visual Studio Installer 取得）。
- 執行安裝，預設線上下載 API 19 (Android 4.4) x86 映像，可事後在管理器下載其他 API (16-28)。
- 安裝完成必須重開機（加入 Hyper-V Administrators 群組）。
Android Studio 整合配置
1. 設定目標裝置選擇器
- Android Studio > Run > Edit Configurations > Defaults > Android Application > General。
- Target Device 區塊：勾選 Show chooser dialog、Use same device for future launches。
- Apply > OK。
2. 新增「啟動模擬器」Toolbar 按鈕
- File > Settings > External Tools > Add (+)：
- Name:
VS Emulator (API 19)
- Program:
emulatorcmd.exe 絕對路徑 (預設 C:\Program Files (x86)\Microsoft Emulator Manager\1.0\emulatorcmd.exe)
- Parameters:
/sku:Android /id:{GUID} (GUID 由 emulatorcmd.exe /sku:Android list /type:device 取得)
- Working Directory:
$ProjectFileDir$
- 工具列右鍵 > Customize Menus and Toolbars > Main Toolbar > Add After > External Tools > 選擇剛建立工具 > OK。
3. 新增「adb 連線模擬器」Toolbar 按鈕
- External Tools 再新增：
- Name:
adb Connect (VS Emulator)
- Program:
adb.exe 絕對路徑 (SDK platform-tools\adb.exe)
- Parameters:
connect IP:5555 (IP 從模擬器 Wi-Fi 設定/網路資訊查看，通常 192.168.x.x 或 169.254.x.x)
- Working Directory:
$ProjectFileDir$
- 同樣加入 Toolbar。
4. 自動化：Run 前自動啟動模擬器 + adb 連線
- Run > Edit Configurations > Defaults > Android Application > Emulator 分頁 > Before Launch 區塊。
- 添加兩個 External Tool，順序：
- VS Emulator (API 19) - 啟動模擬器
- adb Connect (VS Emulator) - 連線 adb
- Apply > OK。
驗證與除錯
- 點擊 Toolbar 「啟動模擬器」> 等待 Hyper-V VM 啟動 > 點擊「adb 連線」> Run 專案 > 選擇裝置對話框出現模擬器 > OK。
- 若 adv 連線失敗：確認模擬器網路模式 (NAT/橋接)、防火牆允許 adb (5037/5555)、
adb kill-server && adb start-server 重試。
- Hyper-V 管理器可查看 VM 狀態、調整記憶體/CPU 核心數。
從 Hyper-V 底層加速到 Android Studio 一鍵 Run，打造 Windows 上最高效能、最流暢的 Android 開發測試環境。
