如何通过Gradle发布父模块及合并的整体构件?
解决方案:在现有结构下实现聚合构件发布
先说结论:不需要新增第三个子模块,直接在父模块的build.gradle里配置就能实现需求——既发布两个子模块构件,也发布一个聚合的整体构件,让使用者可以选单坐标引入全部功能,或者单独引入子模块。
具体配置步骤
- 给父模块启用必要插件,配置好聚合构件的GAV坐标:
plugins { id 'java' id 'maven-publish' } // 这就是你要的合并构件坐标 group = 'io.github.org' version = '1.0.0' archivesBaseName = 'artifact'
- 让父模块依赖两个子模块,这样发布的POM文件会自动包含这两个依赖,使用者引入父模块时就能拉取到子模块的内容:
dependencies { implementation project(':Core') implementation project(':Dependent') }
- 配置发布逻辑,确保父模块的构件能正确发布。因为父模块本身没有业务代码,我们可以让它发布一个空Jar+包含子模块依赖的POM:
publishing { publications { mavenJava(MavenPublication) { from components.java // 手动配置POM信息,确保依赖正确 pom { name = 'Artifact' description = '聚合构件,包含core和dependent子模块的全部功能' url = 'https://github.com/your-project-repo' // 替换成你的项目仓库地址 dependencies { dependency { groupId project(':Core').group artifactId project(':Core').archivesBaseName version project(':Core').version scope 'compile' } dependency { groupId project(':Dependent').group artifactId project(':Dependent').archivesBaseName version project(':Dependent').version scope 'compile' } } } } } repositories { // 配置你的发布仓库,比如Maven Central、私有仓库等 maven { url = uri('your-repository-url') credentials { username = project.findProperty('repoUsername') ?: System.getenv('REPO_USERNAME') password = project.findProperty('repoPassword') ?: System.getenv('REPO_PASSWORD') } } } }
- 执行发布时,直接运行父模块的
publish任务,Gradle会自动触发子模块的publish,同时发布父模块的聚合构件。
为什么不用新增子模块?
父模块本身就可以作为独立构件发布,它的核心作用就是提供一个聚合的依赖入口,不需要自己写任何业务代码。这种方式完全符合Gradle多模块项目的设计逻辑,既保留了子模块的独立性,又给使用者提供了便捷的整体引入方式。
注意事项
- 确保两个子模块的
publish任务已经配置正确,父模块执行publish时默认会触发子模块的发布流程。 - 如果父模块有自己的源代码,需要调整Jar任务避免编译冲突;如果没有源代码,上述配置生成的空Jar是正常的,因为核心逻辑都在子模块里。
- 发布完成后,使用者有两种引入方式:
- 整体引入:
implementation 'io.github.org:artifact:1.0.0' - 单独引入子模块:
implementation 'io.github.org:artifact-core:1.0.0'或implementation 'io.github.org:artifact-dependent:1.0.0'
- 整体引入:
内容的提问来源于stack exchange,提问作者Delark
相关产品推荐
相关产品推荐

