Caused by: java.lang.RuntimeException: com.android.builder.dexing.DexArchiveMergerException: Error

问题描述

最近在重构以前的一个Android项目，导入后无法运行，报错如下：

Caused by: java.lang.RuntimeException: com.android.builder.dexing.DexArchiveMergerException: Error while merging dex archives: D:\...

稍微操作一下以后，又得到报错如下：

Error: Program type already present: android.support.v4.app.BackStackRecord$Op

---

产生原因

找了很多的文章，也看了很多的技术文档，大致发现了原因

之所以产生这样的问题，我个人认为，可以简单地概括为：

你的Android Studio更新，包括你的Gradle以及对应版本的更新，随之而更新，带动了Gradle中某些特性的升级。问题其实是出在你的dependency里，也就是说你的依赖关系出了问题。

打开你的Project视图下的工程目录，查看Project下的build.gradle文件，操作方法如下图所示

如果这个文件很长，翻到下面的这个地方

此处以compile开头的语句（也有可能是以implementation开头，有细微的差别，具体区别见我的另外一篇博客https://blog.csdn.net/qq_24118527/article/details/82873812）表示当前你Project的依赖文件，可以简单地理解成外部的库

• 若你引用的外部库不多

你可以直接去github上面找对应库的issue，会有人提供相应的解决方法（这个问题很多人都遇到了），比如这种解决方法：

这种解决方法实际上是处理了一些库之间的依赖关系

可以简单的理解为，我之前有一句语句引用了android.support.v4这个库

现在我引用了一个新的库，但是这个库里面也引用了android.support.v4这个库

那么同时引用的这两个库就会产生一些冲突，此时可以用如上图所示的方法

相当于我在新引用的库里面exclude掉一些重复的东西

• 若你引用的外部库很多

这时就比较麻烦了，也就是我遇到的情况

我这个Project中用到的库可能有10来个吧，很难确定到底是哪个库出了问题，一个个去找也会比较麻烦

在解决这个问题的过程中，我查看了许多的博客以及官方文档，但是依然没有一个完美的解决方案，但是摸索出了一个折衷的方法，仅供大家参考

---

进一步的分析

首先你要查看你的三个version，也就是：

• compileSdkVersion

• buildToolsVersion

• targetSdkVersion

这三个version的含义就是字面意思，不细说了，总之这三个version最好保持一致

查看这三个version的方法如下图所示（这个是我更改以后）

在我更改以前，我的三个version分别是

• compileSdkVersion 28

• buildToolsVersion 28.02

• targetSdkVersion 28

接下来你要查看你两个的gradle version（注意是查看不是更改，更改的方法下面会说）

• Gradle Version
• Android Plugin Version

你可以简单地理解成，Gradle是一款软件产品，不仅仅是Android在用这个款产品，别的公司（比如Adobe等，可以在官网查）也在用这个产品，这个产品是在不停地迭代更新的，这个版本就是所谓的Gradle Version

而针对于Android，使用Gradle还需要一款特殊的插件支持，这款插件就是Android Gradle Plugin，你可以简单地将其理解为这是Android和Gradle之间的一个桥梁，这个插件的版本就是所谓的Android Plugin Version

查看方式如下图所示（这个是更改以后的）

---

解决问题

我之前用的三个版本是27，之所以更新为28，是因为我把Gradle版本给升级了，Gradle升级以后告诉我，你现在的Gradle只支持28及以上的版本，所以逼迫我将三个版本更新为28，紧接着我又不得不把用到的dependency全部更新为28

这一更新，就出现了上述的问题

其实目前的解决方法也很简单，就是把版本滚回去，但是需要你有一份备份代码

下面叙述一下滚回去的方法

这是之前备份的代码

打开这个文件，可以用notepad或者notepad++

我这里可以看到，之前用的Android Plugin Version是2.3.3

然后打开这个文件夹

一直点进去

打开这个文件

显然之前的gradle版本是4.4

好了，现在你已经知道了三个version以及两个gradle版本

回到你的项目里，先把这里改回去

然后这里改一下

当然三个版本以及对应的dependency版本也要修改

然后再加一句话，加的位置见下图

最后，clean和rebuild即可

it works like a charm