| API 文档 | 依赖洞察报告任务 |
|---|
生成一个报告,试图回答以下问题:
- 为什么这个依赖项在依赖图中?
- 究竟是哪些依赖项将这个依赖项拉入图中?
- 将使用的依赖项的实际版本(即 *选定* 版本)是什么?它与 *请求* 的版本相同吗?
- 为什么依赖项的 *选定* 版本与 *请求* 的版本不同?
- 此依赖项有哪些可用变体?
使用此任务可以深入了解特定依赖项(或多个依赖项),并找出依赖项解析和冲突解析期间究竟发生了什么。如果依赖项版本被强制或通过冲突解析选定,此信息将在报告中提供。
常规依赖项报告(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()。
| 属性 | 描述 |
配置 | 查找依赖项的配置 |
dependencySpec | 依赖项规范选择要显示报告的依赖项(如果找到多个匹配项,则选择多个依赖项)。该规范接收 |
showSinglePathToDependency | 指示报告是否只显示每个依赖项的一个路径。 |
showingAllVariants | 孵化中 显示每个显示依赖项的所有变体。 |
Spec<DependencyResult> dependencySpec (只写)
Spec<DependencyResult>依赖项规范选择要显示报告的依赖项(如果找到多个匹配项,则选择多个依赖项)。该规范接收 DependencyResult 实例作为参数。
- 默认与
java插件一起使用 - -
注意:此属性处于孵化中,可能会在 Gradle 的未来版本中更改。
显示每个显示依赖项的所有变体。
由于内部限制,此选项仅在执行此任务之前 DependencyInsightReportTask.getConfiguration() 未解析时才有效。
此方法暴露给命令行界面。示例用法:
gradle dependencyInsight --all-variants
- 默认与
java插件一起使用 - 假