报这个错误,是因为你项目里面的方法已经超过65536个了。原因如下:

在Android系统中,一个App的所有代码都在一个Dex文件里面。Dex是一个类似Jar的存储了多有Java编译字节码的归档文件。因为Android系统使用Dalvik虚拟机,所以需要把使用Java Compiler编译之后的class文件转换成Dalvik能够执行的class文件。这里需要强调的是,Dex和Jar一样是一个归档文件,里面仍然是Java代码对应的字节码文件。当Android系统启动一个应用的时候,有一步是对Dex进行优化,这个过程有一个专门的工具来处理,叫DexOpt。DexOpt的执行过程是在第一次加载Dex文件的时候执行的。这个过程会生成一个ODEX文件,即Optimised Dex。执行ODex的效率会比直接执行Dex文件的效率要高很多。但是在早期的Android系统中,DexOpt有一个问题,DexOpt会把每一个类的方法id检索起来,存在一个链表结构里面。但是这个链表的长度是用一个short类型来保存的,导致了方法id的数目不能够超过65536个。当一个项目足够大的时候,显然这个方法数的上限是不够的。


解决这个问题的方法:
  • 1.使用插件化框架。
  • 2.分割Dex。使用google提供的android-support-multidex.jar。这个jar包最低可以支持到API 4的版本(Android L及以上版本会默认支持mutidex).(Note:1.需要使用gradle编译,如果是使用eclipse开发需要安装gradle插件, 然后将项目转换成gradle项目。2.使用gradle进行打包,编译工具最低版本19,低版本中有但是高版本没有的方法会报错,需要重新处理,例如WebView.enablePlatformNotifications()方法
  • 3.精简项目里面的方法。通常开发者自己的代码很难达到这样的方法数量限制,但随着第三方类库的加入,方法数就会迅速膨胀。因此选择合适的类库对Android开发者来说尤为重要。
    以下是一些方法比较多的库。

针对方法二的解决步骤 使用Android stuido Gradle编译,手动引用android-support-mulidex.jar

– 1.将普通的eclipse项目转换成gradle项目。方法是在eclipse上面装一个gradle插件,然后将项目导出成gradle项目即可。
– 2.将转化好的gradle的项目导入studio中。在build.gradle文件中添加

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

–3.为了使mul-dex 命令能够正常使用,需要在gradle.build文件里面加入如下代码:

afterEvaluate {
  tasks.matching {
    it.name.startsWith('dex')
  }.each { dx ->
    if (dx.additionalParameters == null) {
      dx.additionalParameters = ['--multi-dex']
    } else {
      dx.additionalParameters += '--multi-dex'
    }
  }
}

–3.将android-support-mulidex.jar 导入工程中。如果应用的application没有继承其他的application类,可以在mainifest中修改为:

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

或者在你应用的applicaton类中 添加如下代码:

@Override protected void attachBaseContext(Context base) {
  super.attachBaseContext(base)
  MultiDex.install(this)
}
可能出现的错误
  • 1 .com.android.dex.DexException: Library dex files are not supported in multi-dex mode
    解决方法,在gradle.build中添加如下代码
subprojects {
  project.plugins.whenPluginAdded { plugin ->
    if ("com.android.build.gradle.AppPlugin".equals(plugin.class.name)) {
      project.android.dexOptions.preDexLibraries = false
    } else if ("com.android.build.gradle.LibraryPlugin".equals(plugin.class.name)) {
      project.android.dexOptions.preDexLibraries = false
    }
  }
}
  • 2.Multi Define Unzip XXXXXX 之类问题。
    检查项目里面是否有重复引用某些jar包,不要在dependency里面 再添加lib下面 android-support-multidex.jar的引用
  • 3 编译成功的文件无法再2.2或者2.3系统上正常运行,报错为INSTALL_FAILED_DEXOPT
    出现这个问题的原因是:第一个编译出来的dex文件大于5M,低系统安装dex限制在5M
    以下,所以无法安装。解决方法,在gradle.build中添加如下代码:
afterEvaluate {
    tasks.matching {
        it.name.startsWith('dex')
    }.each { dx ->
        if (dx.additionalParameters == null) {
            dx.additionalParameters = ['--multi-dex']
        } else {
            dx.additionalParameters += '--multi-dex'
        }
        // optional     
        dx.additionalParameters = ['--set-max-idx-number=方法数量']
    }
}

后记:

第一次认真的去整理一个问题,以前遇到很多问题都没有认真去总结,这个分阶段编译问题也是断断续续弄了一个星期。弄清楚一个问题之后去写一些东西总结巩固一下是很有必要的,可以帮助自己提升。