第17课完成了性能优化的学习。本课深入CMP测试与质量保障的核心实践:分层测试策略(单元测试、UI测试、截图回归、平台特定测试)、v2 ComposeUiTest API的变化、语义树在UI测试中的应用、测试中的依赖替换与Koin的已知限制、平台特定测试(Android Instrumented Test与iOS XCTest)、截图回归测试方案,以及CI/CD中的测试自动化与质量门禁。本课内容基于CMP 1.12.1、Kotlin 2.3.20与Lifecycle 2.10.0。
目录
- 一、测试金字塔与分层策略
- 二、v2 ComposeUiTest API:CMP 1.11.0的变化
- 三、单元测试:commonTest中的业务逻辑验证
- 四、Compose UI测试与Koin的已知限制
- 五、截图回归测试
- 六、平台特定测试与CI/CD
- 配套习题(15题)
- 本课知识点总结
文末附有15道配套习题与本课知识点总结。
一、测试金字塔与分层策略
1.1 为什么CMP的测试策略与单平台不同
CMP项目的测试策略与单平台项目有本质区别。在单平台项目中,开发者可能习惯将所有测试都写在 androidTest 或 XCTest 中。但CMP的核心价值是共享代码,如果核心业务逻辑的测试必须重复编写三遍,共享代码的优势就被削弱了。
CMP测试策略的核心原则是:核心逻辑共享测试,平台差异分别测试。
1.2 分层测试金字塔
| 层级 | 测试类型 | 源集 | 运行平台 | 测试内容 |
|---|---|---|---|---|
| 底层(最多) | 单元测试 | commonTest | 所有平台共享 | ViewModel、UseCase、Repository、数据转换、状态校验 |
| 中层 | Compose UI测试 | commonTest | 所有平台共享 | Composable的语义断言、交互验证 |
| 中层 | 截图回归测试 | 平台特定源集 | Android/JVM/iOS | 视觉回归检测 |
| 顶层(最少) | 平台特定测试 | androidInstrumentedTest / iosTest | 各自平台 | 平台SDK集成、expect/actual实现、原生互操作 |
核心业务逻辑的测试不需要重复三遍——ViewModel、UseCase、Repository的逻辑、数据转换、状态校验,全部在 commonMain 中,这些测试写在 commonTest 中,一次编写,所有平台共享。这是CMP测试体系最大的优势。
下面是 CMP 分层测试金字塔的示意图:
flowchart TD
subgraph Top["顶层(最少)"]
A["平台特定测试<br/>androidInstrumentedTest / iosTest"]
end
subgraph Middle["中层"]
B["Compose UI测试<br/>commonTest"]
C["截图回归测试<br/>平台特定源集"]
end
subgraph Bottom["底层(最多)"]
D["单元测试<br/>commonTest"]
end
D --> B
D --> C
B --> A
C --> A
1.3 CMP UI测试与Jetpack Compose测试的差异
Compose Multiplatform的UI测试使用与Jetpack Compose相同的查找器、断言、操作和匹配器,但公共测试API不依赖JUnit的 TestRule 类。开发者调用 runComposeUiTest 函数,在 ComposeUiTest 接收者上调用测试函数。JUnit风格的API仅在Desktop目标上可用。
// CMP commonTest 风格
@OptIn(ExperimentalTestApi::class)
@Test
fun `clicking updates label`() = runComposeUiTest {
setContent { CounterScreen() }
onNodeWithText("Count: 0").assertIsDisplayed()
onNodeWithText("Increment").performClick()
onNodeWithText("Count: 1").assertIsDisplayed()
}
// Desktop 专用 JUnit 风格
class ExampleTest {
@get:Rule val rule = createComposeRule()
@Test
fun myTest() {
rule.setContent { /* ... */ }
rule.onNodeWithTag("text").assertTextEquals("Hello")
rule.onNodeWithTag("button").performClick()
}
}
二、v2 ComposeUiTest API:CMP 1.11.0的变化
2.1 核心变化
CMP 1.11.0对非Android目标的测试API进行了重要升级,引入了 v2 ComposeUiTest API。核心变化如下:
| 维度 | v1 API | v2 API |
|---|---|---|
| 默认调度器 | UnconfinedTestDispatcher | StandardTestDispatcher |
| 协程行为 | 立即执行 | 按队列顺序执行,需显式推进虚拟时钟 |
| 新增参数 | 无 | effectContext、runTestContext、testTimeout |
| 旧API状态 | 可用 | 已弃用(runComposeUiTest、runSkikoComposeUiTest、runDesktopComposeUiTest) |
v2 API默认使用 StandardTestDispatcher 运行组合,协程启动后会被加入队列,直到测试显式推进虚拟时钟才会执行。这与生产环境的行为更接近,使测试更可预测。
effectContext 参数:v2 API接受 effectContext 参数,用于向组合传递自定义协程上下文,可用于覆盖动画时长缩放比例或提供自定义测试调度器。runTestContext 参数用于控制 runTest 的行为。
下面是 v1 到 v2 API 的核心变化流程:
flowchart LR
subgraph V1["v1 API"]
A1["UnconfinedTestDispatcher<br/>协程立即执行"]
end
subgraph V2["v2 API"]
B1["StandardTestDispatcher<br/>协程按队列顺序执行"]
B2["新增 effectContext / runTestContext / testTimeout"]
B3["旧API已弃用"]
end
A1 -->|"升级"| B1
B1 --> B2
B2 --> B3
2.2 测试依赖配置
在 shared/build.gradle.kts 中,将UI测试库添加到 commonTest 源集:
kotlin {
sourceSets {
commonTest.dependencies {
implementation("org.jetbrains.compose.ui:ui-test:1.11.1")
}
jvmTest.dependencies {
implementation(compose.desktop.currentOs)
}
}
}
如需运行Android的instrumented(模拟器)测试,需要在 androidLibrary {} 块中配置instrumented测试源集依赖common test源集,并在 androidApp/build.gradle.kts 中配置Instrumentation Runner和依赖。
三、单元测试:commonTest中的业务逻辑验证
3.1 测试源集布局
shared/src/
├── commonTest/ # 共享单元测试 + Compose UI测试
│ └── kotlin/
├── jvmTest/ # JVM专用:headless Compose UI测试
│ └── kotlin/
├── androidHostTest/ # Robolectric + Roborazzi 截图测试
│ └── kotlin/
└── androidInstrumentedTest/ # 平台集成测试
└── kotlin/
3.2 ViewModel测试:Dispatcher注入与状态断言
ViewModel测试的核心模式是注入测试Dispatcher,使协程同步执行:
class CounterViewModelTest {
@BeforeTest
fun setUp() {
Dispatchers.setMain(StandardTestDispatcher())
}
@AfterTest
fun tearDown() {
Dispatchers.resetMain()
}
@Test
fun `incrementing emits initial then updated state`() = runTest {
val viewModel = SampleCounterViewModel()
val emissions = mutableListOf<SampleCounterUiState>()
val job = launch(UnconfinedTestDispatcher(testScheduler)) {
viewModel.uiState.toList(emissions)
}
viewModel.onUiEvent(Increment)
viewModel.onUiEvent(Increment)
advanceUntilIdle()
assertEquals(SampleCounterUiState(count = 2), emissions.last())
job.cancel()
}
}
测试要点:通过 Dispatchers.setMain() 覆盖Main调度器,使 viewModelScope 在测试Dispatcher上运行;使用 advanceUntilIdle() 推进虚拟时间;收集 StateFlow 的发射序列进行断言。
3.3 为什么KMP测试推荐Fake而非Mock
KMP社区推荐使用手写Fake实现替代Mock框架,原因有三:Fake不依赖反射,在KMP所有目标上均可运行;Fake的行为更接近真实实现,测试更可靠;ViewModel通过构造函数接收Repository,测试时注入Fake即可。RevenueCat在其CMP订阅测试实践中也明确推荐Fake而非Mock,因为KMP所有目标上Mock框架的反射机制不可用。
class FakeUserRepository : UserRepository {
private val users = mutableMapOf<Long, User>()
var shouldFail = false
override suspend fun getUser(id: Long): Result<User> {
if (shouldFail) return Result.failure(IOException("Network error"))
return users[id]?.let { Result.success(it) } ?: Result.failure(NoSuchElementException())
}
fun setUser(user: User) { users[user.id] = user }
}
四、Compose UI测试与Koin的已知限制
4.1 语义树在UI测试中的应用
优先使用 contentDescription 和 testTag 而非文本——本地化字符串会破坏基于文本的匹配器。在CMP中,Res.string.xxx 生成的文本随locale变化,硬编码的文本断言在不同语言环境下会失败。
// ✅ 推荐:使用testTag
onNodeWithTag("loginButton").assertIsEnabled()
// ✅ 推荐:使用contentDescription
onNodeWithContentDescription("Remove from favorites").performClick()
// ❌ 不推荐:硬编码本地化文本
onNodeWithText("登录").assertIsDisplayed()
// 组合匹配器
onNode(hasText("Save") and isEnabled()).performClick()
4.2 Koin在Compose UI测试中的已知限制
这是CMP测试中最重要的已知限制。CMP提供了 runComposeUiTest {} API,可在 commonTest 和 androidInstrumentedTest 中运行UI测试,覆盖Android、Desktop、iOS和Web。但Koin当前假设Android UI测试始终在AndroidJUnitRunner下运行,并使用自定义Application来启动Koin,这与CMP UI测试的工作方式不兼容。具体表现为:
- Koin无法安全地在
runComposeUiTest {}内部初始化 KoinTest和KoinTestExtension在CMP UI测试中不工作- 尝试注入依赖会意外触发生产环境的Koin图
- 没有官方方式为每次测试运行加载作用域限定的测试模块
当前推荐的解决方案:在Compose UI测试中使用手动依赖注入替代Koin容器——直接构造ViewModel并传入Fake Repository,而非通过Koin解析。
@OptIn(ExperimentalTestApi::class)
@Test
fun `user screen displays name`() = runComposeUiTest {
val fakeRepository = FakeUserRepository().apply {
setUser(User(1, "Alice", "alice@example.com"))
}
val viewModel = UserViewModel(GetUserUseCase(fakeRepository))
setContent { UserScreen(viewModel = viewModel) }
onNodeWithText("Alice").assertIsDisplayed()
}
重要规则:runComposeUiTest {} 和 ComposeTestRule 不能在同一测试中混用。setContent 只能调用一次。不要在 runComposeUiTest 函数外部持有 ComposeUiTest 的引用。
五、截图回归测试
5.1 截图测试的分平台方案
CMP目前没有一等公民的共享截图测试API。各平台的截图测试方案如下:
| 平台 | 推荐方案 | 说明 |
|---|---|---|
| Android(CI首选) | Paparazzi | 无需设备即可渲染Compose,基于标准Jetpack Compose |
| Desktop / JVM | Roborazzi | 生成PNG文件进行对比,支持CMP |
| iOS | Xcode UI Tests + XCTAttachment | 驱动真实模拟器截图对比 |
5.2 Roborazzi + ComposablePreviewScanner 自动化方案
ComposablePreviewScanner是一个Compose Multiplatform友好的库,帮助从Composable Preview自动生成截图测试,可与任何截图测试库配合使用(JVM-based如Paparazzi、Roborazzi,或Instrumentation-based如Shot、Dropshots等)。
Roborazzi已从1.22.0版本(Android)和1.70.0版本(Desktop)起将ComposablePreviewScanner作为核心依赖集成,用于原生Compose Preview支持。开发者只需添加 @Preview 注解并重新运行,无需编写测试类:
// 添加@Preview即可自动纳入截图测试
@Preview
@Composable
fun UserCardPreview() {
MaterialTheme { UserCard(User(1, "Alice")) }
}
# 刷新golden文件(UI变更后)
./gradlew :shared:recordRoborazziDebug
# CI中验证截图是否匹配
./gradlew :shared:verifyRoborazziDebug
ComposablePreviewScanner支持扫描不同源集中的Preview(main、screenshotTest、androidTest),支持Compose Multiplatform中的Android、Desktop/JVM和Common位置。
下面是 Roborazzi + ComposablePreviewScanner 的截图测试自动化流程:
flowchart LR
A["添加 @Preview 注解"] --> B["ComposablePreviewScanner 扫描"]
B --> C["自动生成截图测试"]
C --> D["recordRoborazziDebug<br/>刷新 golden 文件"]
D --> E["verifyRoborazziDebug<br/>CI 中验证截图匹配"]
5.3 Paparazzi在CMP中的适用性
Paparazzi在Android composeTarget 下使用标准Jetpack Compose,因此与CMP兼容。它无需设备或模拟器,渲染速度快,非常适合CI环境。但需要注意,Paparazzi仅支持Android平台,对KMP/CMP的跨平台支持有限,渲染的是Android风格的Compose,可能与iOS/Desktop的Skiko渲染存在像素级差异。
六、平台特定测试与CI/CD
6.1 Android Instrumented Test与iOS XCTest
Android平台使用JUnit + Espresso/UIAutomator进行UI测试,androidInstrumentedTest 源集用于测试平台特定的行为(如AndroidView互操作、权限请求)。iOS平台使用XCTest进行平台特定测试。
对于跨平台E2E测试场景,Appium有较广泛的平台覆盖但设置复杂且执行较慢,Parikshan等E2E测试框架正在探索更原生的CMP E2E方案。对于iOS端,testTag 会正确映射到原生的 accessibilityIdentifier,使Compose语义数据可被XCTest框架使用。
6.2 CI/CD质量门禁
生产级CMP项目的CI流水线在每次PR时运行以下检查:
# .github/workflows/pr_checks.yml 示例
name: PR Checks
on: [pull_request]
jobs:
checks:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Format & Lint
run: ./gradlew spotlessCheck
- name: Unit Tests
run: ./gradlew :shared:jvmTest :shared:testAndroidHostTest
- name: Compose UI Tests
run: ./gradlew :shared:jvmTest
- name: Screenshot Regression
run: ./gradlew :shared:verifyRoborazziDebug
- name: Android Debug Build
run: ./gradlew :androidApp:assembleDebug
JetBrains官方推荐的KMP CI配置使用复合Action统一Java和Gradle设置,主工作流在每次push或PR到main分支时运行共享测试(jvmTest)并触发各平台构建。Gradle配置建议禁用Gradle daemon并启用并行执行和缓存:
env:
GRADLE_OPTS: "-Dorg.gradle.jvmargs=-Xmx4096M -Dorg.gradle.daemon=false -Dorg.gradle.parallel=true -Dorg.gradle.caching=true"
下面是 CMP 项目 CI/CD 质量门禁流水线:
flowchart TD
A["PR 触发"] --> B["Spotless + ktlint 格式化检查"]
B --> C["单元测试<br/>jvmTest + testAndroidHostTest"]
C --> D["Compose UI 测试<br/>jvmTest"]
D --> E["截图回归测试<br/>verifyRoborazziDebug"]
E --> F["Android Debug 构建<br/>assembleDebug"]
F --> G["质量门禁通过"]
6.3 多平台CI矩阵
| Job | Runner | 执行内容 |
|---|---|---|
test-shared | ubuntu-latest | commonTest + jvmTest(单元测试 + Compose UI测试) |
test-android | ubuntu-latest | androidHostTest(Roborazzi截图测试) |
test-ios | macos-latest | iosSimulatorArm64Test + Xcode UI Tests |
build-android | ubuntu-latest | androidApp:assembleDebug |
build-ios | macos-latest | Xcode archive |
6.4 格式化与静态检查
Spotless + ktlint 是KMP项目的标准格式化方案。Compose友好的默认配置需要关闭与框架冲突的规则:
spotless {
kotlin {
ktlint().editorConfigOverride(mapOf(
"ktlint_function_naming_ignore_when_annotated_with" to "Composable",
"ktlint_standard_no-wildcard-imports" to "disabled",
))
}
}
配套习题(15题)
第一组:测试分层与策略(4题)
第1题 CMP测试策略的核心原则是( )
A. 所有测试都写在androidTest中 B. 核心业务逻辑测试在commonTest中共享,平台差异在平台特定源集中测试 C. 只为Android平台编写测试 D. 不需要测试,因为代码是共享的
答案:B
解析:CMP测试策略的核心原则是核心逻辑共享测试,平台差异分别测试。ViewModel、UseCase、Repository的逻辑、数据转换、状态校验全部在commonMain中,这些测试写在commonTest中,一次编写,所有平台共享。
第2题 CMP的公共UI测试API与Jetpack Compose的核心差异是( )
A. CMP使用完全不同的断言API B. CMP不依赖JUnit的TestRule类,而是调用runComposeUiTest函数 C. CMP不支持语义断言 D. CMP只支持Android平台
答案:B
解析:Compose Multiplatform的公共测试API不依赖JUnit的TestRule类。开发者调用 runComposeUiTest 函数,在 ComposeUiTest 接收者上调用测试函数。JUnit风格API仅在Desktop目标上可用。
第3题 以下哪类测试不适合放在 commonTest 中?( )
A. ViewModel状态流测试 B. UseCase业务逻辑测试 C. AndroidView互操作的触摸事件处理测试 D. Repository数据转换测试
答案:C
解析:commonTest 适合业务逻辑测试。AndroidView互操作的触摸事件处理涉及平台特定行为,应放在 androidInstrumentedTest 中测试。
第4题 平台特定测试应聚焦于以下哪类内容?( )
A. 所有业务逻辑 B. 无法在commonTest中验证的平台特定行为 C. UI布局的像素级验证 D. 网络请求的响应解析
答案:B
解析:平台特定测试应聚焦于expect/actual声明的实际平台实现、原生互操作的触摸事件处理、平台SDK集成、文件系统和网络引擎的实际行为等无法在commonTest中验证的内容。
第二组:v2 ComposeUiTest API(4题)
第5题 CMP 1.11.0中,v2 ComposeUiTest API的默认调度器是( )
A. UnconfinedTestDispatcher
B. StandardTestDispatcher
C. Dispatchers.Main
D. Dispatchers.Default
答案:B
解析:CMP 1.11.0中,v2 ComposeUiTest API的默认调度器从 UnconfinedTestDispatcher 改为 StandardTestDispatcher,协程按队列顺序执行,使测试更可预测。
第6题 CMP 1.11.0中,以下哪个API已被弃用?( )
A. runComposeUiTest
B. onNodeWithText
C. assertIsDisplayed
D. performClick
答案:A
解析:CMP 1.11.0中,runComposeUiTest、runSkikoComposeUiTest、runDesktopComposeUiTest 已被弃用,推荐使用v2对应版本。
第7题 v2 ComposeUiTest API新增的 effectContext 参数的作用是( )
A. 设置测试超时时间 B. 向组合传递自定义协程上下文 C. 指定测试运行的平台 D. 配置测试日志级别
答案:B
解析:v2 API接受 effectContext 参数,用于向组合传递自定义协程上下文,可用于覆盖动画时长缩放比例或提供自定义测试调度器。
第8题 关于 runComposeUiTest {} 和 ComposeTestRule 的使用,以下说法正确的是( )
A. 两者可以自由混用
B. 两者不能在同一测试中混用,setContent 只能调用一次
C. ComposeTestRule 在commonTest中优先使用
D. runComposeUiTest 只能在Android上使用
答案:B
解析:runComposeUiTest {} 和 ComposeTestRule 不能在同一测试中混用,setContent 只能调用一次。不要在 runComposeUiTest 函数外部持有 ComposeUiTest 的引用。
第三组:单元测试与依赖替换(4题)
第9题 KMP社区推荐使用哪种测试替身替代Mock框架?( )
A. 反射Mock B. 手写Fake实现 C. 动态代理 D. 字节码增强
答案:B
解析:KMP社区推荐使用手写Fake实现替代Mock框架。Fake不依赖反射,在KMP所有目标上均可运行,行为更接近真实实现。RevenueCat在CMP订阅测试实践中也明确推荐Fake而非Mock。
第10题 ViewModel测试中,Dispatchers.setMain() 的作用是( )
A. 设置测试超时 B. 覆盖Main调度器,使viewModelScope在测试Dispatcher上运行 C. 启动测试服务器 D. 配置测试并行执行
答案:B
解析:通过 Dispatchers.setMain() 覆盖Main调度器,使 viewModelScope 在测试Dispatcher上运行。配合 advanceUntilIdle() 推进虚拟时间,可以同步测试协程逻辑。
第11题 Koin在Compose UI测试(runComposeUiTest {})中的已知限制是( )
A. Koin完全支持Compose UI测试 B. Koin假设Android UI测试在AndroidJUnitRunner下运行,无法在runComposeUiTest中安全初始化 C. Koin只能在iOS上使用 D. Koin不需要测试
答案:B
解析:Koin当前假设Android UI测试始终在AndroidJUnitRunner下运行,并使用自定义Application来启动Koin,这与CMP UI测试的工作方式不兼容。Koin无法安全地在 runComposeUiTest {} 内部初始化。
第12题 在Compose UI测试中替代Koin的推荐方案是( )
A. 使用生产环境的Koin图 B. 手动依赖注入,直接构造ViewModel并传入Fake Repository C. 不使用ViewModel D. 使用反射注入
答案:B
解析:当前推荐的解决方案是在Compose UI测试中使用手动依赖注入替代Koin容器——直接构造ViewModel并传入Fake Repository,而非通过Koin解析。
第四组:截图测试与CI/CD(3题)
第13题 在CMP的Compose UI测试中,推荐使用什么方式定位节点?( )
A. 硬编码的本地化文本 B. 使用contentDescription和testTag C. 使用节点在树中的索引位置 D. 使用反射获取节点
答案:B
解析:优先使用 contentDescription 和 testTag 而非文本——本地化字符串会破坏基于文本的匹配器。在CMP中,Res.string.xxx 生成的文本随locale变化,硬编码的文本断言在不同语言环境下会失败。
第14题 CMP目前推荐的Android平台截图测试方案是( )
A. Xcode UI Tests B. Paparazzi C. Selenium D. Appium
答案:B
解析:Android平台(CI首选)推荐使用Paparazzi——无需设备即可渲染Compose,基于标准Jetpack Compose,与CMP兼容。Desktop/JVM使用Roborazzi,iOS使用Xcode UI Tests。
第15题 ComposablePreviewScanner的核心价值是( )
A. 替代所有测试框架 B. 自动从Composable Preview生成截图测试,支持多种截图测试库 C. 仅支持Android平台 D. 自动修复UI bug
答案:B
解析:ComposablePreviewScanner是一个Compose Multiplatform友好的库,帮助从Composable Preview自动生成截图测试,可与任何截图测试库配合使用(JVM-based如Paparazzi、Roborazzi,或Instrumentation-based如Shot、Dropshots)。Roborazzi已从1.22.0起将其作为核心依赖集成。
本课知识点总结
1. 分层测试策略
CMP测试策略的核心是核心逻辑共享测试,平台差异分别测试。分层测试金字塔:底层是 commonTest 中的单元测试(ViewModel、UseCase、Repository,一次编写所有平台共享);中层是 commonTest 中的Compose UI测试和平台特定的截图回归测试;顶层是平台特定测试(androidInstrumentedTest / iosTest)。CMP的公共UI测试API不依赖JUnit的 TestRule 类,而是调用 runComposeUiTest 函数。
2. v2 ComposeUiTest API(CMP 1.11.0)
CMP 1.11.0引入了v2 ComposeUiTest API:默认调度器从 UnconfinedTestDispatcher 改为 StandardTestDispatcher(协程按队列顺序执行,需显式推进虚拟时钟);新增 effectContext、runTestContext 参数;旧API(runComposeUiTest、runSkikoComposeUiTest、runDesktopComposeUiTest)已弃用。runComposeUiTest {} 和 ComposeTestRule 不能混用,setContent 只能调用一次。
3. 单元测试与依赖替换
ViewModel测试通过 Dispatchers.setMain(StandardTestDispatcher()) 覆盖Main调度器,使用 advanceUntilIdle() 推进虚拟时间。KMP社区推荐使用手写Fake实现替代Mock框架。koin-test 是multiplatform的,可在 commonTest 中使用。
4. Compose UI测试与Koin的已知限制
语义树断言优先使用 contentDescription 和 testTag 而非本地化文本。Koin在Compose UI测试中存在已知限制:Koin假设Android UI测试在AndroidJUnitRunner下运行,无法在 runComposeUiTest {} 中安全初始化,KoinTest 在CMP UI测试中不工作。当前推荐方案是在UI测试中使用手动依赖注入替代Koin容器。
5. 截图回归测试
CMP没有一等公民的共享截图测试API。Android(CI首选)使用Paparazzi(无需设备),Desktop/JVM使用Roborazzi(配合ComposablePreviewScanner自动发现 @Preview 并快照),iOS使用Xcode UI Tests。Roborazzi已从1.22.0(Android)和1.70.0(Desktop)起将ComposablePreviewScanner作为核心依赖集成,开发者只需添加 @Preview 注解,无需编写测试类即可自动纳入截图测试。
6. CI/CD与质量门禁
每个PR的质量门禁包括:Spotless + ktlint格式化检查(需关闭与Compose冲突的规则)、单元测试(jvmTest + testAndroidHostTest)、Compose UI测试、截图回归测试验证(verifyRoborazziDebug)、Android Debug构建。JetBrains官方推荐使用复合Action统一Java和Gradle设置,Gradle配置禁用daemon并启用并行执行和缓存。多平台CI矩阵覆盖 test-shared(ubuntu)、test-ios(macos)、build-android、build-ios。截图测试需使用固定的Docker镜像保证golden文件一致性。Appium对CMP有较广的平台覆盖但设置复杂且执行较慢,testTag 会映射到原生 accessibilityIdentifier 使Compose语义数据可被XCTest框架使用。
下一课预告:第19课将进入部署与综合实践模块,深入多平台部署与发布,包括Android的APK/AAB构建与Google Play发布、iOS的Xcode归档与TestFlight/App Store发布、Desktop的jDeploy打包为原生安装包、Web(Wasm)的wasmJsBrowserDistribution任务与静态托管部署、CI/CD流水线设计,以及版本管理与自动化发布策略。