如何在Jenkins中将环境变量URL字符串传递给Gradle任务？

问题背景 #

Jenkins作业流程第3步中，尝试将环境变量APK_URL传递给Gradle命令时，变量未被解析为实际URL，导致自动化测试因无法识别APK路径而失败。

已做调研 #

• 命令行向Gradle任务传递参数的方法
• Gradle任务内设置环境变量的方式
• 流水线中传递作业参数给Gradle任务的方案

问题重现 #

Jenkins作业流程 #

1. 通过参数将文件上传至个人云存储；
2. 云存储返回文件URL，尝试存入环境变量APK_URL，执行脚本：

output=$(curl -F file=@"$WORKSPACE/build/SomeProject" -H "Retention: $RETENTION_DAYS" https://www.myCloudServer.online/fileuploader?key=$MY_KEY)
APK_URL=$(echo "$output" | sed -n 's/.*"file_url":"\([^"]*\)".*/\1/p' | sed 's/\\//g')
echo "APK URL": ${env.APK_URL}"

3. 执行Gradle命令时传递变量：

clean test --tests "appium.some.app.Tests.*"  -DincludeTags=$RUN_TYPE -DwebhookUrl=https://hooks.slack.com/services/someSlackChannel  -DbuildUrl=${env.APK_URL}

本地执行正常，但Jenkins中${env.APK_URL}未被解析，测试报错。

错误日志 #

无法解析位于${env.APK_URL}的应用包文件。AppPackage参数必须是有效的Android APK包URL，或者有效的Android APK包文件路径！

问题原因 #

1. Shell变量与Jenkins环境变量隔离：bash脚本中设置的APK_URL是Shell本地变量，不会自动同步到Jenkins全局环境变量，后续步骤无法读取该值。
2. 变量引用语法错误：在bash环境中使用了Jenkins Pipeline专属的${env.APK_URL}语法，bash无法识别该写法，导致变量未被插值替换。

解决步骤 #

1. 将Shell变量注入Jenkins环境变量 #

根据流水线类型调整步骤2的脚本，把Shell中获取到的URL同步到Jenkins环境变量：

脚本式流水线

// 执行Shell命令获取APK URL
def apkUrlOutput = sh(
    script: '''
    output=$(curl -F file=@"$WORKSPACE/build/SomeProject" -H "Retention: $RETENTION_DAYS" https://www.myCloudServer.online/fileuploader?key=$MY_KEY)
    echo "$output" | sed -n 's/.*"file_url":"\([^"]*\)".*/\1/p' | sed 's/\\//g'
    ''',
    returnStdout: true
).trim()

// 设置为Jenkins环境变量
env.APK_URL = apkUrlOutput
echo "获取到的APK URL: ${env.APK_URL}"

声明式流水线

steps {
    script {
        def apkUrlOutput = sh(
            script: '''
            output=$(curl -F file=@"$WORKSPACE/build/SomeProject" -H "Retention: $RETENTION_DAYS" https://www.myCloudServer.online/fileuploader?key=$MY_KEY)
            echo "$output" | sed -n 's/.*"file_url":"\([^"]*\)".*/\1/p' | sed 's/\\//g'
            ''',
            returnStdout: true
        ).trim()
        env.APK_URL = apkUrlOutput
    }
    echo "获取到的APK URL: ${env.APK_URL}"
}

2. 正确引用变量执行Gradle命令 #

根据执行场景选择对应的变量引用方式：

在Shell步骤中直接执行

使用Shell变量语法$APK_URL（确保Shell环境中已导出该变量，或通过Jenkins环境变量传递）：

./gradlew clean test --tests "appium.some.app.Tests.*" -DincludeTags=$RUN_TYPE -DwebhookUrl=https://hooks.slack.com/services/someSlackChannel -DbuildUrl=$APK_URL

在Pipeline中插值后执行

用双引号包裹命令，使用Jenkins环境变量语法${env.APK_URL}：

sh """
./gradlew clean test --tests "appium.some.app.Tests.*" -DincludeTags=${env.RUN_TYPE} -DwebhookUrl=https://hooks.slack.com/services/someSlackChannel -DbuildUrl=${env.APK_URL}
"""

验证步骤 #

在执行Gradle命令前添加echo命令，确认变量值已正确解析：

echo "即将传递给Gradle的APK URL: $APK_URL"

确保输出为实际的URL链接，而非${env.APK_URL}字符串。

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