当前位置：首页>安卓APP>保姆级学习开发安卓手机软件(十七)--自动化测试总结

保姆级学习开发安卓手机软件(十七)--自动化测试总结

2026-08-22 20:26:05

 testImplementation("junit:junit:4.13.2")

是单一的JUnit依赖，只能够测试纯函数（测试无 Android 依赖的纯函数）：

但官方教程中使用的是如下依赖：

// Required -- JUnit 4 framework  testImplementation "junit:junit:$jUnitVersion"  // Optional -- Robolectric environment  testImplementation "androidx.test:core:$androidXTestVersion"  // Optional -- Mockito framework  testImplementation "org.mockito:mockito-core:$mockitoVersion"  // Optional -- mockito-kotlin  testImplementation "org.mockito.kotlin:mockito-kotlin:$mockitoKotlinVersion"  // Optional -- Mockk framework  testImplementation "io.mockk:mockk:$mockkVersion"

后者能模拟 Android 环境、Mock 数据，适配 Android 项目的复杂测试场景。

具体来说，我们上节使用依赖的和官方第一句依赖是一致的，是基础核心 JUnit （提供@Test、assertEquals、assertTrue等基础测试注解 / 方法）。

写法不同的原因是我们是固定写法，使用了4.13.2框架，但是官方的例子中是用$jUnitVersion（版本变量）管理版本（比如在build.gradle.kts顶部定义val jUnitVersion = "4.13.2"），更便于统一维护（改一处即可更新所有依赖版本，多用于大型多模块项目）。

而后者添加的其他扩展依赖，我们也做一个说明：

依赖	作用	有什么用？
androidx.test:core	提供 Android 环境模拟（Robolectric）	测试依赖`Context`、`Resources`的代码（比如`stringResource()`）
org.mockito:mockito-core	Java 生态的 Mock 框架	模拟接口 / 类的返回值（比如模拟网络请求、数据库查询）
org.mockito.kotlin	Mockito 的 Kotlin 语法适配	用 Kotlin 简洁语法写 Mock（避免 Java 语法的冗余）
io.mockk:mockk	Kotlin 专属的 Mock 框架（比 Mockito 更贴合 Kotlin）	更优雅地 Mock Kotlin 的伴生对象、扩展函数等

举一些简单的例子吧（例如获取资源）。

// 依赖Context获取骰子对应的文字（比如R.string.dice_1 = "骰子1"）fungetDiceText(context: Context, num: Int): String {    return when(num) {        1 -> context.getString(R.string.dice_1)        2 -> context.getString(R.string.dice_2)        3 -> context.getString(R.string.dice_3)        4 -> context.getString(R.string.dice_4)        5 -> context.getString(R.string.dice_5)        6 -> context.getString(R.string.dice_6)        else -> context.getString(R.string.dice_default)    }}

那测试的时候：

// ❌ 测试用例：基础JUnit测试Context/R.string    @Test    fungetDiceText_input1_returnsDice1() {        // 问题1：JVM中无法创建真实的Android Context        val context: Context? = null         // 问题2：即使传null，调用context.getString(R.string.dice_1)会空指针        val result = getDiceText(context!!, 1)         assertEquals("骰子1", result)    }

只用基础 JUnit 会报错（找不到Context、R.string）

，必须加androidx.test:core（Robolectric）模拟 Android 环境，才能正常测试。（Robolectric 是由 Google 维护的一个开源框架，可让您在 JVM 内的模拟 Android 环境中运行测试，而不会产生模拟器的开销和不稳定的情况。它支持 Lollipop（API 级别 21）及更高版本的 Android。但Robolectric 无法完全取代模拟器，因为它不支持所有功能和 API。例如，Robolectric 没有模拟器那样的屏幕，并且某些 API 仅部分受支持。不过，它模拟了 Android 的足够部分，可靠地运行单元测试和大多数界面测试。）

点击「Sync Now」同步依赖，错误就消失了：

简单来说，前者是「基础款」（满足纯函数测试），后者是「豪华款」（适配 Android 全场景测试）—— 按需选择即可，无需盲目追求「全依赖」✨！

2.有关语法

测试方法以 @Test 注解开头，包含的代码，用于练习和验证资源。

assertEquals函数有很多输入类型：

还有一些其他方法（未列举全）：

总的来说语法比较简单，就是断言期待值和实际值是否一致或者是否正确等。

二、插桩测试

1.解释说明

普通 JUnit 测试：代码跑在电脑的 JVM 上，和 Android 设备无关；测试代码位置src/test/java，
插桩测试：测试代码会被「打包进 APP」，安装到真机 / 模拟器上运行，测试代码和 APP 代码在同一个 Android 环境中「联动执行」，就像给 APP 装了一个「测试插件」，能直接操作 APP 的所有功能。测试代码位置src/androidTest/java/
例如我们上节用的UI测试就是典型的插桩测试。我们主要后续讲解的就是UI测试，其他的这里不多讲，后续用到再言，如果大家有兴趣，也可以自行看看官方例子：
https://github.com/android/testing-samples/tree/main/unit/BasicUnitAndroidTest

2.有关依赖

上节我们添加了依赖：

// 你的插桩测试依赖androidTestImplementation("androidx.test.ext:junit:1.1.5") // JUnit4 Android适配androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1") // Espresso核心androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.6.0") // Compose UI测试核心debugImplementation("androidx.compose.ui:ui-test-manifest:1.6.0") // Compose测试清单

