生成一份报告,尝试回答如下问题
- 为什么此依赖项在依赖关系图中?
- 究竟是哪些依赖项将此依赖项拉入图中?
- 将要使用的依赖项的实际版本(即 *选定* 版本)是什么?它与 *请求* 的版本相同吗?
- 为什么依赖项的 *选定* 版本与 *请求* 的版本不同?
- 此依赖项有哪些变体可用?
使用此任务可以深入了解特定的依赖项(或多个依赖项),并找出在依赖项解析和冲突解决期间究竟发生了什么。如果依赖项版本被强制或由冲突解决选择,则此信息将在报告中提供。
虽然常规依赖项报告 (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 | 孵化中 显示每个显示依赖项的所有变体。 |
Spec
<DependencyResult
>
dependencySpec
Spec
<DependencyResult
>注意:此属性已弃用,将在 Gradle 的下一个主要版本中删除。
选择要显示报告的依赖项(或找到多个匹配项时的多个依赖项)。
- 使用
java
插件时的默认值 - -
注意:此属性正在孵化中,并且可能在 Gradle 的未来版本中更改。
显示每个显示依赖项的所有变体。
由于内部限制,此选项仅在执行此任务之前 DependencyInsightReportTask.getConfiguration()
未解析时才有效。
此方法暴露给命令行界面。用法示例
gradle dependencyInsight --all-variants
- 使用
java
插件时的默认值 - false