声明主 DEX 文件中需要的类

为 Dalvik 可执行文件分包构建每个 DEX 文件时，构建工具会执行复杂的决策制定来确定主要 DEX 文件中需要的类，以便应用能够成功启动。如果启动期间需要的任何类未在主 DEX 文件中提供，那么您的应用将崩溃并出现错误java.lang.NoClassDefFoundError。

该情况不应出现在直接从应用代码访问的代码上，因为构建工具能识别这些代码路径，但可能在代码路径可见性较低（如使用的库具有复杂的依赖项）时出现。例如，如果代码使用自检机制或从原生代码调用 Java 方法，那么这些类可能不会被识别为主 DEX 文件中的必需项。

因此，如果您收到java.lang.NoClassDefFoundError，则必须使用构建类型中的multiDexKeepFile或multiDexKeepProguard属性声明它们，以手动将这些其他类指定为主 DEX 文件中的必需项。如果类在multiDexKeepFile或multiDexKeepProguard文件中匹配，则该类会添加至主 DEX 文件。

multiDexKeepFile 属性

您在multiDexKeepFile中指定的文件应该每行包含一个类，并且采用com/example/MyClass.class的格式。例如，您可以创建一个名为multidex-config.txt的文件，如下所示：

com/example/zyq/myapplication/MultidexMothod3.class

然后，您可以按以下方式针对构建类型声明该文件：

multiDexKeepFile file('multidex-config.txt')

image

请记住，Gradle 会读取相对于build.gradle文件的路径，因此如果multidex-config.txt与build.gradle文件在同一目录中，以上示例将有效。

multiDexKeepProguard 属性

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')

image

因为对MultidexMothod3和MultidexMothod4作了声明

所以

image

这两个类被打包在了主dex文件classes.dex中

image

剩余的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问题。

image

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'//使上一句生效
        ]
}