【Compose Multiplatform跨端声明式UI实用技术】第18课:测试策略与质量保障

65 阅读18分钟

第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。

目录

文末附有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[&#34;平台特定测试<br/>androidInstrumentedTest / iosTest&#34;]
    end
    subgraph Middle[&#34;中层&#34;]
        B[&#34;Compose UI测试<br/>commonTest&#34;]
        C[&#34;截图回归测试<br/>平台特定源集&#34;]
    end
    subgraph Bottom[&#34;底层(最多)&#34;]
        D[&#34;单元测试<br/>commonTest&#34;]
    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 APIv2 API
默认调度器UnconfinedTestDispatcherStandardTestDispatcher
协程行为立即执行按队列顺序执行,需显式推进虚拟时钟
新增参数无effectContext、runTestContext、testTimeout
旧API状态可用已弃用(runComposeUiTest、runSkikoComposeUiTest、runDesktopComposeUiTest)

v2 API默认使用 StandardTestDispatcher 运行组合,协程启动后会被加入队列,直到测试显式推进虚拟时钟才会执行。这与生产环境的行为更接近,使测试更可预测。

effectContext 参数:v2 API接受 effectContext 参数,用于向组合传递自定义协程上下文,可用于覆盖动画时长缩放比例或提供自定义测试调度器。runTestContext 参数用于控制 runTest 的行为。

下面是 v1 到 v2 API 的核心变化流程:

flowchart LR
    subgraph V1[&#34;v1 API&#34;]
        A1[&#34;UnconfinedTestDispatcher<br/>协程立即执行&#34;]
    end
    subgraph V2[&#34;v2 API&#34;]
        B1[&#34;StandardTestDispatcher<br/>协程按队列顺序执行&#34;]
        B2[&#34;新增 effectContext / runTestContext / testTimeout&#34;]
        B3[&#34;旧API已弃用&#34;]
    end

    A1 -->|&#34;升级&#34;| 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 / JVMRoborazzi生成PNG文件进行对比,支持CMP
iOSXcode 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[&#34;添加 @Preview 注解&#34;] --> B[&#34;ComposablePreviewScanner 扫描&#34;]
    B --> C[&#34;自动生成截图测试&#34;]
    C --> D[&#34;recordRoborazziDebug<br/>刷新 golden 文件&#34;]
    D --> E[&#34;verifyRoborazziDebug<br/>CI 中验证截图匹配&#34;]

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[&#34;PR 触发&#34;] --> B[&#34;Spotless + ktlint 格式化检查&#34;]
    B --> C[&#34;单元测试<br/>jvmTest + testAndroidHostTest&#34;]
    C --> D[&#34;Compose UI 测试<br/>jvmTest&#34;]
    D --> E[&#34;截图回归测试<br/>verifyRoborazziDebug&#34;]
    E --> F[&#34;Android Debug 构建<br/>assembleDebug&#34;]
    F --> G[&#34;质量门禁通过&#34;]

6.3 多平台CI矩阵

JobRunner执行内容
test-sharedubuntu-latestcommonTest + jvmTest(单元测试 + Compose UI测试)
test-androidubuntu-latestandroidHostTest(Roborazzi截图测试)
test-iosmacos-latestiosSimulatorArm64Test + Xcode UI Tests
build-androidubuntu-latestandroidApp:assembleDebug
build-iosmacos-latestXcode 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流水线设计,以及版本管理与自动化发布策略。