MultiDexApplication vs MultiDex.install: Fixing Startup on Older Android

Confirm that legacy support is needed

This setup concerns applications supporting Android versions below API 21. Modern Android handles multiple DEX files natively. If your minimum SDK is 21 or higher, a multidex-related class name in an old tutorial is not by itself a reason to add the support library. Official multidex guidance.

Choose the least disruptive integration

Do not declare two application classes in the manifest. The final merged manifest has one android:name for the application object.

Preserve initialization order

A Kotlin fragment for the third case is:

override fun attachBaseContext(base: Context) {
    super.attachBaseContext(base)
    MultiDex.install(this)
}

This belongs inside the appropriate Application subclass, with the AndroidX dependency and imports configured. It is not a standalone file. Avoid accessing classes that require secondary DEX loading before the installation point on legacy devices.

Investigate the actual missing class

If startup still fails, record the first missing class, its package and the oldest affected OS version. Check that the final APK contains it and that release shrinking has not removed a reflective entry point. A crash occurring only in a minified release may involve keep rules rather than multidex initialization.

Compare the merged manifest with the source declaration. Build flavors or libraries can alter which application class is used, so editing one source manifest is not proof of the packaged result.

Test the boundary condition

Install the exact release build on a device or emulator representing the minimum supported Android version. Exercise cold start, process recreation and the first feature using secondary-Dex code. A successful modern-device test does not validate the legacy path.

APKLint's DEX / Smali Analyzer can reveal packaged files and structure, but it cannot execute initialization. Keep the local startup test and its logs as the evidence that your chosen integration actually works.