从另一个模块导入依赖项

import dependencies from another module

我想我遗漏了 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* 模块中的代码就像未声明依赖项一样简单。事实上,如果我在单个模块中导入依赖项,代码会按预期工作。

我是不是做错了假设?依赖继承不就是这样吗?

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

这种建模依赖关系的方式的一个优点是,如果实现依赖关系发生变化,您不需要重新编译使用项目。另一个是通过封装它们,消费者不太可能开始直接依赖它们,然后如果你改变它们就会崩溃。

如果您想向消费者公开依赖项,您必须将其声明为模块的 API 的一部分。您可以通过应用 java-library 插件并使用 api 配置来做到这一点。

示例:

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

dependencies {
   api 'common-dependency'
}

Gradle user guide

中阅读更多相关信息