从另一个模块导入依赖关系

Question

我想我遗漏了gradle中依赖项管理是如何工作的。假设我有以下项目结构：

project
---api
------api-commons
------api-v1
------api-v2
------api-v3

其中所有api*目录都是模块。所有的api-v*都需要一个特定的依赖项(比方说common-dependency)。

我的目标是将其导入到api-commons build.gradle文件中：

dependencies {
   implementation 'common-dependency'
}

而在其他模块的build.gradle文件中，api-v*放入：

dependencies{
   implementation project(':api:api-commons')
}

我希望这能起作用，但事实并非如此，api-v*模块中的代码就像没有声明依赖项一样。实际上，如果我在单个模块中导入依赖项，代码就会按预期工作。

我的假设是错误的吗？依赖继承不是这样工作的吗？

Answer 1

在implementation配置中声明依赖项在概念上意味着它是模块内部的(它在实现中使用，但不是public API的一部分)。这样的依赖项将不会公开给使用者的编译类路径，尽管它仍然在运行时类路径上。

这种建模依赖关系的方法的一个优点是，如果实现依赖关系发生变化，则不需要重新编译使用项目。另一个是，通过封装它们，消费者不太可能开始直接依赖它们，然后在您更改它们时破坏它们。

如果您希望将依赖项公开给使用者，则必须将其声明为模块的API的一部分。您可以通过应用java-library插件和使用api配置来实现这一点。

示例：

// api-commons/build.gradle
plugins {
  id 'java-library'
}

dependencies {
   api 'common-dependency'
}

在Gradle user guide中阅读有关它的更多信息