方法数超出 65536 限制

错误原因

有时用户集成完 TuSDK 之后会报如下形式的错误：

 UNEXPECTED TOP-LEVEL EXCEPTION:
  java.lang.IllegalArgumentException: 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.

这是因为项目中引用了太多的方法导致打包时 Dalvik Executable (DEX) 文件中的方法数超过了 65536 的限制引起的。

解决方法

Android Studio 允许用户通过 Gradle 的设置来使用多个 DEX 文件，这样每个文件中的方法数就会减少，也就可以绕过这个限制，该方法分为两步进行：

修改 build.gradle 文件

修改项目的 build.gradle 文件启用 MultiDex 并包含 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'
}

修改 manifest 文件

<?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>

如果用户不想在 manifest 文件中将 MultiDexApplication 指定为全局 Application，而是想继续使用原先指定的 Application， 则可以在全局 Application 中重写 attachBaseContext() 方法，并加上 MultiDex.install(this)，如下：

 @Override
 protected void attachBaseContext(Context base) {
     super.attachBaseContext(base);
     MultiDex.install(this);
}

更详细的内容请参考Google 官方文档。