Android配置方法数超过64K的限制

客官°小女子只卖身不卖艺 2022-07-11 01:59 184阅读 0赞

## Android配置方法数超过64K的限制 ##

随着 Android 平台的持续成长，Android 应用的大小也在增加。当您的应用及其引用的内容库达到特定大小时，您会遇到构建错误，指明您的应用已达到 Android 应用构建架构的极限。早期版本的构建系统按如下方式报告这一错误：

Conversion to Dalvik format failed:
    Unable to execute dex: method ID not in [0, 0xffff]: 65536

较新版本的 Android 构建系统虽然显示的错误不同，但指示的是同一问题：

trouble writing output:
    Too many field references: 131000; max is 65536.
    You may try using --multi-dex option.

这些错误状况都会显示下面这个数字：65536。这个数字很重要，因为它代表的是单个 Dalvik Executable (dex) 字节码文件内的代码可调用的引用总数。如果您构建的 Android 应用收到了这个错误，那么恭喜您，您有许多代码了！本文介绍如何越过这一限制，继续构建您的应用。

--------------------

#### 关于 64K 引用限制 ####

Android 应用 (APK) 文件包含 Dalvik Executable (DEX) 文件形式的可执行字节码文件，其中包含用来运行您的应用的已编译代码。Dalvik Executable 规范将可在单个 DEX 文件内可引用的方法总数限制在 65,536，其中包括 Android 框架方法、内容库方法以及您自己代码中的方法。在计算机科学领域内，术语千（简称 K）表示 1024（或 2^10）。由于 65,536 等于 64 X 1024，因此这一限制也称为“64K 引用限制”。

越过这一限制需要您将应用构建流程配置为生成多个 DEX 文件，这种配置称为 Dalvik 可执行文件分包配置。

##### Android 5.0 之前版本的 Dalvik 可执行文件分包支持 #####

Android 5.0（API 级别 21）之前的平台版本使用 Dalvik 运行时来执行应用代码。默认情况下，Dalvik 限制应用的每个 APK 只能使用单个 classes.dex 字节码文件。要想绕过这一限制，您可以使用 Dalvik 可执行文件分包支持库，它会成为您的应用主要 DEX 文件的一部分，然后管理对其他 DEX 文件及其所包含代码的访问。

*如果您的项目配置时所面向的 Dalvik 可执行文件分包使用的是 minSdkVersion 20 或更低版本，并且您将其部署到运行 Android 4.4（API 级别 20）或更低版本系统的目标设备上，Android Studio 会停用 Instant Run*

##### Android 5.0 及更高版本的 Dalvik 可执行文件分包支持 #####

Android 5.0（API 级别 21）及更高版本使用名为 ART 的运行时，后者原生支持从应用 APK 文件加载多个 dex 文件。ART 在应用安装时执行预编译，扫描 classes(..N).dex 文件，并将它们编译成单个 .oat 文件，供 Android 设备执行。如需了解有关 Android 5.0 运行时的详细信息，请参阅 ART 简介。

*如果将应用的 minSdkVersion 设置为 21 或更高，使用 Instant Run 时，Android Studio 会自动将应用配置为进行 Dalvik 可执行文件分包。由于 Instant Run 仅适用于调试版本的应用，您仍需配置发布构建进行 Dalvik 可执行文件分包，以规避 64K 限制。*

--------------------

#### 规避 64K 限制 ####

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

*  **检查您的应用的直接和传递依赖项**
    
    确保您在应用中使用任何庞大依赖库所带来的好处大于为应用添加大量代码所带来的弊端。一种常见的反面模式是，仅仅为了使用几个实用方法就在应用中加入非常庞大的内容库。减少您的应用代码依赖项往往能够帮助您规避 dex 引用限制。
 *  **通过ProGuard移除未使用的代码**
    
    为您的应用配置 ProGuard 设置以运行 ProGuard，并确保为发布构建启用压缩。启用压缩可确保您交付的 APK 不含有未使用的代码。

运用这些技巧可帮助您避免为了在应用中支持更多的方法引用而需要进行的构建配置变更。这些措施还可以减小APK的大小，这对带宽成本较高的市场特别重要。

