如何在Gradle管理的JUnit测试中注入路径与URL参数？

我来帮你捋清楚怎么通过系统属性实现配置注入，这个方式比直接用环境变量更贴合JVM测试场景，而且和Gradle的整合非常顺畅～

第一步：在Gradle中传递系统属性到测试任务 #

Gradle的test任务支持直接配置系统属性，有两种常用方式：

方式1：命令行临时传递 #

如果你只是临时测试某个配置，直接在执行Gradle命令时用-D参数传递系统属性就行，比如：

gradle test -Dappium.server.url=http://mobi-tester.local -Dremote.apk.path=/remote-host/apk/test.apk

这种方式适合单次运行的场景，不用修改构建脚本。

方式2：在build.gradle中统一配置（推荐） #

如果需要固定逻辑（比如读取环境变量作为默认值、给所有测试任务统一配置），可以在build.gradle（或build.gradle.kts）里给test任务添加系统属性配置：

// Groovy版本的build.gradle
test {
    // 读取环境变量USE_SERVER，不存在则用默认值
    systemProperty "appium.server.url", System.getenv("USE_SERVER") ?: "http://localhost:4723"
    // 读取环境变量REMOTE_APK_PATH，不存在则用本地默认路径
    systemProperty "remote.apk.path", System.getenv("REMOTE_APK_PATH") ?: "./build/outputs/apk/debug/app-debug.apk"
}

这样配置后，不管是本地运行还是CI环境，只要设置好对应的环境变量，Gradle就会自动把它们转成测试可用的系统属性，非常适配多环境场景。

第二步：在JUnit测试中读取系统属性 #

在测试代码里，你可以通过System.getProperty()方法读取这些系统属性，为了避免测试执行时的生命周期问题，推荐在静态代码块或者@BeforeClass（JUnit 4）/@BeforeAll（JUnit 5）中初始化配置：

JUnit 4示例 #

public class AndroidServerApiTest {
    private static String appiumServerUrl;
    private static String remoteApkPath;

    // 静态代码块初始化，确保在测试类加载时就拿到配置
    static {
        appiumServerUrl = System.getProperty("appium.server.url");
        remoteApkPath = System.getProperty("remote.apk.path");
        
        // 可选：添加非空校验，避免空指针
        if (appiumServerUrl == null) {
            throw new IllegalArgumentException("系统属性appium.server.url未设置");
        }
    }

    @Test
    public void testApiInteraction() {
        // 在这里使用配置好的变量
        System.out.println("连接Appium服务器：" + appiumServerUrl);
        System.out.println("使用远程APK路径：" + remoteApkPath);
        // 你的测试逻辑...
    }
}

JUnit 5示例 #

如果用JUnit 5，可以结合@TestInstance(TestInstance.Lifecycle.PER_CLASS)让@BeforeAll不用静态方法：

import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.TestInstance;
import org.junit.jupiter.api.Test;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class AndroidServerApiTest {
    private String appiumServerUrl;
    private String remoteApkPath;

    @BeforeAll
    void initConfig() {
        appiumServerUrl = System.getProperty("appium.server.url");
        remoteApkPath = System.getProperty("remote.apk.path");
    }

    @Test
    void testApiInteraction() {
        // 使用配置变量执行测试
    }
}

额外技巧：多CI环境适配 #

如果有多个CI环境（比如GitHub Actions、GitLab CI），你只需要在各自的CI配置文件中设置对应的环境变量（比如USE_SERVER、REMOTE_APK_PATH），Gradle会自动把它们映射成测试用的系统属性，完全不用修改测试代码，非常方便。

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