如何在Java17+build.gradle.kts中生成Jenkins可读的版本文件？

1. 在build.gradle.kts中定义版本属性 #

先在构建脚本里声明buildVersion属性，可通过extra扩展定义，也能根据Jar文件名动态解析生成：

// 示例为固定版本，实际可替换为从Jar文件名提取版本的逻辑
val buildVersion by extra("1.2.3-RELEASE")

2. 正确实现readImageVersion任务 #

要在任务的执行阶段（doLast代码块）生成指定的image.version文件，避免在配置阶段执行无关操作。标准写法如下：

tasks.register("readImageVersion") {
    doLast {
        // 指定文件生成位置：这里用build目录，也可换成项目根目录project.rootDir
        val versionFile = project.layout.buildDirectory.file("image.version").get().asFile
        // 确保父目录存在，避免写入失败
        versionFile.parentFile.mkdirs()
        // 将版本内容写入文件
        versionFile.writeText(buildVersion.toString())
    }
}

3. Jenkinsfile中读取版本 #

保持原有逻辑即可，先执行Gradle任务，再读取生成的文件内容：

stage('生成构建版本') {
    steps {
        sh './gradlew readImageVersion'
        script {
            def buildVersion = readFile("build/image.version").trim()
            // 后续可将buildVersion用于镜像标签、版本记录等场景
        }
    }
}

错误代码问题说明 #

你之前的写法存在两个核心问题：

• 在任务的配置阶段直接执行文件创建操作，Gradle配置阶段会在所有任务执行前运行，不符合任务生命周期规范
• 使用File.createTempFile生成临时文件，而非需求中的image.version文件，且未写入版本内容

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