前言
雖然 Google 官方已全面推廣 Android Studio,但許多舊專案、教學資源仍基於 Eclipse + ADT。本文記錄 Windows 下經典環境搭建全流程,適合維護舊專案或理解歷史演進的開發者。
步驟 1:安裝 JDK 並配置環境變數
- 下載 JDK 8 (建議 8u202 以前版本,免商業授權)。
- 安裝後配置三大環境變數(系統變數):
| 變數名 | 值範例 | 說明 |
JAVA_HOME | C:\Program Files\Java\jdk1.8.0_202 | JDK 安裝根目錄 |
PATH | %JAVA_HOME%\bin (追加至現有 PATH) | 讓 java/javac 任意路徑可執行 |
CLASSPATH | .;%JAVA_HOME%\lib\tools.jar | 編譯時類搜尋路徑,. 代表當前目錄 |
驗證:CMD 執行 java -version、javac -version 均顯示版本號即成功。
步驟 2:安裝 Eclipse IDE
步驟 3:安裝 Android SDK (獨立版)
- 下載 Command line tools only (SDK Tools),解壓至
D:\android-sdk。
- 將
D:\android-sdk\tools、D:\android-sdk\platform-tools 加入 PATH。
- 以管理員身份啟動
SDK Manager.exe,勾選安裝:
- Tools → Android SDK Tools、Platform-tools、Build-tools (最新)
- Platforms → Android 4.4 (API 19) 以上建議全選
- Extras → Android Support Repository、Google Repository、USB Driver
※ 公司網路需在 SDK Manager → Options 設定 HTTP Proxy。
步驟 4:安裝 ADT 插件
- Eclipse → Help → Install New Software → Add
- Name:
ADT,Location: https://dl-ssl.google.com/android/eclipse/
- 勾選 Developer Tools、NDK Plugins,一路 Next 完成並重啟 Eclipse。
步驟 5:配置 ADT 指向 SDK
- Window → Preferences → Android → SDK Location:
D:\android-sdk → Apply → OK。
- 若出現已安裝平台列表,表示配置成功。
步驟 6:建立第一個 Android 專案
- File → New → Project → Android Application Project
- Application Name:
HelloWorld,Package: com.example.helloworld
- Minimum SDK: API 19,Target SDK: 最新,Compile SDK: 最新
- 選擇 Blank Activity,Finish。
步驟 7:建立 AVD 模擬器並執行
- 工具列點選 AVD Manager 圖示 → Create Virtual Device
- 選擇裝置 (Nexus 5X)、System Image (x86 或 arm64、API 28+)、啟用 GPU 加速。
- 工具列點選 Run (▶) → 選擇剛建立的 AVD → OK。
小技巧:模擬器啟動慢,**不要關閉模擬器**,修改代碼後直接再次 Run,App 會熱重啟。
常見問題排查
- AVD 無法啟動:檢查 BIOS 開啟 VT-x/AMD-V,安裝 HAXM (Intel) 或 WHP (Windows Hypervisor Platform)。
- Eclipse 找不到 Android API:ADT 版本過舊,請更新至 23.0.7+ 或改用 Android Studio。
- SDK Manager 下載失敗:改用國內鏡像 (如騰訊、中科大) 或開啟代理。
遷移建議
新專案**強烈建議直接使用 Android Studio**,享受 Gradle 建置、Instant Run、Layout Inspector、Profiler 等現代工具鏈。Eclipse + ADT 已於 2015 年停止更新,僅供維護舊專案參考。