声明主 DEX 文件中需要的类
为 Dalvik 可执行文件分包构建每个 DEX 文件时,构建工具会执行复杂的决策制定来确定主要 DEX 文件中需要的类,以便应用能够成功启动。如果启动期间需要的任何类未在主 DEX 文件中提供,那么您的应用将崩溃并出现错误java.lang.NoClassDefFoundError。
该情况不应出现在直接从应用代码访问的代码上,因为构建工具能识别这些代码路径,但可能在代码路径可见性较低(如使用的库具有复杂的依赖项)时出现。例如,如果代码使用自检机制或从原生代码调用 Java 方法,那么这些类可能不会被识别为主 DEX 文件中的必需项。
因此,如果您收到java.lang.NoClassDefFoundError,则必须使用构建类型中的multiDexKeepFile或multiDexKeepProguard属性声明它们,以手动将这些其他类指定为主 DEX 文件中的必需项。如果类在multiDexKeepFile或multiDexKeepProguard文件中匹配,则该类会添加至主 DEX 文件。
您在multiDexKeepFile中指定的文件应该每行包含一个类,并且采用com/example/MyClass.class的格式。例如,您可以创建一个名为multidex-config.txt的文件,如下所示:
com/example/zyq/myapplication/MultidexMothod3.class
然后,您可以按以下方式针对构建类型声明该文件:
multiDexKeepFile file('multidex-config.txt')
请记住,Gradle 会读取相对于build.gradle文件的路径,因此如果multidex-config.txt与build.gradle文件在同一目录中,以上示例将有效。
multiDexKeepProguard文件使用与 Proguard 相同的格式,并且支持整个 Proguard 语法。如需了解有关 Proguard 格式和语法的详细信息,请参阅 Proguard 手册中的Keep Options一节。
您在multiDexKeepProguard中指定的文件应该在任何有效的 ProGuard 语法中包含-keep选项。例如,-keep com.example.MyClass.class。您可以创建一个名为multidex-config.pro的文件,如下所示:
````
-keep class com.example.zyq.myapplication.MultidexMothod4
````
如果您想要指定包中的所有类,文件将如下所示:
````
-keep class com.example.** { *; } // All classes in the com.example package
````
然后,您可以按以下方式针对构建类型声明该文件:
````
multiDexKeepProguard file('multidex-config.pro')
````
因为对MultidexMothod3和MultidexMothod4作了声明
所以
这两个类被打包在了主dex文件classes.dex中
剩余的1,2,5别打包在classes2.dex了
另外可能会遇到的问题:
1. Dalvik LinearAlloc Limit
Installation error: INSTALL_FAILED_DEXOPT
Please check logcat output for more details.
Launch canceled!
Application causes dalvik crash on gingerbread devices:
LinearAlloc exceeded capacity (8388608), last=6888
VM aborting Fatal signal 11 (SIGSEGV) at 0xdeadd00d (code=1)
2. 首次安装启动时黑屏没有响应/ANR
这个问题:是由于Multidex 分包之后,主Dex的包过大,启动慢导致的。针对这个问题有以下解决方案:
(1).设置Multidex的分包参数,限制包的大小
a. --set-max-idx-number 用于限制每个dex的方法总数,设置为48000(经验值)可解决2.X系统上multidex导致的LinearAlloc Limit问题。
b. --minimal-main-dex 设置此参数后可让主dex的方法数尽可能的小,可以同--set-max-idx-number配合使用解决LinearAlloc Limit问题。
````
dexOptions {
javaMaxHeapSize "4g"
additionalParameters = [//dex参数详见 dx --help
'--multi-dex',//多分包
'--set-max-idx-number=45000',//每个包内方法数上限
// '--main-dex-list='+projectDir+'/maindexlist.txt',//打包进主classes.dex的文件列表
// '--minimal-main-dex'//使上一句生效
]
}
````