Multidex

A compiled Android app doesn't ship as plain .class files — it's packaged into one or more DEX (Dalvik Executable) files. For a long time, a single DEX file could reference at most 65,536 methods, and once RecipeBox plus every library it depends on crossed that count, the build simply failed. Multidex is the fix: splitting the app's compiled code across more than one DEX file.

The 64K Method Limit

The limit comes from how the DEX format references methods internally — a method reference is a 16-bit index, so a single DEX file tops out at 65,536 method references, counting every method RecipeBox defines plus every method pulled in from Retrofit, Glide, Firebase, AndroidX, Room, and everything else on the dependency list from earlier lessons.

The Build Error

When this limit is exceeded, the build fails with a message like this:

// Typical error when the method count is exceeded
com.android.tools.r8.internal.Exception:
Cannot fit requested classes in a single dex file
(# methods: 68420 > 65536)

Enabling Multidex (minSdkVersion Below 21)

On API levels before 21 (Android 5.0), the platform's own package installer only knew how to load a single classes.dex per app, so supporting multiple DEX files required extra plumbing at app startup, provided by the androidx.multidex library.

// app/build.gradle (Groovy DSL)
android {
    defaultConfig {
        minSdk 19
        multiDexEnabled true
    }
}

dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
}

// AndroidManifest.xml
<application
    android:name="androidx.multidex.MultiDexApplication"
    ... >

MultiDexApplication vs Manual MultiDex.install()

Setting android:name to MultiDexApplication only works if RecipeBox doesn't already have its own custom Application subclass. If it does — as most real apps do, for initializing Firebase or WorkManager at startup — the same behavior is added manually instead.

// RecipeBoxApp.java
public class RecipeBoxApp extends Application {

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

Modern Projects: Mostly Automatic

Once minSdkVersion is 21 or higher, none of the manual setup above is needed at all. Android 5.0 introduced ART, which natively supports loading multiple DEX files, and the modern Android Gradle Plugin's D8 dexer automatically splits classes across DEX files whenever the method count requires it — no multiDexEnabled flag, no MultiDexApplication, no manual install call.

minSdkVersion	Multidex support	What RecipeBox needs to do
< 21	Not built into the OS	Set multiDexEnabled true + use/extend MultiDexApplication
≥ 21	Native (ART)	Nothing — D8 splits DEX files automatically when needed

Troubleshooting