Gradle - 与because语句的依赖关系

Question

我是 gradle 新手，我在 build.gradle.kts 中找到了依赖项，因为子句/语句

dependencies { 
  implementation("commons-io:commons-io") {
      because("IOUtils")
  }
  implementation("org.apache.commons:commons-text") {
      because("StringEscapeUtils")
  }

我没有在任何Gradle 依赖项文档中找到because子句

它是否只是一个类似于添加 java 文档的自定义子句，并且可以重命名为任何字符串：myreason("""my reason is other""")

或者becasueGradle 使用了语句？

Answer 1

org.gradle.api.artifacts.Dependency您可以在界面中找到它

\n\n

https://docs.gradle.org/current/javadoc/org/gradle/api/artifacts/Dependency.html#because-java.lang.String-

\n\n

@Incubating\n@Nullable\nString getReason()\n\nReturns a reason why this dependency should be used, in particular with regards to its version. The dependency report will use it to explain why a specific dependency was selected, or why a specific dependency version was used.\n\nReturns:\n   a reason to use this dependency\nSince:\n   4.6\n\n\n@Incubating\nvoid because\xe2\x80\x8b(@Nullable\n             String reason)\n\nSets the reason why this dependency should be used.\n\nSince:\n    4.6 \n

\n