如何在Gradle项目中添加外部目录下的指定Java文件？

问题根源 #

你直接将../project1/src/main/java/com/github/blabla/pcg1/作为源码目录添加时，Gradle会把这个子目录当成源码根目录，但这两个文件的包声明仍是com.github.blabla.pcg1，编译时Gradle会认为它们属于根包，导致相互引用找不到对应类。

正确配置方式 #

要保留原包结构，必须将外部项目的顶级源码根目录（即包含com目录的../project1/src/main/java）添加到源码集合，再通过include精确指定需要的两个文件，既保证包结构匹配，又不会引入无关文件。

最终Groovy配置代码 #

sourceSets {
    main {
        java {
            // 添加外部项目的顶级源码根目录
            srcDir '../project1/src/main/java'
            // 精确指定要引入的两个文件，路径相对于上述源码根
            include 'com/github/blabla/pcg1/fil1.java'
            include 'com/github/blabla/pcg1/fil2.java'
        }
    }
}

关键注意事项 #

1. 禁止直接添加子目录作为srcDir：必须使用外部项目的顶级源码根，才能保证文件的包声明与Gradle识别的包结构一致。
2. 检查文件名拼写：你之前的代码中把fil2.java写成了fil2java，这是include不生效的原因之一。
3. 可选安全加固：如果担心意外引入外部项目的其他文件，可以先排除整个包，再单独包含目标文件：

   sourceSets {
       main {
           java {
               srcDir '../project1/src/main/java'
               // 先排除目标包下所有文件
               exclude 'com/github/blabla/**'
               // 再单独包含需要的两个文件
               include 'com/github/blabla/pcg1/fil1.java'
               include 'com/github/blabla/pcg1/fil2.java'
           }
       }
   }
   

验证配置有效性 #

运行以下命令查看源码集合的详细配置，确认目标文件已被正确包含：

gradle sourceSets

输出结果中会显示main源码集的java部分包含指定的文件路径。

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