如何在Gradle中参数化Jacoco覆盖率校验的minimum值（支持Jenkins/TeamCity）

没问题，我来帮你搞定这个需求——通过参数化Jacoco的minimum阈值，让你能在Jenkins或TeamCity这类CI工具里动态传入覆盖率要求，达不到就终止构建。下面分步骤说明：

1. 修改build.gradle，支持读取外部参数 #

首先要把硬编码的minimum值改成从Gradle项目属性中读取，同时保留一个默认值，这样本地构建也能正常运行。修改后的任务代码如下：

project.task(type: JacocoCoverageVerification, "jacocoTestCoverageVerification", overwrite: true) {
    executionData(junitPlatformTestTask)
    sourceSets(sourceSets.main)
    sourceDirectories = files(sourceSets.main.allSource.srcDirs)
    classDirectories = files(sourceSets.main.output)
    onlyIf = { true }
    violationRules {
        rule {
            limit {
                counter = 'INSTRUCTION'
                value = 'COVEREDRATIO'
                // 从项目属性读取阈值，默认值设为0.001（防止未传参时构建失败）
                minimum = project.findProperty('jacoco.minimum.coverage')?.toDouble() ?: 0.001
            }
        }
    }
}

// 让check任务依赖覆盖率验证任务，这样构建时会自动执行验证
check.dependsOn jacocoTestCoverageVerification

这里的核心逻辑是：

• 优先读取名为jacoco.minimum.coverage的项目属性
• 如果属性存在，将其转换为Double类型作为阈值
• 如果属性不存在，就用默认的0.001兜底，保证本地构建能正常执行

2. 本地测试参数化效果 #

在本地命令行里，你可以直接传参验证效果：

# 要求代码覆盖率至少达到80%
./gradlew check -Pjacoco.minimum.coverage=0.8

如果实际覆盖率低于80%，构建会直接失败，完全符合你的终止需求。

3. Jenkins中配置动态传参 #

在Jenkins里设置参数的步骤：

• 打开项目配置，勾选「This project is parameterized」
• 添加一个String Parameter，参数名称填jacoco.minimum.coverage，默认值可以设为0.8（对应80%覆盖率）
• 找到「Invoke Gradle script」构建步骤，在「Gradle options」里添加参数：

  -Pjacoco.minimum.coverage=${jacoco.minimum.coverage}
  

• 任务名称填check，这样构建时会自动执行测试+覆盖率验证流程

4. TeamCity中配置动态传参 #

在TeamCity里设置参数的步骤：

• 进入项目构建配置的「Parameters」标签页
• 添加一个Text parameter，参数名称填jacoco.minimum.coverage，默认值设为0.8
• 找到Gradle构建步骤，在「Additional command line parameters」里添加：

  -Pjacoco.minimum.coverage=%jacoco.minimum.coverage%
  

• 任务名称同样填check即可

额外注意事项 #

• 确保传入的参数是合法的小数（比如0.75代表75%），如果传了非数字内容，Gradle会抛出类型转换错误
• 如果需要多个覆盖率规则（比如分支覆盖率、类覆盖率），可以给每个规则的minimum单独设置参数，比如jacoco.minimum.branch.coverage，用同样的属性读取方式即可

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