为方法数超过 64K 的应用启用多 dex 文件
当您的应用及其引用的库超过 65536 个方法时,您会遇到一个编译错误,指明您的应用已达到 Android 编译架构规定的引用限制:
trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.
较低版本的编译系统会报告一个不同的错误,但指示的是同一个问题:
Conversion to Dalvik format failed:
Unable to execute dex: method ID not in [0, 0xffff]: 65536
这种错误情况都会显示一个共同的数字:65536。此数字表示单个 Dalvik Executable(DEX)字节码文件内的代码可调用的引用总数。该文章主要介绍如何通过启用称为“多 DEX 文件”的应用配置(该配置使您的应用能够编译和读取多个 DEX 文件)来越过这一限制。
关于 64K 引用限制
Android 应用(APK)文件包含 Dalvik Executable(DEX)文件形式的可执行字节码文件,这些文件包含用来运行您的应用的已编译代码。Dalvik Executable 规范将可在单个 DEX 文件内引用的方法总数限制为 65536,其中包括 Android 框架方法、库方法以及您自己代码中的方法。由于 65536 等于 64 * 1024,因此这一限制成为“64K 引用限制”。
Android 5.0 之前版本的多 dex 文件支持
Android 5.0(API Level 21)之前的平台版本使用 Dalvik 运行时来执行应用代码。默认情况下,Dalvik 将应用限制为每个 APK 只能使用一个 classes.dex 字节码文件。要绕过这一限制,您可以在您的项目中添加多 dex 文件支持库:
dependencies {
implementation 'androidx.multidex:multidex:2.0.1'
}
如果您不使用 AndroidX,请改为添加以下支持库依赖项:
dependencies {
implementation 'com.android.support:multidex:1.0.3'
}
此库会成为应用的主要 DEX 文件的一部分,然后管理对其他 DEX 文件及其包含的代码访问。如需了解详情,请参与下面有关下面介绍针对多 dex 文件配置您的应用的部分。
注意:如果为您的项目配置的多 dex 文件使用的是 minSdkVersion 20 或更低版本,而您将其部署到运行 Android 4.4(API Level 20)或更低版本系统的目标设备上,则 Android Studio 会停用 Instant Run。
Android 5.0 及更高版本的多 dex 文件支持
Android 5.0(API 级别 21)及更高版本使用名为 ART 的运行时,它本身支持从 APK 文件加载多个 DEX 文件。ART 在应用安装时执行预编译,扫描 classesN.dex 文件,并将它们编译成单个 .oat 文件,以供 Android 设备执行。因此,如果您的 minSdkVersion 为 21 或更高的值,则不需要多 dex 文件支持库。
注意:使用 Instant Run 时,如果将应用的 minSdkVersion 设为 21 或更高的值,Android Studio 会自动针对多 dex 文件配置您的应用。由于 Instant Run 仅适用于调试版本的应用,因此您仍然需要针对多个 dex 文件配置