Eclipse 創建 Android 項目報錯：appcompat_v7 版本衝突解決

在 Eclipse 中創建 Android 項目時，常遇到 appcompat_v7 庫項目報錯，導致主項目無法編譯。這通常是由於 SDK 版本不匹配、庫項目屬性配置錯誤引起。本文提供標準化修復步驟。

常見報錯現象

• appcompat_v7 項目紅叉，提示「Target unknown」或版本衝突
• 主項目報錯「Unable to resolve target 'android-XX'」
• R.java 未生成，資源引用全部報錯

根本原因

1. Eclipse ADT 版本與 SDK Build Tools 版本不匹配
2. appcompat_v7 的 project.properties 中目標版本與已安裝 SDK 不一致
3. 主項目引用的庫路徑錯誤（相對路徑問題）

標準修復步驟

1. 修改 appcompat_v7 的 project.properties

target=android-22
android.library=true

將 target 設置為你已安裝的最高 SDK 版本（如 android-22、android-23 等），確保 android.library=true 聲明為庫項目。

2. 修改主項目的 project.properties

target=android-22
android.library.reference.1=../appcompat_v7

• target 與庫項目保持一致
• android.library.reference.1 使用相對路徑指向庫項目目錄

3. 清理並重建項目

• Eclipse 菜單：Project > Clean...
• 勾選 Clean all projects
• 點擊 OK，等待重建完成

進階排查

若上述步驟無效，檢查：

• SDK Manager 中是否安裝了對應的 Android SDK Platform 和 Build Tools
• appcompat_v7 目錄下是否有 libs/android-support-v7-appcompat.jar
• 主項目 Java Build Path > Libraries 中是否包含該 JAR
• 嘗試重新導入 appcompat_v7：File > Import > Existing Android Code Into Workspace

遷移建議

Google 已停止維護 Eclipse ADT，強烈建議遷移至 Android Studio：

• Gradle 自動管理依賴版本
• 無需手動處理庫項目引用
• 即時預覽、智能提示、性能分析等現代化功能