Android Multidex正确使用方式（你可能也会遇到的坑）

最新推荐文章于 2024-07-12 04:12:13 发布

贵公子

最新推荐文章于 2024-07-12 04:12:13 发布

阅读量7.6k

点赞数 2

分类专栏：开源框架/项目

开源框架/项目专栏收录该内容

377 篇文章 5 订阅

订阅专栏

一、概述

Android 应用 (APK) 文件包含 Dalvik Executable (DEX) 文件形式的可执行字节码文件，其中包含用来运行您的应用的已编译代码。Dalvik Executable 规范将可在单个 DEX 文件内可引用的方法总数限制在 65,536，其中包括 Android 框架方法、库方法以及您自己代码中的方法。在计算机科学领域内，术语千（简称 K）表示 1024（或 2^10）。由于 65,536 等于 64 X 1024，因此这一限制也称为“64K 引用限制”，详细介参考谷歌官方配置文档。
谷歌官方配置使用文档

二、Multidex使用简单配置

// 1. Gralde 配置
android {
    defaultConfig {
        ...
        minSdkVersion 15 
        targetSdkVersion 28
        multiDexEnabled true
    }
    ...
}

dependencies {
api ‘com.android.support:multidex:1.0.3’
api ‘com.android.support:multidex-instrumentation:1.0.3’
}

// 2. 清单配置
<?xml version=“1.0” encoding=“utf-8”?>
<manifest xmlns:android=“http://schemas.android.com/apk/res/android”
package=“com.example.myapp”>
<application
android:name=“com.xxx.MyApplication” >
…
</application>
</manifest>

// 3. Application初始化
public class MyApplication extends SomeOtherApplication {
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
MultiDex.install(this);
}
}

如果就这么简单我写这个也没什么意义，最主要看下面的高配置，和我所遇到的坑。

四、高级配置，multiDexKeepFile 属性

如果APP安装失败，调试日志出现 NoClassDefFoundError、ClassNotFoundException、NoSuchMethodException等异常，就需要将这些找不到的类，配置到主的DEX 文件中，以至于在APP初始化的时候能找到这些类。
配置方法：

在build.gradle文件同级目录下创建一个multidex-config.txt（这里随便命名）配置文件。
在文件中添加找不到的类，如下所示：
com/example/MyClass.class// 普通类配置方式
com/example/MyOtherClass$InnerClass.class// 内部类配置方式
在配置multidex-config.txt前，先release一遍，找到app/build/intermediates/multi-dex/release/maindexlist.txt这个文件的所有内容复制到multidex-config.txt文件中。maindexlist.txt里面的内容是通过一系统列方法算出APP启动所关联的类。

maindexlist文件目录.jpg
在build.gradle文件配置

android {
    buildTypes {
        release {
            multiDexKeepFile file ('multidex-config.txt')// 小括号记得要加上，官方文档没有
            ...
        }
    }
}

每个包内方法数上限配置(对低端机型很重要)

 dexOptions {
        javaMaxHeapSize "4g"
        preDexLibraries = false
        additionalParameters += '--multi-dex'
        additionalParameters += '--set-max-idx-number=35000'//每个包内方法数上限（根据实际项目配置这个数，来适配4.0-4.4一些低端机型，因为拆分的dex太大，这些低端机型加载不了dex）
        additionalParameters += '--minimal-main-dex'
    }

注意：每个dex(claasses.dex、claasses1.dex、claasses2.dex...)内方法数上限（根据实际项目配置这个数，来适配4.0-4.4一些低端机型，因为拆分的dex太大，这些低端机型加载不了dex），这个数也不能太小，最多能分7个DEX。

三、高级配置，multiDexKeepProguard 属性

目的是怕上面那些配置的类混淆导致APP启动失败，所配置，如果APP本来就没有混淆，就不用管这个配置了。
在build.gradle文件同级目录下创建一个multidex-config.pro（这里随便命名）配置文件。
配置内容如下所示（和混淆其实是一样）：
-keep class com.example.MyClass // 保持这个类不混淆
-keep class com.example.** { *; }//保持这个包下的所有类不混淆
build.gradle文件中配置

android {
    buildTypes {
        release {
            multiDexKeepProguard ('multidex-config.pro')
            ...
        }
    }
}

五、总结

Multidex使用有很多坑，尽量将自己的APP去三方平台做云真机兼容性测试。如阿里移动测试、testin云测试等，推荐去云测试上去做真机调试，调试完有调试日志。
在三方平台用真机调试一些不能过的机型，调试运行失败后，下载调试日志，就可以找到上面我讲的那几个错误。
如果没有类找不到那些异常，对于下面这些错误：
DexOpt: --- END 'cn.xxx.xxx-1.apk.classes4.zip' --- status=0x000e, process failed
MultiDex installation failure
java.io.IOException: unable to open DEX file
是Dex太大，在低端机型加载失败所致。如果你的Dex不能在小了，你就放弃这些机型吧（没办法了，如果有好的方法请告诉我）。
看一下我的测试成果，其实还是有些机型不行的，但对我们APP的用户来讲，应该是没什么影响的了。

测试成果.jpg

转自:https://www.jianshu.com/p/78f2e2d9484a