產生一份報告,試圖回答以下問題:
- 為何此依賴關係存在於依賴關係圖中?
- 究竟哪些依賴關係將此依賴關係拉入圖中?
- 將使用的依賴關係的實際版本(即「選取」版本)是什麼?它與「請求」的版本相同嗎?
- 為何依賴關係的「選取」版本與「請求」版本不同?
- 此依賴關係有哪些變體可用?
使用此任務來深入了解特定的依賴關係(或多個依賴關係),並找出在依賴關係解析和衝突解決期間究竟發生了什麼。如果依賴關係版本是被強制或由衝突解決選取的,則此資訊將在報告中提供。
雖然常規依賴關係報告 (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