隨着安卓平臺的不斷髮展與壯大，市場上大而全的應用比比皆是，產品需求的變更累積和UI交互的極致追求，除了 resources 文件的俱增，在 Android Project 中依賴的 Library 和自己寫的 Java 代碼也會越來越多。這些變化，除了會導致打包出的 APK 文件越來越大之外，當項目中java代碼包含的方法數（method count）超出一個峯值時，編譯過程中就會出現如下錯誤：

較早版本的編譯系統中，錯誤內容如下：

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

較新版本的編譯系統中，錯誤內容如下：

1
2
3

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

儘管在不同版本的編譯系統中顯示的錯誤內容不盡相同，但都提到了一個具體的數字：65536，也就是本文要講到的核心內容，Android 64K Method Counts Limit 的峯值。詳細信息，參考官網用戶指南：Configure Apps with Over 64K Methods

Android 64K Method Counts Limit

Android Project 經過編譯打包，其中的Java代碼（包括Library）轉化爲DEX格式的字節碼文件，這是Android 5.0之前的Dalvik虛擬機決定的（5.0之後改爲ART虛擬機），並且採用short類型引用DEX文件中的method，這也爲method數量的峯值大小埋下了隱患。short類型能夠表示的最大值是65536，也就說單個DEX文件中最多隻有65536個method能夠得到引用，如果代碼執行了超出部分的method引用，自然會報錯，如methodNotFound等。1K等於1024，65536剛好是64K，爲了便於稱呼和使用，就將這個限制統稱爲64K方法數的引用限制。

爲了解決64K方法數限制的問題，我們可以在項目中使用multidex配置，當項目中的方法數（包括：Android framework，library和我們自己寫的代碼）超過64K時，編譯系統會自動編譯出多個DEX文件。

Multidex Support

Android 5.0之前，安卓系統採用的是Dalvik虛擬機，採用的是JIT技術（Just-in-time compilation，即時編譯，運行時編譯DEX字節碼文件，這也是以前爲什麼安卓手機用戶總是詬病Android系統比iOS系統運行卡頓的原因），限制每個APK文件只能包含一個DEX文件（即classes.dex）。爲了繞開這個限制，Google給我們提供了multidex support library兼容包，幫助我們實現應用程序加載多個DEX文件，並且這個兼容包作爲程序的主DEX文件，管理者其他DEX文件的訪問。

注意：由於Instant Run機制利用的就是multidex原理，當項目中minSdkVersion參數設置爲20或者更小，並且運行在Android 4.4 (API level 20)或更低版本的設備中時，Instant Run將失效。

Android 5.0之後，安卓系統改用了ART虛擬機（Android RunTime），採用的是OAT技術（Ahead-of-time，預編譯，在應用安裝的時候掃描應用中的所有DEX文件，並編譯成一個.oat格式的文件供安卓設備執行，所以相比Dalvik虛擬機下的應用，安裝時間較長）。因此可以理解爲，使用ART虛擬機下的安卓系統自動支持APK文件中多個DEX的加載。

注意：使用Instant Run時，如果項目中的minSdkVersion參數設爲21或更高版本，Android Studio編譯運行時會自動使應用支持multidex。但Instant Run僅僅作用於debug版本，我們依然需要給release版本配置multidex來避開64K方法數的限制。

Config for Multidex With Gradle

Android Gradle 插件在 Android SDK Build Tools 21.1 及更高版本的編譯工具上支持multidex作爲編譯配置的一部分，所以確保我們的Android SDK Build Tools tools已經更新至21.1或更高版本，然後再來配置應用的multidex部分。

第一步，修改app/build.grale文件，使項目能夠使用multidex：

android {

    compileSdkVersion 21
    buildToolsVersion "21.1.0"

    defaultConfig {
        ...

        // 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.yifeng.mdstudysamples">
    <application
        ...
        android:name="android.support.multidex.MultiDexApplication">
        ...
    </application>
</manifest>

添加這些配置後，編譯工具會構建出一個主DEX文件（classes.dex）和其他DEX文件（classes2.dex，classes3.dex等，如果需要的話），編譯系統會將他們打包到APK文件中。

注意：一般我們會在項目中自定義一個繼承自Application的類，此時就需要重寫attachBaseContext()方法，並在該方法裏面調用MultiDex.install(this)來支持multidex，可參考：MultiDexApplication

Optimizing Multidex Development Builds

multidex配置下的應用，編譯系統需要經過複雜的DEX分割運算，導致增加項目的編譯時間，從而影響開發人員的開發效率。我們可以使用productFlavors構建開發環境和正式環境的不同flavors來優化multidex的長時間編譯問題。

對於development flavor，設置minSdkVersion值爲21，運行在Android 5.0以上版本的設備中，使用ART-supported格式生成multidex的速度要快得多。對於release flavor，minSdkVersion值則設爲應用實際支持的版本，編譯系統耗費較長的時間來生成適配多設備的multidex APK文件。如：

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

這樣，在開發階段，使用devDebug類型的變種app，取消混淆，支持multidex，並且運行在5.0及以上版本的設備中，能夠加快編譯過程。有關flavors的信息，以前寫過一篇文章：Android 利用Gradle實現app的環境分離，更多信息可以參考英文手冊：Gradle Plugin User Guide，對應中文版譯文：Gradle Android插件用戶指南翻譯。