当应用代码和库代码代码超过64K限制时，早期版本的构建系统会出现如下提示：

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


最近版本的构建系统会出现如下提示，指出同样的错误：

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


其实都是相同的问题，只是提示方式不一样。

关于64K限制

APK文件包含由DEX文件组成的可执行的字节码文件，包含运行app编译后的代码。DEX文件有一个65535个方法的限制，如果超过这个限制，会在构建的时候报错。这些方法包含Android Framework方法，库方法和你自己写的方法。因为65535=64*1024，所以这个限制又被称为64K限制。

Android5.0之前的版本的多dex支持

在Android5.0之前，使用Dalvik运行时来执行应用代码。默认情况下，在每个APK中，Dalvik限制一个classes.dex 字节码文件。为了突破这个限制，你可以使用multidex support library。

注意：如果你的项目配置多dex的最小SDK版本为20甚至更低，Android Stuido将禁用Instant Run。

Android5.0及以上的版本的多dex支持

Android5.0（API level 21）或更高的版本，使用ART运行时在执行应用代码。原生的支持从APK文件中直接载入多个dex文件。

避免64K限制

下面的方法可以帮助你减少dex方法的限制：

1、 查看你的app的直接的或间接的依赖：

尽量减少不必要的依赖的引用。

2、 通过ProGuard来减少未使用的代码：

通过配置ProGuard来启用ProGuard，确保你在发布版本的时候启用了压缩。

用Gradle来配置你的应用的多dex

在Android SDK Build Toos 21.1或更高的版本中，Android的Gradle插件在你的构建配置中提供了multidex的支持。在尝试配置你的multidex之前，确保你的Android SDK Build Tools和Android Support Repository升级到最新版本。

设置你的开发的app使用multidex，你需要对你的开发项目作出一些改动，遵循如下几步：

1、 更改你的Gradle构建配置来启用multidex。

2、 更改你的manifest来添加MultiDexApplication类。

更改你的build.gradle文件配置来添加支持库并且启用multidex输出，如下：

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'
}
在AndroidManifest.xml中，添加MultiDexApplication类：
<?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>


当你添加如上配置到你的app中，Android 构建工具生成一个主要的dex文件（classes.dex）和支持多个（classes2.dex，classes3.dex）。构建系统将它们打包到一个APK中发布。

多Dex支持库的局限

Multidex支持库有一些你需要了解的局限：

1、 在某种情况下可能会导致ANR问题，如果第二个dex文件过大的话。为了防止这个问题发生，你需要使用ProGuard来进行压缩。

2、 在Android4.0极其早期版本中会遇到一些问题。

3、 应用的multidex配置会需要更大的内存分配，这在Dalvik虚拟机中会导致崩溃。

4、 其他复杂的情形。

优化Multidex开发构建

Multidex配置会显著的增加构建时间，因为构建系统必须来衡量将那些类放到住Dex文件中，那些类放到第二个dex文件中。这就意味着会拖慢开发进程。

为了有效减缓构建multidex输出的时间，你需要使用Android 插件创建两个variantion：

一个开发flavor和一个生产flavor。

如下：

android {
    productFlavors {
        // Define separate dev and prod product flavors.
        dev {
            // dev utilizes minSDKVersion = 21 to allow the Android gradle plugin
            // to pre-dex each module and produce an APK that can be tested on
            // Android Lollipop without time consuming dex merging processes.
            minSdkVersion 21
        }
        prod {
            // The actual minSdkVersion for the application.
            minSdkVersion 14
        }
    }
          ...
    buildTypes {
        release {
            runProguard true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                                                 'proguard-rules.pro'
        }
    }
}
dependencies {
  compile 'com.android.support:multidex:1.0.0'
}


本文作者：宋志辉