CameraX集成旧项目调用bindToLifecycle报AbstractMethodError

问题根因 #

该崩溃由CameraX组件版本不匹配直接导致：旧项目存在不同版本的CameraX系列库混用，要么手动引入的camera-core、camera-camera2、camera-lifecycle等组件版本号不一致，要么第三方依赖传递引入了异版CameraX组件，导致接口方法签名不匹配，运行时调用UseCaseConfigFactory.getConfig方法时找不到对应实现，抛出抽象方法错误。同代码在新项目可正常运行，就是因为新项目的CameraX依赖全部由官方模板拉取，版本天然对齐。

修复步骤 #

• 统一手动引入的CameraX依赖版本
  打开app模块的build.gradle文件，所有CameraX相关依赖必须使用完全一致的版本号，禁止混写版本，参考配置如下：

  // 单独定义版本变量，从根源避免版本写错
  def camerax_version = "1.3.0" // 可替换为官方发布的其他稳定版，所有组件必须复用该值
  implementation "androidx.camera:camera-core:${camerax_version}"
  implementation "androidx.camera:camera-camera2:${camerax_version}"
  implementation "androidx.camera:camera-lifecycle:${camerax_version}"
  implementation "androidx.camera:camera-view:${camerax_version}" // 使用PreviewView作为预览载体时必须引入
  

• 排查传递依赖冲突
  如果已经统一手动引入的版本仍报错，说明存在第三方库间接引入了异版CameraX。在项目根目录执行以下命令查看完整依赖树：

  # macOS/Linux 系统
  ./gradlew app:dependencies
  # Windows 系统
  gradlew.bat app:dependencies
  

  在输出结果中检索所有androidx.camera开头的依赖，找到和你配置的版本号不一致的条目，通过exclude规则排除冲突的传递依赖，示例：

  implementation('引入了异版CameraX的第三方依赖坐标') {
      exclude group: 'androidx.camera', module: 'camera-core'
      // 其余冲突的camera组件按相同方式排除
  }
  

• 配置全局版本强制兜底
  不想逐个排查排除的话，可以直接在app模块build.gradle中添加全局强制版本规则，确保所有CameraX组件版本统一，配置位置和android{}块同级：

  configurations.all {
      resolutionStrategy {
          force "androidx.camera:camera-core:${camerax_version}"
          force "androidx.camera:camera-camera2:${camerax_version}"
          force "androidx.camera:camera-lifecycle:${camerax_version}"
          force "androidx.camera:camera-view:${camerax_version}"
      }
  }
  

• 清理缓存重新编译
  配置修改完成后，依次执行以下操作：
  • 点击Android Studio菜单栏 File -> Invalidate Caches...，勾选清除缓存选项后重启IDE
  • 点击 Build -> Clean Project 清理构建产物
  • 点击 Build -> Rebuild Project 重新构建项目，之后安装到设备测试即可

附核心报错信息对应关系：日志中提示的缺失方法androidx.camera.core.impl.UseCaseConfigFactory.getConfig(androidx.camera.core.impl.UseCaseConfigFactory$CaptureType, int)是高版本camera-core新增的双参数抽象方法，如果配套的camera-lifecycle、camera-camera2组件版本过低，就会因为没有实现该方法触发崩溃。

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