原生移动开发 / 系统课时
单元测试基础
单元测试基础
单元测试的目标不是“跑过一遍代码”,而是把函数输入、状态变化和边界规则固定成可重复验证的契约。本课用本地 JVM 测试覆盖一个折扣规则,并通过 Gradle 任务确认测试真正进入自动化流程。
学习目标
- 能用 JUnit 为纯 Kotlin 函数编写可重复的断言
- 能验证对象状态在临界输入前后的转换
- 能为非法值和边界值设计最小但有效的测试用例
先把测试目标缩小到可重复逻辑
Android 项目中的本地单元测试通常放在 app/src/test,适合验证不依赖真实设备、Activity、数据库文件或系统服务的逻辑。测试应围绕公开行为写断言,而不是直接测试私有函数;这样即使内部实现重构,只要外部契约没变,测试也无需跟着改。
如果模块还没有 JUnit 4 测试依赖,可在 build.gradle.kts 中确认下面的配置。配置文件本身不产生控制台结果,保存后通过 Gradle 同步或后面的测试任务验证是否生效。
dependencies {
testImplementation("junit:junit:4.13.2")
}用一个测试类覆盖函数、状态和边界
下面把生产逻辑和测试类放在同一个示例里便于阅读。实际项目中,DiscountEngine 放在 src/main,DiscountEngineTest 放在 src/test。
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 单元测试任务:
./gradlew testDebugUnitTest预期输出:
> Task :app:testDebugUnitTest
BUILD SUCCESSFUL in <TIME><TIME> 会随机器和缓存状态变化。若断言失败,Gradle 会把任务标记为失败,并在测试报告中指出失败的方法;定位时先看“期望值”和“实际值”,再回到对应业务规则,而不是先修改断言让它通过。
把边界条件写成规则而不是数量
边界测试最有价值的位置通常是“刚好小于、刚好等于、刚好大于”规则阈值,以及非法输入。对于 threshold = 100,99 和 100 已经覆盖最关键的分界;如果业务还规定上限、空值或精度规则,再为那些独立契约补测试即可。
当测试只依赖输入和公开输出、没有真实网络和系统状态时,它才能在本地和 CI 中稳定复现。这样的测试既是防回归机制,也是对函数行为最精确的可执行说明。