Android Studio为XML Preview设置surfaceProvider提示未解析引用如何解决

错误原因 #

• 调用findViewById时指定的类型是通用View，不是CameraX库提供的PreviewView类型，通用View类没有surfaceProvider属性
• Preview.Builder的使用方式错误，不需要传入View实例作为构造参数
• 未正确引入CameraX核心依赖，或者依赖版本不匹配
• XML中定义的PreviewView id和代码中引用的变量名不匹配

解决步骤 #

1. 确认XML布局中使用的是CameraX的PreviewView组件，示例布局代码：

<androidx.camera.view.PreviewView
    android:id="@+id/viewPreview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2. 修正代码逻辑，调整findViewById的类型和Preview实例构建逻辑，完整示例代码如下：

fun startCamera(){
    val cameraProviderFuture =  ProcessCameraProvider.getInstance(this)

    cameraProviderFuture.addListener(Runnable {
        // 绑定相机生命周期
        val cameraProvider: ProcessCameraProvider = cameraProviderFuture.get()
        // 正确获取PreviewView实例，指定类型为PreviewView而非通用View
        val previewView = findViewById<androidx.camera.view.PreviewView>(R.id.viewPreview)
        // 构建Preview实例，Builder无需传入View参数
        val preview = Preview.Builder()
            .build()
            .also {
                it.setSurfaceProvider(previewView.surfaceProvider)
            }
        // 补充相机选择、生命周期绑定逻辑
        val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
        try {
            cameraProvider.unbindAll()
            cameraProvider.bindToLifecycle(this, cameraSelector, preview)
        } catch(exc: Exception) {
            // 自定义异常处理逻辑
        }
    // 传入主线程执行器
    }, ContextCompat.getMainExecutor(this))
}

3. 确认模块级build.gradle已经引入匹配的CameraX依赖，示例配置如下：

// gradle.kts配置示例，版本可根据项目compileSdk调整
dependencies {
    val cameraxVersion = "1.3.0"
    implementation("androidx.camera:camera-core:$cameraxVersion")
    implementation("androidx.camera:camera-camera2:$cameraxVersion")
    implementation("androidx.camera:camera-lifecycle:$cameraxVersion")
    implementation("androidx.camera:camera-view:$cameraxVersion")
}

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