并行开发Gradle依赖及子项目时如何从本地文件系统加载源码依赖

推荐方案：使用Gradle复合构建（Composite Build） #

该方案是Gradle官方针对多关联项目并行开发场景推出的原生支持能力，不需要将依赖发布到本地/远程仓库，直接关联本地源码项目，修改实时生效，无需等待CI/CD流程。

配置步骤 #

• 临时测试场景（无需修改项目配置）：执行子项目构建/运行命令时添加--include-build参数指定父依赖的本地根目录即可，示例：

  gradle build --include-build /home/workspace/your-parent-dependency-project
  

• 持久配置场景：在子项目的settings.gradle（Groovy DSL）或settings.gradle.kts（Kotlin DSL）文件中添加如下配置：

  // Groovy DSL 写法
  includeBuild('/home/workspace/your-parent-dependency-project')
  // 也支持相对路径，比如父依赖与子项目在同级目录时可写为
  // includeBuild('../your-parent-dependency-project')
  

  // Kotlin DSL 写法
  includeBuild("/home/workspace/your-parent-dependency-project")
  

• 确保父依赖项目中声明的group、name、version坐标，与子项目dependencies块中引用该依赖的坐标完全一致，Gradle会自动匹配替换远程仓库依赖为本地源码依赖，无需修改子项目的依赖声明代码。

方案优势 #

• 父依赖源码修改后，子项目构建时会自动编译最新代码，无需执行任何发布类任务
• 支持在子项目中直接断点调试父依赖的源码
• 切换回远程仓库版本成本极低，仅需注释/删除includeBuild配置即可

替代方案：导入为子项目 #

如果你不想使用复合构建，也可以将父依赖作为子模块导入子项目，直接依赖源码：

1. 在子项目的settings.gradle中添加配置：

   include(':parent-dependency')
   project(':parent-dependency').projectDir = new File('/home/workspace/your-parent-dependency-project')
   

2. 在子项目的dependencies块中修改依赖声明为项目依赖：

   dependencies {
       // 替换原来的远程依赖声明为以下内容
       implementation project(':parent-dependency')
   }
   

内容的提问来源于stack exchange，提问作者Bancarel Valentin