Android 升級 targetSdk 23 後 Rendering Problems：AppCompat 主題缺失與解決方案

將 `compileSdkVersion` / `targetSdkVersion` 升級到 23 (Android 6.0 Marshmallow) 後，XML 預覽報 `Rendering Problems: Missing styles. Is the correct theme chosen for this layout?`。核心原因是 **AppCompat 主題未正確引用、或 `values-v23` 資源衝突**。以下提供標準修復步驟。

錯誤現象

渲染錯誤：Missing styles. Is the correct theme chosen for this layout?
java.lang.IllegalArgumentException: You need to use a Theme.AppCompat theme (or descendant) with this activity.

原因分析

標準修復步驟

1. 確認 build.gradle 依賴版本一致

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        targetSdkVersion 23
        // ...
    }
}

dependencies {
    implementation 'com.android.support:appcompat-v7:23.4.0' // 必須與 compileSdk 主版本一致
    implementation 'com.android.support:design:23.4.0'
    implementation 'com.android.support:recyclerview-v7:23.4.0'
    // 所有 support 庫版本號保持一致
}

2. 修正 styles.xml 主題繼承鏈

<!-- res/values/styles.xml -->
<resources>
    <!-- 基礎應用主題：繼承 AppCompat -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
        <!-- 去除 ActionBar 若不需要 -->
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
    </style>
</resources>

3. 檢查 values-v23/styles.xml（若存在）

<!-- res/values-v23/styles.xml -->
<resources>
    <style name="AppTheme" parent="AppTheme"> <!-- 繼承基礎 AppTheme，而非直接繼承 Material -->
        <!-- Android 6.0+ 專屬屬性，如 windowDrawsSystemBarBackgrounds -->
        <item name="android:windowDrawsSystemBarBackgrounds">true</item>
        <item name="android:statusBarColor">@color/colorPrimaryDark</item>
    </style>
</resources>

4. AndroidManifest.xml 套用主題

<application
    android:theme="@style/AppTheme"
    ... >
    <activity
        android:name=".MainActivity"
        android:theme="@style/AppTheme"> <!-- 也可單獨指定 -->
    </activity>
</application>

5. Activity 繼承 AppCompatActivity

public class MainActivity extends AppCompatActivity { // 而非 Activity / ActionBarActivity
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

快速驗證與常見殘留問題

1. File → Invalidate Caches / Restart 清除 AS 渲染快取。
2. 佈局預覽上方主題下拉選單，手動選擇 `AppTheme` 或 `Theme.AppCompat.Light.DarkActionBar`。 3. 若使用 `Toolbar` 替代 ActionBar，確保佈局中 `` 命名空間正確。 4. 檢查是否混用 `android.support.v7` 與 `androidx` 依賴（遷移至 AndroidX 後需全面替換）。

進階：遷移至 AndroidX（長期維護建議）

Android 23 已屬舊版本，新專案建議直接使用 `compileSdkVersion 34` + `AndroidX`：

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.9.0'
    implementation 'androidx.recyclerview:recyclerview:1.3.1'
}
styles.xml parent="Theme.MaterialComponents.Light.DarkActionBar"
Activity extends AppCompatActivity (androidx 版)

核心原則：**compileSdk、targetSdk、Support Library 版本三者主版本號一致；自定義主題必須繼承 Theme.AppCompat 系；Activity 繼承 AppCompatActivity**。按此檢查即可消除 Rendering Problems。