CameraX在direct boot模式下调用报错的问题及解决咨询

问题根源 #

Direct Boot模式下，应用运行在受保护的沙箱环境中，仅能访问设备保护存储和有限系统服务。如果CameraX的camera-camera2实现依赖被配置为按需加载（比如放在动态特性模块、使用compileOnly而非implementation），或是依赖未被正确打包进主APK，会导致CameraX找不到默认实现，触发初始化错误。

解决方案 #

1. 修正CameraX依赖配置 #

检查Module级别的build.gradle文件，确保camera-camera2等核心依赖用implementation引入，而非compileOnly或拆分到动态模块：

dependencies {
    // CameraX核心库
    implementation "androidx.camera:camera-core:1.3.0"
    // Camera2实现（必须包含，禁止按需加载）
    implementation "androidx.camera:camera-camera2:1.3.0"
    // Lifecycle绑定库（ProcessCameraProvider依赖）
    implementation "androidx.camera:camera-lifecycle:1.3.0"
}

注意：替换1.3.0为你实际使用的CameraX版本，确保所有CameraX库版本一致。

2. 禁止将CameraX依赖拆分到动态特性模块 #

如果项目使用了应用动态拆分（Dynamic Feature Module），绝对不能把camera-camera2或核心CameraX依赖放在动态模块里。Direct Boot模式下系统无法加载未安装的动态模块，会直接导致CameraX找不到实现类，必须将这些依赖放在主APK的依赖配置中。

3. 调整Direct Boot下的初始化逻辑 #

在Direct Boot模式下，避免启动初期就初始化CameraX。可以先判断当前模式，延迟初始化直到设备解锁：

// 判断是否处于Direct Boot模式
val isDirectBootMode = context.devicePolicyManager.isDeviceProtectedStorage(context)

if (!isDirectBootMode) {
    // 设备已解锁，正常初始化CameraX
    val cameraProviderFuture = ProcessCameraProvider.getInstance(context)
    // 后续相机绑定、预览等逻辑...
} else {
    // 注册广播监听设备解锁事件
    val unlockReceiver = object : BroadcastReceiver() {
        override fun onReceive(ctx: Context?, intent: Intent?) {
            if (intent?.action == Intent.ACTION_USER_UNLOCKED) {
                // 设备解锁后初始化CameraX
                val cameraProviderFuture = ProcessCameraProvider.getInstance(ctx!!)
                // 后续相机逻辑...
                ctx.unregisterReceiver(this)
            }
        }
    }
    context.registerReceiver(unlockReceiver, IntentFilter(Intent.ACTION_USER_UNLOCKED))
}

4. 验证依赖打包结果 #

通过Android Studio的Build > Analyze APK功能，检查主APK中是否包含androidx.camera.camera2包下的类。如果找不到相关类，说明依赖未被正确打包，需重新检查依赖配置。

额外提示 #

Direct Boot模式下系统对硬件访问有严格限制，即使修复了初始化问题，部分设备仍不允许未解锁时访问相机硬件。因此，建议优先引导用户解锁设备后使用相机功能。

内容的提问来源于stack exchange，提问作者sweak