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