编译时修改.kt/.java文件及Gradle按文件类型差异化构建技术问询

嘿，我来帮你拆解这两个Gradle构建相关的问题，都是日常开发中很实用的场景：

1. 如何在编译时修改.kt/.java文件并完成构建？ #

在Gradle构建流程里，核心思路是让修改源码的步骤先于编译任务执行，这样编译时用的就是修改后的版本。这里有两种最常用的方案：

方案一：简单修改用Gradle预处理任务 #

如果只是做文本替换、常量修改这类简单操作，直接写个自定义Gradle Task就能搞定。比如先把源码复制到临时目录，修改内容后让编译任务指向这个临时目录：

// 定义临时存放修改后源码的目录
def tempSrcDir = file("$buildDir/tmp/modified-src")

// 自定义任务：复制源码并做修改
task modifySources(type: Copy) {
    // 源文件来自你的主源码目录
    from 'src/main/java'
    from 'src/main/kotlin'
    // 输出到临时目录
    into tempSrcDir

    // 举个例子：把版本号从1.0改成2.0
    filter { String line ->
        line.replaceAll('public static final String VERSION = "1.0"', 'public static final String VERSION = "2.0"')
    }
}

// 让Java编译任务依赖修改任务，并用临时目录的源码
tasks.withType(JavaCompile) {
    dependsOn modifySources
    source = tempSrcDir
}

// Kotlin编译任务同理
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
    dependsOn modifySources
    source = tempSrcDir
}

这种方式简单直接，不需要复杂的插件开发，适合快速实现小需求。

方案二：复杂修改用自定义编译插件 #

如果需要做语法层面的调整（比如修改函数逻辑、注解处理扩展），就得用对应的编译插件了：

• Java：可以基于Java Annotation Processing API扩展，或者结合JavaParser这类AST解析工具，在编译前修改源码结构；也可以用Gradle的Transform API处理字节码（不过这是编译后修改，如果你要改源码的话还是优先AST方案）。
• Kotlin：开发Kotlin Compiler Plugin，通过Kotlin提供的AbstractIrGenerationExtension或CodegenExtension接口，在编译流程中直接修改Kotlin的AST节点，生成你想要的代码后再继续编译。

2. 同包共存.kt/.java与差异化构建 #

2.1 同一文件夹/包下混合存放完全可行 #

Kotlin和Java天生双向兼容，Gradle的Kotlin插件默认就支持这种场景：你可以在src/main/java/com/example或者src/main/kotlin/com/example下同时放.java和.kt文件，编译时Gradle会自动处理跨语言调用的依赖顺序。唯一要注意的是不要让两类文件有完全相同的类名，否则会触发编译冲突。

2.2 构建时切换文件类型，实现差异化构建 #

完全可以通过Gradle的属性、变体或者过滤规则来实现，这里给你几种实用的方式：

方式一：用命令行属性动态控制

在build.gradle里读取自定义属性，根据属性值决定要编译的文件类型：

// 读取命令行传入的属性，默认编译两种文件
def buildLang = project.findProperty("buildLanguage") ?: "both"

sourceSets {
    main {
        java {
            // 如果指定编译Java或默认编译全部，就包含Java源码目录
            srcDirs = buildLang in ["java", "both"] ? ["src/main/java"] : []
        }
        kotlin {
            // 同理处理Kotlin源码目录
            srcDirs = buildLang in ["kotlin", "both"] ? ["src/main/kotlin"] : []
            // 如果文件混合在同一个目录，就用后缀过滤
            include buildLang in ["kotlin", "both"] ? "**/*.kt" : []
        }
    }
}

然后构建时通过命令行指定：

• 只编译Java：./gradlew build -PbuildLanguage=java
• 只编译Kotlin：./gradlew build -PbuildLanguage=kotlin
• 默认编译两者：./gradlew build

方式二：用构建变体区分（适合多环境场景）

如果是Android项目或者需要多变体的库项目，可以定义专门的构建变体：

// 定义语言维度的变体
flavorDimensions "language"
productFlavors {
    javaOnly {
        dimension "language"
    }
    kotlinOnly {
        dimension "language"
    }
    mixed {
        dimension "language"
    }
}

// 为每个变体配置源码集（Android项目示例，Java/Kotlin库可调整为sourceSets配置）
android {
    sourceSets {
        javaOnly {
            java.srcDirs = ["src/main/java"]
            kotlin.srcDirs = []
        }
        kotlinOnly {
            java.srcDirs = []
            kotlin.srcDirs = ["src/main/kotlin"]
        }
        mixed {
            java.srcDirs = ["src/main/java"]
            kotlin.srcDirs = ["src/main/kotlin"]
        }
    }
}

之后直接构建对应的变体即可，比如./gradlew javaOnlyDebugBuild。

方式三：直接过滤文件后缀

如果你的.kt和.java文件在同一个目录，也可以直接给编译任务加过滤规则：

// Java编译任务只处理.java文件
tasks.withType(JavaCompile) {
    exclude "**/*.kt"
}

// Kotlin编译任务只处理.kt文件
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
    exclude "**/*.java"
}

你可以把这个逻辑和环境变量结合，动态开关过滤规则。

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