第4章 Espresso测试环境搭建：AndroidJUnit4、ComposeTestRule、ActivityScenario配置

4.1 原理：测试驱动层与Compose刷新触发闭环

Espresso测试框架运行在Android Instrumentation层，通过ActivityScenario管理Activity生命周期，通过ComposeTestRule操控Compose组件树。在后台任务（如WorkManager定时同步）完成后，Compose状态（State）自动触发重组（Recomposition），Espresso借助ComposeTestRule的等待机制（如waitForIdle）同步观测UI刷新，形成“任务调度 → 状态变更 → 重组渲染 → 断言”的测试闭环。

4.2 实现流程

1. 添加Gradle依赖：在build.gradle（模块级）引入Espresso、Compose测试、ActivityScenario相关库。
2. 配置测试运行器：在AndroidManifest.xml或默认build.gradle中设置testInstrumentationRunner。
3. 创建测试类：使用@RunWith(AndroidJUnit4.class)标记。
4. 初始化测试规则：声明@Rule的ComposeTestRule与ActivityScenario组合。
5. 编写测试方法：触发后台任务 → 等待Compose刷新 → 执行UI断言。

4.3 配置详解与API列表

4.4 完整配置示例

// build.gradle (模块级)
android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    testOptions {
        execution 'ANDROIDX_TEST_ORCHESTRATOR'
    }
}

dependencies {
    implementation 'androidx.compose.ui:ui:1.6.0'
    implementation 'androidx.work:work-runtime:2.9.0'

    // 测试依赖
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4:1.6.0'
    androidTestImplementation 'androidx.work:work-testing:2.9.0'
    androidTestImplementation 'androidx.test:core:1.5.0'
    androidTestImplementation 'androidx.test:runner:1.5.2'
    androidTestUtil 'androidx.test:orchestrator:1.4.2'
}

4.5 测试类骨架代码

import android.Manifest
import androidx.compose.ui.test.junit4.createAndroidComposeRule
import androidx.test.ext.junit.runners.AndroidJUnit4
import androidx.test.rule.GrantPermissionRule
import androidx.work.testing.WorkManagerTestInitHelper
import org.junit.Rule
import org.junit.Test
import org.junit.runner.RunWith

@RunWith(AndroidJUnit4::class)
class RefreshTriggerEspressoTest {

    @get:Rule
    val composeTestRule = createAndroidComposeRule<MainActivity>()

    @get:Rule
    val permissionRule: GrantPermissionRule =
        GrantPermissionRule.grant(Manifest.permission.POST_NOTIFICATIONS)

    @Before
    fun initWorkManager() {
        WorkManagerTestInitHelper.initializeTestWorkManager(
            composeTestRule.activity.applicationContext
        )
    }

    @Test
    fun whenBackgroundTaskCompletes_composeShouldShowUpdatedState() {
        // 触发后台任务（例如通过 TestListenableWorkerBuilder）
        // 等待 composition 刷新
        composeTestRule.waitForIdle()
        composeTestRule.onNodeWithText("数据已同步").assertIsDisplayed()
    }
}

4.6 调试与常见错误

4.7 性能与稳定性优化

• 最小化待空闲时间：用 composeTestRule.waitUntil(timeoutMillis = 5000) { condition } 替代全局 waitForIdle，避免无谓等待后台任务默认 60s 超时。
• 分离测试与生产代码：使用 TestListenableWorkerBuilder 直接返回 ListenableWorker.Result.success()，跳过真实网络/磁盘 I/O，将单测执行时间压至 3s 内。
• 避免重复创建 Activity：使用 ActivityScenarioRule 配合 @get:Rule，确保测试间 Activity 复用。
• Compose 帧控制：在基准测试场景下关闭 animate*AsState 动画，用 composeTestRule.mainClock.advanceTimeByFrame() 精确前移。

4.8 平台版本适配注意事项

4.9 本章小结

通过第4章的学习，你已掌握：

• AndroidJUnit4 与 ComposeTestRule 的联合配置方法；
• ActivityScenario 在测试中管理 Activity 生命周期的正确时机；
• 完整的 Gradle 依赖声明与常见错误对策；
• 如何借助 SVG 流程图理解整个测试触发链路的依赖关系。