Android 4.x 多 Dex 啟用 multiDexEnabled 導致 NoClassDefFoundError 解決方案

錯誤現象

專案啟用 multiDexEnabled true 後，Android 5.0 以上裝置正常，但 4.x 裝置啟動崩潰：

java.lang.NoClassDefFoundError: android.support.v7.appcompat.R$layout

根本原因

Android 5.0 (API 21) 內建支援多 Dex（ART 執行環境可自動合併多個 classes.dex）。5.0 以下（Dalvik）僅載入主 Dex，若啟動所需類（如 Application、核心元件）被編入副 Dex，則找不到類別。

完整解決步驟

1. build.gradle 啟用並加入依賴：

android {
    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 21
        multiDexEnabled true
    }
}
dependencies {
    implementation 'com.android.support:multidex:1.0.3'
}

2. Application 類 繼承 MultiDexApplication 或覆寫 attachBaseContext：

public class MyApp extends MultiDexApplication { ... }

或

@Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(base);
    MultiDex.install(this);
}

3. Manifest 指定 Application：

<application android:name=".MyApp" ... > ... </application>

驗證建議

• 使用 adb shell pm list packages -f 確認安裝的 APK 包含多個 dex。
• 在 4.x 模擬器/真機測試冷啟動、熱啟動、類加載路徑。

參考來源

Google 官方文件：Configure apps with over 64K methods