如何构建支持Java 11与Java 17多版本兼容的Gradle项目？

1. 拆分项目模块 #

将项目拆分为两个Gradle子模块，实现代码与依赖的隔离：

• core模块：承载Java 11兼容的核心代码，所有Java版本的客户端都能调用
• java17-ext模块：存放Java 17专属代码，仅对Java 17环境的客户端开放，同时可直接调用core模块的代码

2. 配置各模块的Gradle构建脚本 #

根项目settings.gradle

include ':core', ':java17-ext'

core模块build.gradle

指定Java 11作为编译和运行版本，依赖仅选用Java 11兼容的库：

plugins {
    id 'java'
}

java {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

dependencies {
    // 仅添加Java 11兼容的依赖
    implementation 'org.apache.commons:commons-lang3:3.12.0'
}

java17-ext模块build.gradle

指定Java 17版本，依赖core模块和Java 17专属库：

plugins {
    id 'java'
}

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

dependencies {
    // 依赖core模块
    implementation project(':core')
    // 添加仅支持Java 17的依赖
    implementation 'com.some.lib:java17-specific-lib:2.0.0'
}

3. 代码层面的隔离规范 #

• core模块代码禁止使用Java 11以上的语法特性（如密封类、模式匹配、虚拟线程等），确保编译产物能在Java 11及以上环境运行
• java17-ext模块可自由使用Java 17特性，包结构建议与core区分（例如core用com.example.core，java17-ext用com.example.java17），避免客户端误引用

4. 其他项目导入时的版本控制 #

当其他项目导入该项目时，可通过Gradle的条件配置实现版本限制：

plugins {
    id 'java'
}

java {
    // 导入项目的Java版本
    sourceCompatibility = JavaVersion.VERSION_11 // 或17
}

dependencies {
    // 所有版本都能导入core模块
    implementation project(':core')
    
    // 仅当导入项目使用Java 17时，才导入java17-ext模块
    if (JavaVersion.current().isJava17Compatible()) {
        implementation project(':java17-ext')
    }
}

5. 测试配置建议 #

• core模块的测试任务使用Java 11运行，确保核心代码在目标环境的兼容性
• java17-ext模块的测试任务使用Java 17运行，验证专属代码的功能

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