android 多dex处理

为方法数超过 64K 的应用启用多 dex 文件

当您的应用及其引用的库超过 65,536 种方法时,您会遇到一个编译错误,指明您的应用已达到 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 文件内引用的方法总数限制为 65,536,其中包括 Android 框架方法、库方法以及您自己的代码中的方法。在计算机科学领域内,术语千(简称 K)表示 1024(或 2^10)。由于 65,536 等于 64 X 1024,因此这一限制称为“64K 引用限制”。

Android 5.0 之前版本的多 dex 文件支持

Android 5.0(API 级别 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 级别 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 文件支持库。

如需详细了解 Android 5.0 运行时,请阅读 ART 和 Dalvik

注意:使用 Instant Run 时,如果将应用的 minSdkVersion 设为 21 或更高的值,Android Studio 会自动针对多 dex 文件配置您的应用。由于 Instant Run 仅适用于调试版本的应用,因此您仍然需要针对多 dex 文件配置发布版本,以规避 64K 限制。

规避 64K 限制

在将您的应用配置为支持使用 64K 或更多方法引用之前,您应该采取措施来减少应用代码调用的引用总数,包括由您的应用代码或包含的库定义的方法。以下策略可帮助您避免达到 DEX 引用限制:

  • 检查应用的直接和传递依赖项

猜你喜欢

转载自blog.csdn.net/qq_18757557/article/details/102823074