gradle - 从另一个模块导入依赖项

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 中阅读更多相关信息