--------------------

#### 通过 Gradle 配置您的应用进行 Dalvik 可执行文件分包 ####

Android SDK Build Tools 21.1 及更高版本中提供的 Android Plugin for Gradle 支持以 Dalvik 可执行文件分包作为构建配置的一部分。请您务必使用 SDK 管理器将 Android SDK Build Tools 工具和 Android 支持存储区更新至最新版本，然后再尝试配置您的应用进行 Dalvik 可执行文件分包。

将您的应用开发项目设置为使用 Dalvik 可执行文件分包配置需要对您的应用开发项目做几项修改。具体地讲，您需要执行以下步骤：

*  **将您的Gradle构建配置更改为启用Dalvik可执行文件分包**
 *  **修改您的清单以引用MultiDexApplication类**

修改模块级 build.gradle 文件配置以加入支持库和启用 Dalvik 可执行文件分包输出，如下面这段代码中所示：

android {
        compileSdkVersion 21
        buildToolsVersion "21.1.0"
    
        defaultConfig {
            ...
            minSdkVersion 14
            targetSdkVersion 21
            ...
    
            // Enabling multidex support.
            multiDexEnabled true
        }
        ...
    }
    
    dependencies {
      compile 'com.android.support:multidex:1.0.0'
    }

在您的清单中，将 Dalvik 可执行文件分包支持库中的 MultiDexApplication 类添加到 application 元素中。

<?xml version="1.0" encoding="utf-8"?>
    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.android.multidex.myapplication">
        <application
            ...
            android:name="android.support.multidex.MultiDexApplication">
            ...
        </application>
    </manifest>

#### 测试 Dalvik 可执行文件分包应用 ####

编写面向 Dalvik 可执行文件分包应用的仪器测试时，无需进行其他配置。使用 MultiDexApplication 或替换您的自定义 Application 对象中的 attachBaseContext() 方法，并调用 MultiDex.install(this) 以启用 Dalvik 可执行文件分包。

您也可以替换 Application 中的 onCreate() 方法：

public void onCreate(Bundle arguments) {
        MultiDex.install(getTargetContext());
        super.onCreate(arguments);
        ...
    }

#### Dalvik 可执行文件分包支持库的局限性 ####

Dalvik 可执行文件分包支持库具有一些已知的局限性，将其纳入您的应用构建配置之中时，您应该注意这些局限性并进行针对性的测试：

*  启动期间向设备数据分区中安装 .dex 文件的过程相当复杂，如果辅助 dex 文件较大，可能导致应用无响应 (ANR) 错误。在此情况下，您应该通过 ProGuard 运用代码压缩技巧来尽量减小 dex 文件的大小，并移除未使用的那部分代码。
 *  由于存在 Dalvik linearAlloc 错误（问题 22586），使用 Dalvik 可执行文件分包的应用可能无法在运行的平台版本低于 Android 4.0（API 级别 14）的设备上启动。如果您的目标 API 级别小于 14，请务必针对这些版本的平台进行测试，因为您的应用可能会在启动时或加载特定类群时出现问题。代码压缩可以减少甚至有可能消除这些潜在问题。
 *  由于存在 Dalvik linearAlloc 限制（问题 78035），如果使用 Dalvik 可执行文件分包配置的应用发出非常庞大的内存分配请求，可能会在运行时发生崩溃。尽管 Android 4.0（API 级别 14）提高了分配限制，但在 Android 5.0（API 级别 21）之前的 Android 版本上，应用仍有可能遭遇这一限制。
 *  系统对于主 dex 文件在 Dalvik 运行时中执行时需要哪些类有着复杂的要求。Android 构建工具更新会处理这些 Android 要求，但所包括的其他内容库也可能具有其他依赖项要求，包括使用自检机制，或从原生代码调用 Java 方法。一些内容库可能要等到 Dalvik 可执行文件分包构建工具在更新后允许您对必须包括在主 dex 文件中的类进行指定时才能使用。

--------------------

原文地址：[配置方法数超过 64K 的应用][64K]

[64K]: https://developer.android.google.cn/studio/build/multidex.html#mdex-gradle