Android gradle 编译 MultiDex

当Android系统启动一个应用的时候，有一步是对Dex进行优化，这个过程有一个专门的工具来处理，叫DexOpt。DexOpt的执行过程是在第一次加载Dex文件的时候执行的。这个过程会生成一个ODEX文件，即Optimised Dex。执行ODex的效率会比直接执行Dex文件的效率要高很多。但是Android系统中，DexOpt有一个问题，DexOpt会把每一个类的方法id检索起来，存在一个链表结构里面。但是这个链表的长度是用一个short类型来保存的，导致了方法id的数目不能够超过65536个。当一个项目足够大的时候，显然这个方法数的上限是不够的。

解决这个问题的方法主要有两种：MultiDex 和 APK插件化——参见我之前地博客 http://blog.csdn.net/wangbaochu/article/details/45340983

一、下面主要介绍如何用gradle 编译分割Dex？

使用google提供的android-support-multidex.jar，这个jar包最低可以支持到API 4的版本 (Android 5.0及以上版本会默认支持 multidex )

• 需要使用gradle编译，如果是使用eclipse开发需要安装gradle插件， 然后将项目转换成gradle项目
• 使用gradle进行打包，编译工具最低版本19，低版本中有但是高版本没有的方法会报错，需要重新处理，例如WebView.enablePlatformNotifications()方法

二、用Android stuido Gradle编译，需要引用android-support-mulidex.jar，该jar库已经集成到 android-support-v4 版本22.1.1及以上
– 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'
    }
  }
}

–4.将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=方法数量']
    }
}