Dagger Hilt 在 Android 14 上运行 UI 测试时的 SecurityException 问题解析

问题背景

在使用 Dagger Hilt 和 Jetpack Compose 进行 Android UI 测试时，开发者遇到了一个特定于 Android 14 的安全异常问题。这个错误表现为 SecurityException，并提示需要在注册广播接收器时明确指定 RECEIVER_EXPORTED 或 RECEIVER_NOT_EXPORTED 标志。

错误分析

该问题的根本原因在于 Android 14 对广播接收器的注册引入了更严格的安全要求。从 Android 14 开始，所有动态注册的广播接收器都必须明确声明其导出性（exported 属性），以增强应用的安全性。

错误堆栈显示，问题发生在测试框架尝试启动 Activity 时。具体来说，是 androidx.test.core.app.InstrumentationActivityInvoker 在注册 Activity 结果接收器时没有指定必要的标志。

深层原因

经过深入分析，我们发现这个问题实际上是由测试依赖的版本冲突引起的：

1. Dagger Hilt 测试库（hilt-android-testing）2.50 版本依赖的是较旧的 androidx.test:core:1.4.0
2. 而开发者项目中使用的是较新的测试库版本（如 1.5.0）
3. 旧版本的测试库没有适配 Android 14 的新安全要求

解决方案

要解决这个问题，我们需要确保测试环境中使用兼容 Android 14 的测试库版本。以下是具体的解决步骤：

1. 统一测试库版本

首先，需要将所有测试相关的依赖升级到最新兼容版本：

def androidXTestVersion = "1.5.0" // 或更高版本

androidTestImplementation "androidx.test:core:$androidXTestVersion"
androidTestImplementation "androidx.test:core-ktx:$androidXTestVersion"
androidTestImplementation "androidx.test.ext:junit:1.1.5"
androidTestImplementation "androidx.test.ext:truth:1.5.0"

2. 处理 Hilt 测试库的依赖冲突

由于 Hilt 测试库强制依赖旧版本，我们需要显式排除这个依赖：

androidTestImplementation("com.google.dagger:hilt-android-testing:2.50") {
    exclude group: 'androidx.test', module: 'core'
}

3. 确保所有配置使用统一版本

为了避免不同构建配置间的版本冲突，需要在所有相关配置中强制使用相同版本：

debugImplementation("androidx.test:core") {
    version { strictly androidXTestVersion }
}

testImplementation("androidx.test:core") {
    version { strictly androidXTestVersion }
}

androidTestImplementation("androidx.test:core") {
    version { strictly androidXTestVersion }
}

4. 处理其他可能的冲突

对于其他可能引起冲突的测试依赖，如 Espresso 和 Compose 测试库，也需要进行类似处理：

androidTestImplementation("androidx.compose.ui:ui-test-junit4") {
    exclude group: 'androidx.test', module: 'core'
}

最佳实践建议

1. 定期更新测试依赖：保持测试库与目标 Android 版本的兼容性
2. 统一依赖版本：确保所有构建配置使用相同的测试库版本
3. 使用依赖约束：在项目级 build.gradle 中定义版本约束，避免意外引入不兼容版本
4. 检查测试框架兼容性：特别是当目标 Android 版本更新时

总结

Android 14 引入的安全改进可能导致现有测试框架出现兼容性问题。通过统一测试依赖版本、正确处理依赖冲突，可以确保 Dagger Hilt 和 Jetpack Compose 的 UI 测试在 Android 14 上正常运行。这个问题也提醒我们，在升级目标 SDK 版本时需要同步考虑测试环境的兼容性。