Mac环境下纯Kotlin Native项目如何通过Gradle运行测试？

问题 #

在使用Kotlin Native/Multiplatform时，若不在build.gradle.kts中引入Java/JUnit，无法运行测试，此时nativeTest任务会被跳过，提示：

Skipping task ':nativeTest' as task onlyIf is false

当前使用的精简Gradle配置如下：

plugins {
    kotlin("multiplatform") version "1.8.20"
}

// ...

kotlin {
    val hostOs = System.getProperty("os.name")
    val isMingwX64 = hostOs.startsWith("Windows")
    val nativeTarget = when {
            hostOs == "Mac OS X" -> macosX64("native")
            hostOs == "Linux" -> linuxX64("native")
            isMingwX64 -> mingwX64("native")
            else -> throw GradleException("Host OS is not supported in Kotlin/Native.")
    }

    sourceSets {
        val commonMain by getting
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test"))
            }
        }
    }
}

尝试添加JVM配置可以运行测试，但会引入不必要的JVM依赖，还得为expect提供实现，这不是当前需要的。现在想知道如何启用Kotlin Native项目的测试，比如能不能在不添加额外源码依赖的情况下引入useJUnitPlatform？

解决方案 #

1. 补全Native测试的依赖配置 #

问题核心是只给commonTest添加了通用测试依赖，但Native目标需要对应的Native测试运行时。修改sourceSets配置，为nativeTest源集添加专用依赖：

sourceSets {
    val commonMain by getting
    val commonTest by getting {
        dependencies {
            implementation(kotlin("test"))
        }
    }
    // 添加Native测试源集的依赖
    val nativeTest by getting {
        dependencies {
            implementation(kotlin("test-native"))
        }
    }
}

添加后Gradle能检测到有效的测试环境，nativeTest任务的onlyIf条件会自动变为true，无需手动修改。

2. 配置useJUnitPlatform（无需JVM依赖） #

可以直接在nativeTest任务中启用JUnit平台，不需要引入JVM目标或相关依赖：

tasks.named<Test>("nativeTest") {
    useJUnitPlatform()
}

结合上面的test-native依赖，就能正常执行Native测试，不会触发JVM相关的expect实现要求。

3. 强制跳过onlyIf检查（应急方案） #

如果上述步骤后任务仍被跳过，可以手动覆盖onlyIf条件，但这只是临时方案，优先建议补全依赖：

tasks.named<Test>("nativeTest") {
    onlyIf { true }
}

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