如何为Android插桩测试配置numShards和shardIndex？Gradle报错解析

什么是Android Gradle DSL？ #

Android Gradle DSL是Android Gradle插件提供的专属配置语法，让你直接在模块的build.gradle（或build.gradle.kts）文件里定义构建、测试相关参数，替代命令行或gradle.properties的传参方式，以此兼容Gradle的配置缓存特性。

具体配置步骤 #

1. 打开App模块下的build.gradle（Groovy语法）或build.gradle.kts（Kotlin语法）文件。
2. 在android闭包内添加testOptions配置，指定numShards参数：

Groovy语法示例（build.gradle）

android {
    // 保留原有配置（如compileSdk、defaultConfig等）

    testOptions {
        // 可选：使用AndroidX测试 orchestrator时保留，否则可删除
        execution 'ANDROIDX_TEST_ORCHESTRATOR'
        // 配置分片数量
        instrumentationRunnerArguments += [
            'numShards': '5'
        ]
    }
}

Kotlin语法示例（build.gradle.kts）

android {
    // 保留原有配置

    testOptions {
        // 可选：使用AndroidX测试 orchestrator时保留，否则可删除
        execution = "ANDROIDX_TEST_ORCHESTRATOR"
        // 配置分片数量
        instrumentationRunnerArguments["numShards"] = "5"
    }
}

3. 保存文件后，直接执行命令即可，无需再传递命令行参数：

gradlew connectedCheck

为什么要这么做？ #

Gradle配置缓存要求构建配置稳定可预测，命令行动态传参会破坏缓存有效性。通过Android Gradle DSL配置测试参数，能让构建配置静态化，从而兼容配置缓存，提升后续构建速度。

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