如何在Gradle项目中通过相对路径引入外部Java代码文件夹？

我有一个Gradle Java项目，需要引用另一个代码仓库里的Java代码，但不知道具体怎么配置。当前的build.gradle内容如下：

/*
 * This file was generated by the Gradle 'init' task.
 *
 * This generated file contains a sample Java application project to get you started.
 * For more details take a look at the 'Building Java & JVM projects' chapter in the Gradle
 * User Manual available at https://docs.gradle.org/7.2/userguide/building_java_projects.html
 */

plugins {
    // Apply the application plugin to add support for building a CLI application in Java.
    id 'application'
}

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    // Use JUnit test framework.
    testImplementation 'junit:junit:4.13.2'

    // This dependency is used by the application.
    implementation 'com.google.guava:guava:30.1.1-jre'

    // implementation project(':project1')
    // implementation files('../../project1/lib/build/libs/lib.jar')
}

application {
    // Define the main class for the application.
    mainClass = 'project2.App'
}

请问需要在该文件中添加哪些配置，才能通过相对路径指向包含Java源文件的外部文件夹？

根据外部代码的管理方式，有两种常用配置方式：

1. 直接添加外部源目录到源集（适用于非Gradle管理的零散源文件） #

如果外部只是单纯的Java源文件目录，没有用Gradle构建，可以直接将其添加到项目的源集配置中，让Gradle把该目录当作自己的源码目录编译。

在build.gradle中添加以下配置：

sourceSets {
    main {
        java {
            // 替换为实际的外部源文件相对路径，示例指向同级仓库的main/java目录
            srcDirs += '../../project1/src/main/java'
        }
    }
    // 如果需要引用外部的测试代码，可添加test源集配置
    test {
        java {
            srcDirs += '../../project1/src/test/java'
        }
    }
}

配置后，Gradle在编译时会自动包含该目录下的所有Java源文件，无需提前编译外部代码。

2. 使用复合构建（适用于外部代码本身是Gradle项目） #

如果外部代码仓库本身是一个Gradle项目，更推荐使用复合构建，这种方式能自动管理外部项目的依赖、构建流程，且代码修改后能同步到当前项目。

步骤1：修改settings.gradle文件 #

在当前项目的settings.gradle中添加外部项目的引用：

// 替换为外部Gradle项目的相对路径
includeBuild '../../project1'

步骤2：在build.gradle中添加依赖 #

打开当前项目的build.gradle，取消注释之前的项目依赖配置：

dependencies {
    // ... 保留原有依赖
    implementation project(':project1')
}

配置完成后，执行当前项目的构建任务时，Gradle会自动触发外部项目的构建，并将其产物作为依赖引入当前项目。

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