DependencyInsightReportTask

生成一份报告,尝试回答如下问题

  • 为什么此依赖项在依赖关系图中?
  • 究竟是哪些依赖项将此依赖项拉入图中?
  • 将要使用的依赖项的实际版本(即 *选定* 版本)是什么?它与 *请求* 的版本相同吗?
  • 为什么依赖项的 *选定* 版本与 *请求* 的版本不同?
  • 此依赖项有哪些变体可用?

使用此任务可以深入了解特定的依赖项(或多个依赖项),并找出在依赖项解析和冲突解决期间究竟发生了什么。如果依赖项版本被强制或由冲突解决选择,则此信息将在报告中提供。

虽然常规依赖项报告 (DependencyReportTask) 显示了从顶层依赖项向下到传递依赖项的路径,但依赖项洞察报告显示了从特定依赖项到将其拉入的依赖项的路径。也就是说,它是常规依赖项报告的倒置视图。

此任务需要设置依赖项规范和配置。有关如何配置这些内容的更多信息,请参阅 DependencyInsightReportTask.setDependencySpec(java.lang.Object)DependencyInsightReportTask.setConfiguration(java.lang.String) 的文档。

也可以从命令行配置此任务。有关更多信息,请参阅 DependencyInsightReportTask.setDependencySpec(java.lang.Object)DependencyInsightReportTask.setConfiguration(java.lang.String)DependencyInsightReportTask.setShowSinglePathToDependency(boolean)DependencyInsightReportTask.getShowingAllVariants()

属性

属性描述
configuration

在其中查找依赖项的配置

dependencySpec
已弃用

选择要显示报告的依赖项(或找到多个匹配项时的多个依赖项)。

showSinglePathToDependency

说明报告是否应仅显示每个依赖项的一条路径。

showingAllVariants
孵化中

显示每个显示依赖项的所有变体。

方法

无方法

脚本块

无脚本块

属性详情

Configuration configuration

在其中查找依赖项的配置

使用 java 插件时的默认值
compileClasspath 配置

Spec<DependencyResult> dependencySpec

注意:此属性已弃用,将在 Gradle 的下一个主要版本中删除。

选择要显示报告的依赖项(或找到多个匹配项时的多个依赖项)。

使用 java 插件时的默认值
-

boolean showSinglePathToDependency

说明报告是否应仅显示每个依赖项的一条路径。

使用 java 插件时的默认值
false

Property<Boolean> showingAllVariants

注意:此属性正在孵化中,并且可能在 Gradle 的未来版本中更改。

显示每个显示依赖项的所有变体。

由于内部限制,此选项仅在执行此任务之前 DependencyInsightReportTask.getConfiguration() 未解析时才有效。

此方法暴露给命令行界面。用法示例

gradle dependencyInsight --all-variants
使用 java 插件时的默认值
false