Android AppCompat v7 導致「hierarchy inconsistent」編譯錯誤修復

錯誤現象

The hierarchy of the type TestActivity is inconsistent
The type android.support.v4.app.TaskStackBuilder$SupportParentable cannot be resolved

根因

專案僅引用了 android-support-v7-appcompat.jar，未將 appcompat 作為 Library Module 導入。資源文件、R.java、內部類（如 TaskStackBuilder$SupportParentable）未被正確打包，導致編譯器找不到符號。

標準修復流程

1. Eclipse ADT：
   • File → Import → Existing Android Code Into Workspace → 選中 <sdk>/extras/android/support/v7/appcompat。
   • 勾選「Copy projects into workspace」，Finish。
   • 右鍵專案 → Properties → Android → Library → Add → 選中 appcompat。
2. Android Studio / Gradle（現代專案）：

   dependencies {
       implementation 'com.android.support:appcompat-v7:28.0.0' // 或 androidx 版本
   }

3. 清理重建：Project → Clean → Build Automatically。

常見誤區

遷移建議

新專案請直接使用 AndroidX（androidx.appcompat:appcompat:1.6.1），老專案可通過 Refactor → Migrate to AndroidX 一鍵遷移。

總結

AppCompat v7 必須作為 Library Module 依賴，而非單純 Jar 引用。遵循官方接入流程，清理緩存重建即可消除「hierarchy inconsistent」。