如何通过Gradle动态修改OpenAPI Info块的version字段？

直接在YAML里写${apiVersion}并在Gradle的ext里定义变量是没用的——Gradle不会自动识别并替换YAML文件里的占位符，得配置专门的替换逻辑或者用插件。下面是几种可行的解决办法：

方法一：用Gradle自带的资源过滤功能 #

这是最轻量化的方案，利用Gradle的processResources任务实现替换：

1. 把你的OpenAPI YAML文件放到src/main/resources目录下（如果文件在其他位置，后续路径对应调整）。
2. 修改build.gradle，配置processResources的过滤规则：

ext {
    apiVersion = '1.0.1'
}

processResources {
    filesMatching('openapi.yaml') { // 替换成你的实际文件名
        // 如果用@占位符，YAML里写@apiVersion@
        filter(org.apache.tools.ant.filters.ReplaceTokens, tokens: [apiVersion: apiVersion])
        
        // 要是坚持用${}占位符，就加下面两个参数
        // beginToken: '${', 
        // endToken: '}'
    }
}

3. 对应调整YAML里的占位符：

info:
  version: @apiVersion@
# 或者用${apiVersion}，前提是上面配置了beginToken和endToken

执行构建时，Gradle会自动替换占位符，输出到build/resources/main目录下。

方法二：自定义Gradle任务手动替换 #

如果不想用资源过滤，也可以写个独立任务专门处理：

ext {
    apiVersion = '1.0.1'
    openApiSrc = file('openapi.yaml') // 源文件路径
    openApiDest = file("$buildDir/generated/openapi.yaml") // 输出文件路径
}

task updateOpenApiVersion {
    doLast {
        // 读取源文件内容，替换占位符
        def content = openApiSrc.text.replace('${apiVersion}', apiVersion)
        // 创建输出目录（如果不存在）
        openApiDest.parentFile.mkdirs()
        // 写入替换后的内容
        openApiDest.text = content
    }
}

// 让这个任务在编译前自动执行
compileJava.dependsOn(updateOpenApiVersion)

每次构建时，这个任务会自动生成替换好版本的OpenAPI文件到指定目录。

方法三：用OpenAPI Generator插件 #

如果你的项目还需要生成API客户端/服务端代码，用OpenAPI Generator插件更合适，它支持直接配置version参数：

1. 先引入插件：

plugins {
    id 'org.openapi.generator' version '7.6.0'
}

2. 配置生成任务，把你的OpenAPI文件作为模板，用插件支持的占位符：

ext {
    apiVersion = '1.0.1'
}

openApiGenerate {
    generatorName = 'openapi-yaml' // 指定生成YAML格式
    inputSpec = "$projectDir/openapi-template.yaml".toString() // 模板文件路径
    outputDir = "$buildDir/generated/openapi".toString() // 输出目录
    // 直接传入version参数，模板里用{{version}}占位符
    configOptions = [
        version: apiVersion
    ]
}

模板文件里的version写成：

info:
  version: {{version}}

执行openApiGenerate任务后，就能得到替换好版本的OpenAPI文件，还能顺便生成其他代码。

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