Eclipse Android 模擬器啟動黑屏無畫面排查指南

Eclipse + ADT 時代常見問題：AVD 啟動後僅閃爍一下即無畫面，Console 顯示 Automatic Target Mode: Preferred AVD 'xxx' is not available. Launching new emulator. 主因通常為 AVD 配置不相容、Eclipse 指向錯誤的 SDK/AVD 路徑、或電腦規格不足（無硬體加速）。

排查步驟（由易到難）

1. 更換 AVD 裝置定義

• 開啟 Window → Android Virtual Device Manager
• 編輯有問題的 AVD，將 Device 下拉選單改為 Nexus 5X / Pixel 2 等標準手機定義
• 避免選擇「Tablet」、自訂解析度或過舊 API Level

2. 確認 Eclipse 指向正確 SDK 與 AVD 路徑

• Window → Preferences → Android → SDK Location 應指向實際安裝的 SDK 根目錄（含 platform-tools, emulator 等）
• Window → Preferences → Android → Build → Default debug keystore 路徑下的 .android 目錄，應與 AVD Manager 實際儲存 AVD 的目錄一致（通常為 C:\Users\用戶名\.android\avd）

3. 啟用 GPU 硬體加速（關鍵）

• AVD 設定 → Emulated Performance → Graphics: Hardware (GLES 2.0)
• 若電腦顯卡驅動舊，嘗試 Software 模式
• 主機需支援 Intel HAXM 或 AMD Hyper-V / WHPX

4. 增加模擬器記憶體與儲存

• RAM: 1536 MB 以上（視主機記憶體而定）
• VM Heap: 256 MB 以上
• Internal Storage: 2 GB 以上
• SD Card: 100 MB 以上

5. 手動啟動模擬器驗證

# 命令列啟動，觀察詳細錯誤輸出
cd /emulator
./emulator -avd  -verbose -show-kernel -no-snapshot-load

常見錯誤：

• emulator: ERROR: x86 emulation currently requires hardware acceleration → 安裝 HAXM / 啟用 Hyper-V
• PANIC: Broken AVD system path → AVD 路徑錯誤，重建 AVD
• Failed to allocate memory → 降低 RAM 設定或關閉其他程式

根本建議：遷移至 Android Studio

Eclipse ADT 官方已於 2015 年停止支援，模擬器、Gradle、Instant Run、Layout Inspector 等現代工具鏈僅支援 Android Studio。強烈建議：

1. 下載最新 Android Studio
2. File → New → Import Project 選擇舊專案根目錄（含 build.gradle 或 project.properties）
3. 自動遷移為 Gradle 專案
4. 使用內建 Device Manager 建立新 AVD（支援 Apple Silicon、折疊機、汽車模擬等）

臨時替代：Genymotion / 實體機

• Genymotion 基於 VirtualBox，啟動快、相容性好、免費個人版可用
• 實體機開啟 開發人員選項 → USB 偵錯，adb devices 確認連線即可運行

Eclipse 時代已成歷史，擁抱 Android Studio 才能獲得穩定、高效的開發體驗。