Android单元测试实战：框架配置与最佳实践

1. Android单元测试实战指南：从入门到精通

在移动应用开发领域，单元测试是保证代码质量的第一道防线。作为一位经历过数十个Android项目的老兵，我深刻体会到单元测试对项目长期维护的价值。很多开发者（包括曾经的我）总是以"项目紧急"为由跳过单元测试，直到某天修改一个小功能引发连锁崩溃时才追悔莫及。

Android单元测试与传统Java单元测试既有共通之处也有特殊差异。我们需要处理Android框架依赖、UI组件测试、异步任务验证等独特场景。本文将系统介绍如何在Android Studio中搭建测试环境、编写高效测试用例、处理常见难题，并分享我在实际项目中积累的实战经验。

2. 环境准备与基础配置

2.1 测试框架选型

现代Android开发主要使用以下测试框架组合：

• JUnit 4/5：基础测试框架
• Mockito：模拟依赖对象
• Espresso：UI交互测试
• Robolectric：Android环境模拟

在app模块的build.gradle中添加依赖：

dependencies { testImplementation 'junit:junit:4.13.2' testImplementation 'org.mockito:mockito-core:4.5.1' testImplementation 'org.robolectric:robolectric:4.8.1' androidTestImplementation 'androidx.test.ext:junit:1.1.3' androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' }

注意：Android Studio 2021+默认使用Android Gradle Plugin 7.0+，需要确保在gradle.properties中添加android.enableUnitTestBinaryResources=true以支持资源测试

2.2 测试目录结构

标准的Android项目包含两个测试源集：

src/ ├── main/ # 主代码 ├── test/ # 本地单元测试(JVM) └── androidTest/ # 仪器化测试(Android设备/模拟器)

• test目录：运行在本地JVM，适合纯逻辑测试
• androidTest目录：需要Android运行时，适合涉及框架API的测试

3. 核心测试模式与实践

3.1 基础单元测试编写

一个典型的ViewModel测试示例：

class LoginViewModelTest { private lateinit var viewModel: LoginViewModel private val mockRepository = mock(LoginRepository::class.java) @Before fun setup() { viewModel = LoginViewModel(mockRepository) } @Test fun `login with valid credentials should return success`() { // 准备模拟数据 whenever(mockRepository.login("user", "pass")) .thenReturn(Success(Unit)) // 执行测试方法 viewModel.login("user", "pass") // 验证结果 assertEquals(LoginState.SUCCESS, viewModel.loginState.value) } }

关键技巧：

1. 使用反引号包裹描述性测试方法名（Kotlin特性）
2. Given-When-Then三段式结构
3. 验证状态变化而非实现细节

3.2 异步代码测试

处理协程的测试方案：

@ExperimentalCoroutinesApi class UserRepositoryTest { private val testDispatcher = StandardTestDispatcher() @Before fun setup() { Dispatchers.setMain(testDispatcher) } @After fun tearDown() { Dispatchers.resetMain() } @Test fun `fetchUser should emit loading then data`() = runTest { val repository = UserRepository() val testObserver = repository.getUser("123").test() // 推进虚拟时间 advanceUntilIdle() testObserver.assertValues( UserState.Loading, UserState.Success(mockUser) ) } }

警告：忘记重置主调度器会导致后续测试失败！务必在@After中清理

4. Android特有场景测试

4.1 资源与上下文测试

使用Robolectric测试资源访问：

@RunWith(RobolectricTestRunner.class) public class StringUtilTest { @Test public void testGetAppName() { Context context = ApplicationProvider.getApplicationContext(); String appName = StringUtil.getAppName(context); assertEquals("MyApp", appName); } }

配置robolectric.properties文件：

application=android.app.Application sdk=28

4.2 数据库与SharedPreferences测试

AndroidX提供专门测试组件：

@RunWith(AndroidJUnit4::class) class UserDaoTest { private lateinit var db: AppDatabase private lateinit var userDao: UserDao @Before fun createDb() { val context = ApplicationProvider.getApplicationContext<Context>() db = Room.inMemoryDatabaseBuilder(context, AppDatabase::class.java) .allowMainThreadQueries() .build() userDao = db.userDao() } @Test fun insertAndGetUser() { val user = User(id = 1, name = "test") userDao.insert(user) val loaded = userDao.getById(1) assertEquals(user.name, loaded?.name) } @After fun closeDb() { db.close() } }

5. 高级测试策略

5.1 参数化测试

使用JUnitParams减少重复代码：

@RunWith(JUnitParamsRunner.class) public class CalculatorTest { @Test @Parameters({ "1, 2, 3", "5, -3, 2" }) public void testAdd(int a, int b, int expected) { assertEquals(expected, Calculator.add(a, b)); } }

5.2 测试覆盖率提升

配置Jacoco生成报告：

android { buildTypes { debug { testCoverageEnabled true } } } task jacocoTestReport(type: JacocoReport, dependsOn: ['testDebugUnitTest']) { reports { xml.required = true html.required = true } def fileFilter = [ '**/R.class', '**/BuildConfig.*' ] def debugTree = fileTree(dir: "${buildDir}/intermediates/javac/debug", excludes: fileFilter) sourceDirectories.setFrom(files(["src/main/java"])) classDirectories.setFrom(files([debugTree])) executionData.setFrom(fileTree(dir: buildDir, includes: [ "jacoco/testDebugUnitTest.exec" ])) }

执行./gradlew jacocoTestReport生成HTML报告

6. 常见问题排查

6.1 "Method not mocked"错误

当测试中调用Android SDK方法时可能出现：

java.lang.RuntimeException: Method getText in android.widget.TextView not mocked.

解决方案：

1. 使用Robolectric提供模拟环境
2. 将测试移到androidTest目录
3. 重构代码将Android相关逻辑抽离

6.2 异步测试超时

处理方案：

@Test fun testNetworkCall() = runBlockingTest { val deferred = async { fetchData() } // 设置虚拟时间前进 advanceTimeBy(5000) assertTrue(deferred.isCompleted) }

6.3 资源找不到问题

确保测试资源放在正确位置：

src/test/resources/ # 本地测试资源 src/androidTest/assets/ # 仪器化测试资源

7. 持续集成集成

在CI中运行测试的推荐配置：

jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up JDK uses: actions/setup-java@v2 with: distribution: 'temurin' java-version: '11' - name: Run unit tests run: ./gradlew testDebugUnitTest - name: Upload coverage uses: codecov/codecov-action@v2 with: files: build/reports/jacoco/jacocoTestReport/jacocoTestReport.xml

关键优化点：

1. 使用Gradle缓存加速构建
2. 并行执行测试任务
3. 失败时保留测试日志

8. 测试策略建议

根据项目阶段采用不同策略：

实际项目中，我通常会：

1. 优先测试业务核心模块
2. 为历史缺陷添加回归测试
3. 使用Mutation Testing检测测试有效性
4. 定期清理过时测试用例

在大型项目中，合理的测试分层（单元测试60%、集成测试30%、UI测试10%）能显著提升反馈速度。记住：测试不是目的，而是保障工程效率的手段。当测试成为负担时，应该重新审视测试策略而非盲目追求覆盖率数字。