前置條件
- 已安裝 Eclipse + ADT + SDK (參考《從零搭建 Android 開發環境》)。
- Android 手機一支、USB 傳輸線。
步驟 1:安裝手機 USB 驅動
不同廠商驅動不同,核心目標:**裝置管理員顯示「Android ADB Interface」或「Android Device」無黃驚嘆號**。
驗證:CMD 執行 adb devices,顯示 device (非 unauthorized/offline) 即成功。
步驟 2:手機開啟 USB 偵錯
- 開啟開發者選項:設定 → 關於手機 → 連點 7 次「版本號」/「構建號」。
- 開啟 USB 偵錯:設定 → 系統/更多設置 → 開發者選項 → **USB 偵錯** (開啟)。
- 可選:啟用「USB 安裝」/「模擬二級存儲」:部分廠商需額外開啟才能安裝 APK。
- 插上 USB,手機彈出「允許 USB 偵錯?」→ 勾選「總是允許」→ 確定。
步驟 3:Eclipse 真機運行配置
- 專案右鍵 → Run As → Run Configurations…
- 左側選擇專案 → **Target** 分頁:
- 勾選 Manual (手動選擇裝置)。
- 或勾選 Automatic 但取消勾選所有 AVD,只保留真機。
- Apply → Run。
- 彈出 Device Chooser 視窗,選擇連線的真機 (Serial Number 顯示型號) → OK。
⚡ **速度優勢**:真機運行比模擬器快 5-10 倍,強烈建議日常開發主力用真機。
步驟 4:發布 APK 到真機安裝
- 專案右鍵 → Android Tools → Export Signed Application Package… (簽名發布)
- 或直接取
bin/ 目錄下的 *-debug.apk (Debug 簽名,可直接安裝測試)。
- 傳輸到手機 (USB/微信/郵件/網盤) → 點擊安裝 (需開啟「未知來源應用」安裝權限)。
常見問題排查
- adb devices 顯示 unauthorized
- 手機未授權 → 重新插拔 USB → 手機彈出授權對話框 → 勾選「總是允許」→ 確定。
- adb devices 空白 / 顯示 offline
- 1) 更換 USB 線/埠 (需支援數據傳輸)。2) 重啟 adb:
adb kill-server && adb start-server。3) 重啟手機/電腦。4) 檢查驅動是否正確安裝 (裝置管理員)。
- Eclipse 仍啟動模擬器
- Run Configurations → Target → 確保選 Manual 或取消勾選所有 AVD。
- 真機上應用閃退但模擬器正常
- 查看 Logcat (DDMS 視圖) 過濾錯誤標籤,常見:權限缺失、API 版本不相容、硬體功能缺失 (如無 NFC、指紋)。
- Android 11+ 無法安裝 Debug APK
- 需在「安裝未知應用」權限中允許該來源 (檔案管理器/瀏覽器/ADB)。
從 Eclipse 遷移到 Android Studio 的理由
- Google 2015 年停止更新 ADT,Eclipse 無法支援最新 API (Jetpack Compose, Kotlin 協程, 新建構系統)。
- Android Studio 內建 Gradle、Instant Run、Layout Inspector、Profiler、Database Inspector、Logcat 分析器等現代工具。
- 遷移步驟:File → New → Import Project → 選擇 Eclipse 專案根目錄 → 自動轉換為 Gradle (可能需手動調整)。