一、概述
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 {
compile 'com.android.support:multidex: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
// 内部类配置方式 -
在配置
maindexlist文件目录.jpgmultidex-config.txt
前,先release一遍,找到app/build/intermediates/multi-dex/release/maindexlist.txt
这个文件的所有内容复制到multidex-config.txt
文件中。maindexlist.txt
里面的内容是通过一系统列方法算出APP启动所关联的类。
-
在build.gradle文件配置
android {
buildTypes {
release {
multiDexKeepFile file ('multidex-config.txt')// 小括号记得要加上,官方文档没有
...
}
}
}
- 每个包内方法数上限配置(对低端机型很重要)
dexOptions {
javaMaxHeapSize "4048M"
additionalParameters = [//dex参数详见 dx --help
'--multi-dex',//多分包
'--set-max-idx-number=28000'//每个包内方法数上限(根据实际项目配置这个数,来适配4.0-4.4一些低端机型,因为拆分的dex太大,这些低端机型加载不了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
网友评论