如何在Jenkins Cucumber报告中从.properties文件指定分类？

问题背景 #

在Cucumber报告插件的Advanced > Presentation > Classifications面板中，输入${FOO}这类变量时，变量不会被解析，而是原样显示。尝试过以下操作但未解决：

• 在Shell构建脚本中用export FOO=hello定义局部环境变量
• 创建report-vars.properties文件并写入变量，插件已确认读取到该文件
• 已安装token-macro:2.6插件

解决方案 #

1. 用Jenkins全局环境变量替代Shell局部变量 #

Shell脚本里的export仅在当前Shell进程有效，Jenkins主进程无法获取。要让变量全局生效，推荐用环境注入插件：

• 安装EnvInject Plugin
• 在构建步骤中添加「Inject environment variables」，在「Properties Content」中直接定义变量：

  FOO=hello
  buildVersion=${LAST_BUILD_VERSION}
  

2. 结合Token Macro语法引用变量 #

Cucumber报告插件的Classifications不直接支持${变量名}的格式，需要用Token Macro的语法来引用：

• 引用Jenkins环境变量：用${ENV, var="FOO"}
• 引用properties文件中的变量：如果report-vars.properties里有classifications.message=hello，则在Classifications中填${FILE, path="report-vars.properties", property="classifications.message"}

3. 确认properties文件的有效性 #

• 确保report-vars.properties在Jenkins工作区根目录，插件会自动扫描工作区内所有.properties文件
• 检查是否和其他properties文件（如sonar-project.properties）有重名键，避免被覆盖
• 查看插件日志，确认变量是否被正确加载

4. 验证Token Macro插件功能 #

在Jenkins「系统管理」→「Token Macro」页面测试变量解析：

• 输入${ENV, var="FOO"}后点击「Test」，确认能输出正确值
• 如果测试失败，重启Jenkins确保token-macro插件生效

流水线脚本示例（若使用Pipeline） #

如果是Jenkins Pipeline，可直接在脚本中定义环境变量并引用：

pipeline {
    agent any
    environment {
        FOO = 'hello'
    }
    stages {
        stage('Generate Report') {
            steps {
                cucumber(
                    buildStatus: 'UNSTABLE',
                    classifications: [
                        [name: 'Greeting', value: '${ENV, var="FOO"}'],
                        [name: 'Build Version', value: '${FILE, path="report-vars.properties", property="buildVersion"}']
                    ]
                )
            }
        }
    }
}

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