概覽
本教學基於 Windows 7/10/11,採用經典 **Eclipse + ADT + 獨立 SDK** 方案。雖官方已推廣 Android Studio,但此流程適合維護舊專案、教學演示、理解歷史工具鏈。
步驟 1:安裝 JDK (Java SE Development Kit)
- 前往 Oracle JDK 8 下載頁 (建議 8u202 以前免商業授權版)。
- 選擇 Windows x64 安裝包 (
jdk-8u202-windows-x64.exe) 下載並安裝,預設路徑 C:\Program Files\Java\jdk1.8.0_202。
- 配置**系統環境變數** (Win+S 搜尋「編輯系統環境變數」→ 環境變數):
| 變數名 | 值 | 說明 |
JAVA_HOME | C:\Program Files\Java\jdk1.8.0_202 | JDK 根目錄 |
PATH | 在現有 PATH 末尾追加 %JAVA_HOME%\bin | 讓 java/javac 全域可用 |
CLASSPATH | .;%JAVA_HOME%\lib\tools.jar | 編譯類搜尋路徑,. 代表當前目錄 |
驗證:CMD 執行 java -version、javac -version 均顯示版本號。

步驟 2:安裝 Eclipse IDE
- 下載 Eclipse IDE for Java Developers (壓縮包)。
- 解壓至無中文、無空格路徑 (如
D:\eclipse)。
- 啟動
eclipse.exe,設定 Workspace (如 D:\workspace),勾選「Set as default」。

步驟 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 (避免 C 盤寫入失敗)。
設置管理員啟動:右鍵捷徑 → 內容 → 相容性 → 勾選「以管理員身分執行此程式」。

步驟 4:下載平台包與工具
- SDK Manager → 取消勾選無需項目,勾選:
- Tools → Android SDK Tools、Platform-tools、Build-tools (最新)
- Android 4.4 (API 19) ~ 最新版 (建議全選或按需)
- Extras → Android Support Repository、Google Repository、Google USB Driver
Install Packages → Accept All → Install。
完成後重啟 ADB (提示時選 Yes)。

步驟 5:安裝 ADT 插件
- Eclipse → Help → Install New Software → Add
- Name:
ADT,Location: https://dl-ssl.google.com/android/eclipse/
- 勾選 Developer Tools、NDK Plugins → Next → Accept → Finish → 重啟 Eclipse。

步驟 6:配置 ADT 指向 SDK
- Window → Preferences → Android
- SDK Location:
D:\android-sdk → Apply → OK。
- 下方列出已安裝平台表示成功。

步驟 7:建立 AVD 模擬器
- 工具列 AVD Manager 圖示 → New
- Name:
Android-AVD,Target: Android 4.4.2 (API 19) 或更高
- CPU/ABI:
x86 (需 HAXM) 或 arm64
- SD Card:
512 MB,Skin: 默認 → Create AVD

步驟 8:建立並運行第一個專案
- File → New → Project → Android Application Project
- Application Name:
HelloWorld,Package: com.example.helloworld
- Minimum/Target/Compile SDK 選擇合適版本 → Next → Blank Activity → Finish
- 啟動 AVD (Start → Launch) → 專案右鍵 Run As → Android Application → 選擇運行中 AVD → OK

常見問題與解決
- AVD 無法啟動 / 黑屏
- 1) BIOS 開啟 VT-x/AMD-V。2) 安裝 Intel HAXM (SDK Manager → Extras → Intel x86 Emulator Accelerator) 或啟用 Windows Hypervisor Platform。3) 刪除 AVD 重建。
- Eclipse 找不到 Android API / ADT 版本過低
- Help → Check for Updates 更新 ADT 至 23.0.7+,或改用 Android Studio。
- SDK Manager 下載極慢/失敗
- Options → HTTP Proxy 設定代理 (公司內網);或改用國內鏡像 (騰訊、中科大、上海交大)。
- 環境變數生效問題
- 修改系統變數後需**重啟 CMD/Eclipse** 才生效;可在 CMD 輸入
set 檢查。
遷移建議
**新專案請直接使用 Android Studio** (官方唯一支援 IDE)。優勢:Gradle 建構、Kotlin 第一天支援、Jetpack 元件模板、Compose 預覽、強大 Profiler、內建模擬器管理。Eclipse + ADT 僅供 2015 年前舊專案維護參考。