Android gradle 编译 MultiDex

转帖：http://blog.csdn.net/wangbaochu/article/details/46536635

当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文件中添加：

[html] view plaincopy

1. android {  
2.     compileSdkVersion 21  
3.     buildToolsVersion "21.1.0"  
4.   
5.     defaultConfig {  
6.         ...  
7.         minSdkVersion 14  
8.         targetSdkVersion 21  
9.         ...  
10.   
11.         // Enabling multidex support.  
12.         multiDexEnabled true  
13.     }  
14.     ...  
15. }  
16.   
17. dependencies {  
18.   compile 'com.android.support:multidex:1.0.0'  
19. }  

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

[html] view plaincopy

1. afterEvaluate {  
2.   tasks.matching {  
3.     it.name.startsWith('dex')  
4.   }.each { dx ->  
5.     if (dx.additionalParameters == null) {  
6.       dx.additionalParameters = ['--multi-dex']  
7.     } else {  
8.       dx.additionalParameters += '--multi-dex'  
9.     }  
10.   }  
11. }  

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

[html] view plaincopy

1. <manifest xmlns:android="http://schemas.android.com/apk/res/android"  
2.     package="com.example.android.multidex.myapplication">  
3.     <application  
4.         ...  
5.         android:name="android.support.multidex.MultiDexApplication">  
6.         ...  
7.     </application>  
8. </manifest>  

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

[java] view plaincopy

1. @Override   
2. protected void attachBaseContext(Context base) {  
3.   super.attachBaseContext(base)  
4.   MultiDex.install(this)  
5. }  

三、可能出现的错误
1. com.android.dex.DexException: Library dex files are not supported in multi-dex mode 
   解决方法，在gradle.build中添加如下代码：

[html] view plaincopy

1. subprojects {  
2.   project.plugins.whenPluginAdded { plugin ->  
3.     if ("com.android.build.gradle.AppPlugin".equals(plugin.class.name)) {  
4.       project.android.dexOptions.preDexLibraries = false  
5.     } else if ("com.android.build.gradle.LibraryPlugin".equals(plugin.class.name)) {  
6.       project.android.dexOptions.preDexLibraries = false  
7.     }  
8.   }  
9. }  

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中添加如下代码：

[html] view plaincopy

1. afterEvaluate {  
2.     tasks.matching {  
3.         it.name.startsWith('dex')  
4.     }.each { dx ->  
5.         if (dx.additionalParameters == null) {  
6.             dx.additionalParameters = ['--multi-dex']  
7.         } else {  
8.             dx.additionalParameters += '--multi-dex'  
9.         }  
10.         // optional       
11.         dx.additionalParameters = ['--set-max-idx-number=方法数量']  
12.     }  
13. }  

转帖：http://blog.csdn.net/wangbaochu/article/details/46536635