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

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

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