原生移动开发 / 系统课时

单元测试基础

单元测试基础

单元测试的目标不是“跑过一遍代码”,而是把函数输入、状态变化和边界规则固定成可重复验证的契约。本课用本地 JVM 测试覆盖一个折扣规则,并通过 Gradle 任务确认测试真正进入自动化流程。

学习目标

  • 能用 JUnit 为纯 Kotlin 函数编写可重复的断言
  • 能验证对象状态在临界输入前后的转换
  • 能为非法值和边界值设计最小但有效的测试用例

先把测试目标缩小到可重复逻辑

Android 项目中的本地单元测试通常放在 app/src/test,适合验证不依赖真实设备、Activity、数据库文件或系统服务的逻辑。测试应围绕公开行为写断言,而不是直接测试私有函数;这样即使内部实现重构,只要外部契约没变,测试也无需跟着改。

如果模块还没有 JUnit 4 测试依赖,可在 build.gradle.kts 中确认下面的配置。配置文件本身不产生控制台结果,保存后通过 Gradle 同步或后面的测试任务验证是否生效。

kotlin
dependencies {
    testImplementation("junit:junit:4.13.2")
}

用一个测试类覆盖函数、状态和边界

下面把生产逻辑和测试类放在同一个示例里便于阅读。实际项目中,DiscountEngine 放在 src/main,DiscountEngineTest 放在 src/test。

kotlin
package com.example.testing

import org.junit.Assert.assertEquals
import org.junit.Assert.assertFalse
import org.junit.Assert.assertThrows
import org.junit.Assert.assertTrue
import org.junit.Test

class DiscountEngine(private val threshold: Int = 100) {
    var unlocked: Boolean = false
        private set

    fun finalPrice(total: Int): Int {
        require(total >= 0) { "total must be >= 0" }

        // 临界点达到 threshold 时,状态从未解锁切换为已解锁。
        unlocked = total >= threshold
        return if (unlocked) total - 10 else total
    }
}

class DiscountEngineTest {

    @Test
    fun thresholdChangesPriceAndState() {
        val engine = DiscountEngine()

        assertEquals(99, engine.finalPrice(99))
        assertFalse(engine.unlocked)

        // 100 是规则边界,既要检查返回值,也要检查状态转换。
        assertEquals(90, engine.finalPrice(100))
        assertTrue(engine.unlocked)
    }

    @Test
    fun negativeTotalIsRejected() {
        val engine = DiscountEngine()

        val error = assertThrows(IllegalArgumentException::class.java) {
            engine.finalPrice(-1)
        }

        assertEquals("total must be >= 0", error.message)
    }
}

这里刻意选择 99、100 和 -1:前两个输入跨过临界值,能验证状态转换;负数则验证非法输入是否被明确拒绝。相比大量随机值,这组用例更接近业务规则本身。

运行测试并读懂结果

在项目根目录执行模块的 Debug 单元测试任务:

bash
./gradlew testDebugUnitTest

预期输出:

text
> Task :app:testDebugUnitTest
BUILD SUCCESSFUL in <TIME>

<TIME> 会随机器和缓存状态变化。若断言失败,Gradle 会把任务标记为失败,并在测试报告中指出失败的方法;定位时先看“期望值”和“实际值”,再回到对应业务规则,而不是先修改断言让它通过。

把边界条件写成规则而不是数量

边界测试最有价值的位置通常是“刚好小于、刚好等于、刚好大于”规则阈值,以及非法输入。对于 threshold = 100,99 和 100 已经覆盖最关键的分界;如果业务还规定上限、空值或精度规则,再为那些独立契约补测试即可。

当测试只依赖输入和公开输出、没有真实网络和系统状态时,它才能在本地和 CI 中稳定复现。这样的测试既是防回归机制,也是对函数行为最精确的可执行说明。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

单元测试基础

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通