官方依赖：

    androidTestImplementation "androidx.test:runner:$androidXTestVersion"    androidTestImplementation "androidx.test:rules:$androidXTestVersion"    // Optional -- UI testing with Espresso    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"    // Optional -- UI testing with UI Automator    androidTestImplementation "androidx.test.uiautomator:uiautomator:$uiAutomatorVersion"    // Optional -- UI testing with Compose    androidTestImplementation "androidx.compose.ui:ui-test-junit4:$compose_version"

所以融合官方方案，我们可以精简为如下依赖：

// 版本变量（统一管理，符合官方最佳实践）val androidXTestVersion = "1.6.1"val espressoVersion = "3.5.1"val composeUiTestVersion = "1.6.0"dependencies {    // 基础：插桩测试运行核心（官方显式声明）    androidTestImplementation("androidx.test:runner:$androidXTestVersion")    androidTestImplementation("androidx.test:rules:$androidXTestVersion")    // JUnit4 Android适配（你的原有依赖，保留）    androidTestImplementation("androidx.test.ext:junit:1.1.5")    // Espresso核心（双方重叠，保留）    androidTestImplementation("androidx.test.espresso:espresso-core:$espressoVersion")    // Compose UI测试核心（你的原有依赖，保留）    androidTestImplementation("androidx.compose.ui:ui-test-junit4:$composeUiTestVersion")    debugImplementation("androidx.compose.ui:ui-test-manifest:$composeUiTestVersion")    // 无需添加：uiautomator（你的项目用不到，跨app测试才用得到）}

3.有关语法

上节我们使用了Compose 测试规则：

（1）常用元素定位函数（找控件）

函数名	作用说明	语法格式	适配场景	项目示例
onNodeWithTag(tag)	通过唯一测试标签定位（优先级最高，不受文字 / 布局影响）	composeTestRule.onNodeWithTag("tag值")	所有需要稳定定位的控件（输入框、开关、按钮）	`onNodeWithTag("dice_input_field")` （骰子输入框）
onNodeWithText(text)	通过文字内容定位（支持精确 / 模糊匹配）	composeTestRule.onNodeWithText("文字")	按钮、静态文本、输入框占位符	`onNodeWithText("确定")` （确定按钮）
onNodeWithContentDescription(desc)	通过图片的描述文本定位（Image 组件专属）	composeTestRule.onNodeWithContentDescription("描述")	骰子图片、图标等无文字的 Image 组件	`onNodeWithContentDescription("5")` （5 点骰子）
onNode(selector)	通过语义属性组合定位（兜底方案）	composeTestRule.onNode(语义匹配器)	无标签 / 无文字的控件（如 Switch）	`onNode(hasRole(Role.Switch))` （礼物开关）
onAllNodesWithXXX()	定位所有匹配的元素（如所有骰子图片）	composeTestRule.onAllNodesWithContentDescription(Regex("[1-6]"))	列表、随机场景（掷骰子）	验证 1-6 中任意骰子图片显示

ps:onNodeWithTag需要在主代码中给控件加modifier.testTag("xxx")；语义匹配器需导入：hasRole/hasKeyboardType/hasTextInput等。

（2）操作函数（模拟用户行为）

函数名	作用说明	语法格式	适配场景	项目示例
performClick()	模拟点击操作（可点击元素专属	定位函数.performClick()	按钮、开关、图片点击	`onNodeWithTag("gift_switch").performClick()` （点击开关）
`performTextInput(text)`	模拟输入文字（输入框专属）	定位函数.performTextInput("内容")	数字 / 文本输入框	onNodeWithTag("dice_input_field").performTextInput("5")
performTextClear()	清空输入框内容	定位函数.performTextClear()	输入框重置	onNodeWithTag("dice_input_field").performTextClear()
performScrollTo()	滚动到元素可见区域（可滚动布局专属）	定位函数.performScrollTo()	长列表、垂直滚动的 Column（你的骰子页面）	onNodeWithText("掷骰子").performScrollTo()

（3）断言验证函数（验证结果是否符合预期）

函数名	作用说明	语法格式	适配场景	项目示例
assertIsDisplayed()	验证元素是否显示（最常用）	定位函数.assertIsDisplayed()	图片、文字、按钮是否显示	onNodeWithContentDescription("5").assertIsDisplayed()
assertIsNotDisplayed()	验证元素是否隐藏	`定位函数.assertIsNotDisplayed()`	开关关闭后礼物文字是否隐藏	onNodeWithText("礼物3").assertIsNotDisplayed()
assertTextEquals(text)	验证元素文字是否完全匹配	定位函数.assertTextEquals("内容")	输入框内容、静态文本验证	onNodeWithTag("dice_input_field").assertTextEquals("5")
assertExists()	验证元素存在（不关心是否显示）	定位函数.assertExists()	验证控件是否存在（如掷骰子按钮）	`onNodeWithText("掷骰子").assertExists()`
assertDoesNotExist()	验证元不素存在（不关心是否显示）	定位函数.assertDoesNotExist()	验证无效元素（如 7 点骰子）	onNodeWithContentDescription("7").assertDoesNotExist()
assertAny { ... }	验证多个元素中至少一个符合条件	onAllNodesXXX().assertAny { 断言 }	随机场景（掷骰子）	onAllNodesWithContentDescription(Regex("[1-6]")).assertAny { it.assertIsDisplayed() }