为Kotlin Android项目添加单元测试时Gradle配置报错求助

问题原因 #

你按照纯Kotlin JVM项目的文档配置了测试，但Android项目的Gradle配置逻辑和纯JVM项目存在差异：

• 直接修改tasks.test会和Android Gradle Plugin的测试任务管理机制冲突
• kotlin("test")是纯JVM项目的依赖包，Android项目需要使用AndroidX适配的JUnit依赖

修正后的配置 #

1. 替换测试依赖 #

把dependencies块里的testImplementation(kotlin("test"))替换为AndroidX适配的JUnit 5依赖（推荐使用JUnit 5，是当前主流版本）：

dependencies {
    // 保留原有其他依赖...
    // JUnit 5 核心依赖
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.0")
    // Kotlin测试扩展（可选，提供更简洁的断言语法）
    testImplementation("io.kotest:kotest-assertions-core:5.8.0")
}

如果偏好使用JUnit 4，可替换为以下依赖：

dependencies {
    // 保留原有其他依赖...
    testImplementation("junit:junit:4.13.2")
    testImplementation("androidx.test.ext:junit:1.1.5")
}

2. 正确配置JUnit Platform #

删除根目录下的tasks.test { useJUnitPlatform() }，转而在android块内添加测试配置：

android {
    // 保留原有其他配置...
    testOptions {
        unitTests {
            // 启用JUnit Platform（针对JUnit 5）
            useJUnitPlatform()
        }
    }
}

完整修正后的build.gradle.kts（关键部分） #

plugins {
    alias(libs.plugins.androidApplication)
    alias(libs.plugins.kotlinAndroid)
    alias(libs.plugins.compose.compiler)
}

android {
    namespace = "com.example.myapp"
    compileSdk = 34
    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }
    buildFeatures {
        compose = true
    }
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
        }
    }
    buildTypes {
        getByName("release") {
            isMinifyEnabled = false
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    // 添加测试配置
    testOptions {
        unitTests {
            useJUnitPlatform()
        }
    }
}

dependencies {
    implementation(projects.shared)
    implementation(libs.compose.ui)
    implementation(libs.compose.ui.tooling.preview)
    implementation(libs.compose.material3)
    implementation(libs.androidx.activity.compose)
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1")
    implementation("androidx.activity:activity-compose:1.8.0")
    debugImplementation(libs.compose.ui.tooling)
    
    // JUnit 5 测试依赖
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.10.0")
    testImplementation("io.kotest:kotest-assertions-core:5.8.0")
}

后续操作 #

1. 点击Android Studio右上角的「Sync Project with Gradle Files」按钮同步配置
2. 在src/test/java/com/example/myapp目录下创建测试类，示例：

import org.junit.jupiter.api.Test
import io.kotest.assertions.assertThat

class ExampleUnitTest {
    @Test
    fun addition_isCorrect() {
        assertThat(2 + 2).isEqualTo(4)
    }
}

3. 右键测试类或方法，选择「Run」即可执行单元测试

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