调试依赖项解析错误

添加依赖项时，您可能会遇到原始依赖项所需的依赖项问题以及不同依赖项版本之间的冲突。以下是分析依赖项图并修复常见问题的方法。

有关修复涉及自定义构建逻辑的依赖项解析错误的指导，请参阅自定义依赖项解析策略。

查看模块依赖项

一些直接依赖项可能还有其自身的依赖项。这些称为传递依赖项。Gradle 不需要您手动声明每个传递依赖项，而是会自动收集并添加它们。Gradle 的 Android 插件提供了一个任务，用于显示 Gradle 为给定模块解析的依赖项列表。

对于每个模块，报告还会根据构建变体、测试源集和类路径对依赖项进行分组。以下是应用模块的调试构建变体的运行时类路径和其工具化测试源集的编译类路径的示例报告。

debugRuntimeClasspath - Dependencies for runtime/packaging
+--- :mylibrary (variant: debug)
+--- com.google.android.material:material:1.0.0@aar
+--- androidx.appcompat:appcompat:1.0.2@aar
+--- androidx.constraintlayout:constraintlayout:1.1.3@aar
+--- androidx.fragment:fragment:1.0.0@aar
+--- androidx.vectordrawable:vectordrawable-animated:1.0.0@aar
+--- androidx.recyclerview:recyclerview:1.0.0@aar
+--- androidx.legacy:legacy-support-core-ui:1.0.0@aar
...

debugAndroidTest
debugAndroidTestCompileClasspath - Dependencies for compilation
+--- androidx.test.ext:junit:1.1.0@aar
+--- androidx.test.espresso:espresso-core:3.1.1@aar
+--- androidx.test:runner:1.1.1@aar
+--- junit:junit:4.12@jar
...

要运行该任务，请执行以下操作：

选择查看 > 工具窗口 > Gradle（或单击工具窗口栏中的Gradle ）。
展开AppName > 任务 > android 并双击androidDependencies。Gradle 执行该任务后，应打开运行窗口以显示输出。

有关在 Gradle 中管理依赖项的更多信息，请参阅 Gradle 用户指南中的依赖项管理基础知识。

排除传递依赖项

随着应用范围的扩大，它可以包含许多依赖项，包括直接依赖项和传递依赖项（应用导入的库所依赖的库）。要排除不再需要的传递依赖项，您可以使用如下所示的exclude关键字

Kotlin

dependencies {
    implementation("some-library") {
        exclude(group = "com.example.imgtools", module = "native")
    }
}

Groovy

dependencies {
    implementation('some-library') {
        exclude group: 'com.example.imgtools', module: 'native'
    }
}

从测试配置中排除传递依赖项

如果您需要从测试中排除某些传递依赖项，则上面显示的代码示例可能无法按预期工作。这是因为测试配置（例如，androidTestImplementation）扩展了模块的implementation配置。也就是说，在 Gradle 解析配置时，它始终包含implementation依赖项。

因此，要从测试中排除传递依赖项，必须在执行时进行操作，如下所示

Kotlin

android.testVariants.all {
    compileConfiguration.exclude(group = "com.jakewharton.threetenabp", module = "threetenabp")
    runtimeConfiguration.exclude(group = "com.jakewharton.threetenabp", module = "threetenabp")
}

Groovy

android.testVariants.all { variant ->
    variant.getCompileConfiguration().exclude group: 'com.jakewharton.threetenabp', module: 'threetenabp'
    variant.getRuntimeConfiguration().exclude group: 'com.jakewharton.threetenabp', module: 'threetenabp'
}

注意：您仍然可以在依赖项块中使用exclude关键字（如排除传递依赖项部分中的原始代码示例所示）来省略特定于测试配置且未包含在其他配置中的传递依赖项。

修复依赖项解析错误

当您向应用项目添加多个依赖项时，这些直接和传递依赖项可能会相互冲突。Android Gradle 插件尝试优雅地解决这些冲突，但某些冲突可能会导致编译时或运行时错误。

为了帮助您调查哪些依赖项会导致错误，请检查应用的依赖项树，并查找出现多次或版本冲突的依赖项。

如果您无法轻松识别重复的依赖项，请尝试使用 Android Studio 的 UI 搜索包含重复类的依赖项，方法如下：

从菜单栏中选择导航 > 类。
在弹出的搜索对话框中，确保选中包含非项目项旁边的框。
键入构建错误中出现的类的名称。
检查包含该类的依赖项的结果。

以下部分描述了您可能遇到的不同类型的依赖项解析错误以及如何修复这些错误。

修复重复类错误

如果某个类在运行时类路径上出现多次，则会收到类似于以下错误的错误

Program type already present com.example.MyClass

此错误通常由于以下情况之一而发生：

二进制依赖项包含一个库，您的应用也将其作为直接依赖项包含在内。例如，您的应用声明对库 A 和库 B 的直接依赖关系，但库 A 已经在其二进制文件中包含了库 B。
- 要解决此问题，请删除库 B 作为直接依赖项。
您的应用对同一库具有本地二进制依赖项和远程二进制依赖项。
- 要解决此问题，请删除其中一个二进制依赖项。

修复类路径之间的冲突

当 Gradle 解析编译类路径时，它首先解析运行时类路径，并使用结果来确定应将哪些版本的依赖项添加到编译类路径。换句话说，运行时类路径确定下游类路径上相同依赖项所需的版本号。

您的应用的运行时类路径还确定 Gradle 对应用的测试 APK 的运行时类路径中匹配依赖项所需的版本号。类路径的层次结构如图 1 所示。

图 1. 跨多个类路径出现的依赖项的版本号必须根据此层次结构匹配。

例如，当您的应用使用implementation 依赖项配置包含依赖项的某个版本，而库模块使用runtimeOnly配置包含依赖项的不同版本时，可能会出现相同依赖项的不同版本跨多个类路径出现的冲突。

在解析运行时和编译时类路径上的依赖项时，Android Gradle 插件 3.3.0 和更高版本尝试自动修复某些下游版本冲突。例如，如果运行时类路径包含库 A 版本 2.0，而编译时类路径包含库 A 版本 1.0，则插件会自动将编译时类路径上的依赖项更新为库 A 版本 2.0，以避免错误。

但是，如果运行时类路径包含库 A 版本 1.0，而编译时类路径包含库 A 版本 2.0，则插件不会将编译时类路径上的依赖项降级到库 A 版本 1.0，您仍然会收到类似于以下错误的错误

Conflict with dependency 'com.example.library:some-lib:2.0' in project 'my-library'.
Resolved versions for runtime classpath (1.0) and compile classpath (2.0) differ.

要解决此问题，请执行以下操作之一：

将所需版本的依赖项作为api依赖项包含到您的库模块中。也就是说，只有您的库模块声明了该依赖项，但应用模块也可以通过传递方式访问其 API。
或者，您可以在两个模块中声明该依赖项，但应确保每个模块使用相同版本的依赖项。考虑配置项目范围的属性，以确保每个依赖项的版本在整个项目中保持一致。