第1章 测试夹具概念与Compose框架概述
1.1 测试夹具（Test Fixture）定义
测试夹具是指为执行自动化测试而预先准备好的环境、状态、数据或对象集合。在 Jetpack Compose 场景中，夹具通常包含：
- 待测试的 Composable 组件实例
- 模拟的依赖注入容器或 ViewModel
- 固定主题、字体、屏幕密度等渲染配置
- 预先填充的界面状态（Text 内容、列表数据）
- 用于验证结果的 Semantics 节点树
简而言之，夹具是“测试运行前必须就位的战场”，它决定了测试的可重复性和隔离性。
核心原则：好的夹具应保证每次运行结果一致，不依赖外部资源（网络、文件、系统时钟），且能够快速创建和销毁。
1.2 Compose 测试框架特点
Jetpack Compose 的测试能力建立在 androidx.compose.ui.test 包之上，与传统的 View 系统测试有显著差异：
| 维度 | 传统 View 测试 | Compose 测试 |
|---|---|---|
| 组件查找 | 通过 ID / Resource ID | 通过 Semantics 属性（内容描述、标签、角色） |
| 交互方式 | onView() + performClick() |
onNodeWithText() + performClick() |
| 主线程同步 | 需要 IdlingResource 手动控制 |
ComposeTestRule 自动等待 recomposition |
| 动画处理 | 需禁用或等待动画结束 | 默认禁用动画，支持 mainClock 控制帧 |
| 启动速度 | 较慢（需加载 Activity/Fragment） | 较快（可直接创建 Composable 实例） |
Compose 测试的核心入口是 ComposeTestRule 及其子类 createComposeRule()。该规则会内置一个 ComposeViewHolder，负责管理 Composable 的生命周期和布局。
1.3 本章核心：课程目标与学习路径
本课程旨在帮助你从零搭建一套稳定、高效、可维护的 Compose 测试夹具环境。完成后你将能够：
- 掌握 Gradle 测试依赖声明与模块化配置
- 创建自定义
ComposeTestRule，集成 Hilt / WorkManager / Navigation 等第三方库 - 编写可复用的 Test Fixture 辅助函数，减少模板代码
- 调试常见的 Semantics 不匹配、Recomposition 陷阱、内存泄漏
- 优化测试执行速度，利用
mainClock控制时间与动画 - 部署到 CI（GitHub Actions）并集成覆盖率报告
学习建议：本章是后续29章的基石。每学习一个新测试框架时，请先在本地新建一个空 Compose 项目，按照本课程中的配置步骤亲手实践。不要跳过。
1.4 Compose 夹具环境全景图
下图展示了 Compose 测试夹具环境的核心组件及其关系：
1.5 课程章节总览
全课程共30章，本章之后你将依次学习：
- Gradle 依赖配置（JUnit + Compose + Espresso + MockK）
- 创建第一个 ComposeTestRule 并验证文本显示
- Semantics 属性详解与自定义语义节点
- 模拟 ViewModel 与状态注入
- 主题与黑暗模式夹具
- 测试长按、滑动、键盘输入等复杂手势
- Hilt 集成与自定义 TestModule
- Navigation 测试：路由与返回栈
- 动画时间控制与 Perf 测试
- …（后续章节见完整目录）
常见误解：不要认为 Compose 测试“只是换了个断言库”。Compose 的 Recomposition 机制和 Semantics 树结构与传统 View 系统完全不同，必须重新理解“测试何时能与 UI 同步”。
1.6 本节知识自查表
| 术语 | 你是否能解释？ |
|---|---|
| Test Fixture | 测试前准备好的环境与数据稳定状态 |
| ComposeTestRule | 管理 Composable 生命周期和语义树的测试规则 |
| Semantics 树 | Compose 中用于无障碍和测试的节点描述结构 |
| MainClock | 控制虚拟帧，可快进时间以触发动画或延迟 |
| ComposeViewHolder | 底层 View 容器，用于在普通 View 层次中嵌入 Composable |
请确保在进入下一章之前，已完整理解上述概念。如果某个术语模糊，建议回到本章对应段落复习。
额外练习：创建一个空 Compose 项目，在
build.gradle.kts 中添加 androidx.compose.ui:ui-test-junit4 依赖，然后尝试运行 createComposeRule() 的默认空测试并观察日志输出。即使没有断言，也能感受夹具的创建过程。