Android 第三方库导致jar包冲突解决办法

这几天的任务是将mapbox的工程合到程序中去，但是合并过程却出现了问题

合并方法： 
在app的build.gradle中添加

dependencies {
    compile ('com.mapbox.mapboxsdk:mapbox-android-sdk:0.7.4@aar'){
        transitive=true
    }
}

但是合并后会报错：

Error:Execution failed for task ':app:dexDebug'.
> com.android.ide.common.process.ProcessException: org.gradle.process.internal.ExecException: Process 'command '/Library/Java/JavaVirtualMachines/jdk1.7.0_79.jdk/Contents/Home/bin/java'' finished with non-zero exit value 2

这个错误是由于jar包冲突，解决方法如下：

方法一：找到冲突包，将冲突包删除，一般冲突包为'com.android.support:appcompat-v7:22.2.0'或者'com.android.support:support-v4:22.2.0'，但是我删除冲突包后，依然报错，于是使用方法二

方法二：因为我的冲突包是'com.android.support:support-v4:22.2.0'，所以找到项目根目录－build－intermediates－dex-cache－cache.xml文件，将其中跟v4有关的全部删除，然后clean project，然后将compile改为provided 
如下：

dependencies {
    compile 'com.vividsolutions:jts:1.13'
    compile 'com.squareup.okhttp:okhttp:2.4.0'
    compile 'com.squareup.okhttp:okhttp-urlconnection:2.4.0'
    compile 'com.nineoldandroids:library:2.4.0'
    compile 'com.jakewharton:disklrucache:2.0.2'
    provided 'com.android.support:support-v4:21.0.0'
}

完成后编译会报错：

Warning: Project App: provided dependencies can only be jars. com.android.support:support-v4:22.2.0 is an Android Library.

此时，点击根目录，按下F4打开project structure 
将android plugin version改为1.0.0 
如图所示：

---

此时，出现另一个错误：

Error:Execution failed for task ':app:dexDebug'.
> com.android.ide.common.internal.LoggedErrorException: Failed to run command:
    /Users/zhangkaiyue/Library/Android/sdk/build-tools/22.0.1/dx --dex --no-optimize --output /Users/zhangkaiyue/offline/android_offlinemap_cube/app/build/intermediates/dex/debug --input-list=/Users/zhangkaiyue/offline/android_offlinemap_cube/app/build/intermediates/tmp/dex/debug/inputList.txt
  Error Code:
    2
  Output:
    UNEXPECTED TOP-LEVEL EXCEPTION:
    com.android.dex.DexIndexOverflowException: method ID not in [0, 0xffff]: 65536
        at com.android.dx.merge.DexMerger$6.updateIndex(DexMerger.java:502)
        at com.android.dx.merge.DexMerger$IdMerger.mergeSorted(DexMerger.java:277)
        at com.android.dx.merge.DexMerger.mergeMethodIds(DexMerger.java:491)
        at com.android.dx.merge.DexMerger.mergeDexes(DexMerger.java:168)
        at com.android.dx.merge.DexMerger.merge(DexMerger.java:189)
        at com.android.dx.command.dexer.Main.mergeLibraryDexBuffers(Main.java:454)
        at com.android.dx.command.dexer.Main.runMonoDex(Main.java:303)
        at com.android.dx.command.dexer.Main.run(Main.java:246)
        at com.android.dx.command.dexer.Main.main(Main.java:215)
        at com.android.dx.command.Main.main(Main.java:106)

概括地说，在一个DEX文件，你可以调用很多的方法，但你只能调用它们最前面的65,536个 ，因为这是在方法调用集合中的所有的空间了。如果你的源代码和狂拽炫酷叼炸天的三方库中方法超过了这个限制，就会出现这个错误。

解决方法如下：

第一步 
添加依赖于你的build.gradle支持MultiDex库

dependencies { ... compile 'com.android.support:multidex:1.0.0' ... }

第二步 
在buildType或productFlavor中开启multiDexEnabled

defaultConfig {
        applicationId "com.shijiebang.android.mapcentral"
        minSdkVersion 14
        targetSdkVersion 21
        versionCode 1
        versionName "1.0"
        multiDexEnabled true
    }

现在，根据你的项目情况，你有3种选择：

如果你没有创建自己的Application 类，在你的清单文件AndroidManifest.xml中配置android.support.multidex.MultiDexApplication就可以了。

<application
        android:allowBackup="true"
        android:icon="@mipmap/app_icon"
        android:label="@string/app_name"
        android:name="com.shijiebang.android.mapcentral.SJBApplication"
        android:theme="@style/AppTheme"
        tools:replace="name">  //由于和第三方库有冲突，所以用tools:replace="name"
</application>

如果你有自己的Application类了，让它继承 android.support.multidex.MultiDexApplication而不是android.app.Application

如果你的Application继承了其他的类，并且你不想改变或者没办法改变。按照下面的方法重写attachBaseContext()

public class MyApplication extends FooApplication { 
    @Override protected void attachBaseContext(Context base) { 
        super.attachBaseContext(base); 
        MultiDex.install(this);
    }
}

不论你选择上面哪种，都会创建多个大小差不多的dex文件代替单个庞大的dex文件。运行的时候回同事加载所有的这些dex文件。

当年编译app的时候，Gradle会生成很多个dex文件和一个apk文件让你可以在设备或者模拟器上运行。

你可以从这个项目看到上面的效果

---

PS: 
Out of memory 问题 
对于有很多依赖的项目，编译可能因为下面的错误中断

Error:Execution failed for task ':app:dexDebug'. ... Error Code: 3 Output: UNEXPECTED TOP-LEVEL ERROR: java.lang.OutOfMemoryError: GC overhead limit exceeded at com.android.dx.cf.cst.ConstantPoolParser.parse0(ConstantPoolParser.java:326) ..

在build.gralde android标签下面添加下面代码可以解决

dexOptions { incremental true javaMaxHeapSize "4g" }

应用启动缓慢 
根据我们的经验，添加了这个支持库以后，大多数情况下都正常了。这对某些设备，比如Kindle Fire上面，应用启动会比之前慢很多。加载所有的类在应用一启动的时候会花费大量的时间。这就会导致黑屏一段时间，甚至导致ANR.