CameraX与MLKit条码扫描教程

本文手把手教你如何在纯 Java 的 Android 项目中，利用 CameraX 和 ML Kit 构建高性能、稳定可靠的条码扫描功能——不仅覆盖 QR 码、EAN、Code128 等主流格式，更关键的是直击开发者痛点，彻底解决因 Kotlin 标准库版本混乱导致的 `Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt` 编译错误，并提供经过验证的 Gradle 依赖配置、零 Kotlin 语法的完整 Java 示例代码、生命周期安全绑定技巧以及内存泄漏规避要点，助你绕过坑洼、一步到位实现现代化扫码体验。

本文详解如何在 Android Java 项目中基于 CameraX 和 ML Kit 实现高性能条码扫描，并彻底解决因 Kotlin 标准库版本冲突导致的 Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt 编译错误。

本文详解如何在 Android Java 项目中基于 CameraX 和 ML Kit 实现高性能条码扫描，并彻底解决因 Kotlin 标准库版本冲突导致的 `Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt` 编译错误。

在 Android 开发中，使用 CameraX 搭配 Google ML Kit 进行条码（含 QR 码、EAN、Code128 等）扫描是当前推荐的现代化方案——它比传统 ZXing 的 SurfaceView + PreviewCallback 方式更稳定、更轻量，且天然支持生命周期感知与多设备适配。然而，许多 Java 开发者在集成过程中会遇到编译期冲突，典型如：

Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt 
found in modules jetified-kotlin-stdlib-1.8.0 and jetified-kotlin-stdlib-jdk8-1.6.0

该错误本质是 Kotlin 标准库版本不一致引发的重复类加载：kotlin-stdlib-jdk8 是 kotlin-stdlib 的子模块（自 Kotlin 1.7+ 起已废弃并合并入主库），而某些旧版依赖（如早期 ML Kit 或第三方库）仍显式引入了 kotlin-stdlib-jdk8，与新版本 kotlin-stdlib（如 1.8.0）发生类路径重叠。

✅ 根本解决方案（Gradle 配置）：
在 app/build.gradle 中强制统一 Kotlin 标准库版本，并排除冗余传递依赖：

android {
    compileSdk 34

    // 确保 Kotlin 插件版本与 stdlib 匹配（建议 1.8.0+）
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    // CameraX 核心（Java 友好，无需 Kotlin DSL）
    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:1.3.0" // 替代 PreviewView 的现代化组件

    // ML Kit 条码扫描（官方 Java 支持完备）
    implementation 'com.google.mlkit:barcode-scanning:18.4.0'

    // 关键：排除过时的 kotlin-stdlib-jdk8 传递依赖
    implementation('com.google.mlkit:barcode-scanning:18.4.0') {
        exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
    }
    implementation('androidx.camera:camera-view:1.3.0') {
        exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
    }

    // 显式声明统一的 Kotlin 标准库（可选但强烈推荐）
    implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.8.0'
}

同时，在项目根目录 build.gradle（或 settings.gradle）中确认 Kotlin 插件版本：

plugins {
    id 'org.jetbrains.kotlin.android' version '1.8.0' apply false
}

? Java 代码集成要点（CameraX + ML Kit）：
以下为关键流程精简示例（无 Kotlin 语法，纯 Java）：

// 1. 初始化 BarcodeScanner（一次创建，复用）
BarcodeScanner scanner = BarcodeScanning.getClient(
    new BarcodeScannerOptions.Builder()
        .setBarcodeFormats(Barcode.FORMAT_QR_CODE, Barcode.FORMAT_EAN_13)
        .build()
);

// 2. 绑定 LifecycleOwner（如 Activity/Fragment）
Preview preview = new Preview.Builder().build();
ImageAnalysis analysis = new ImageAnalysis.Builder()
    .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
    .build();

analysis.setAnalyzer(ContextCompat.getMainExecutor(this), image -> {
    InputImage inputImage = InputImage.fromMediaImage(
        image.getImage(), image.getImageInfo().getRotationDegrees()
    );
    scanner.process(inputImage)
        .addOnSuccessListener(barcodes -> {
            for (Barcode barcode : barcodes) {
                String rawValue = barcode.getRawValue();
                Log.d("Barcode", "Detected: " + rawValue);
                // ✅ 在主线程更新 UI（如 TextView.setText(rawValue)）
            }
        })
        .addOnFailureListener(e -> Log.e("Barcode", "Scan failed", e))
        .addOnCompleteListener(() -> image.close()); // 必须释放图像
});

// 3. 绑定到 PreviewView（XML 中定义 android:id="@+id/viewFinder"）
PreviewView viewFinder = findViewById(R.id.viewFinder);
preview.setSurfaceProvider(viewFinder.getSurfaceProvider());
analysis.setSurfaceProvider(viewFinder.getSurfaceProvider());

// 4. 启动相机（需在 LifecycleScope 内，如 onCreate 后）
ListenableFuture<ProcessCameraProvider> cameraProviderFuture =
    ProcessCameraProvider.getInstance(this);
cameraProviderFuture.addListener(() -> {
    try {
        ProcessCameraProvider cameraProvider = cameraProviderFuture.get();
        cameraProvider.unbindAll();
        cameraProvider.bindToLifecycle(this, CameraSelector.DEFAULT_BACK_CAMERA,
            preview, analysis);
    } catch (ExecutionException | InterruptedException e) {
        Log.e("CameraX", "Use case binding failed", e);
    }
}, ContextCompat.getMainExecutor(this));

? 重要注意事项：

• 权限声明：确保 AndroidManifest.xml 中添加 ，并在运行时动态申请；
• 线程安全：ImageAnalysis.Analyzer 回调在后台线程执行，所有 UI 操作必须切回主线程（如 runOnUiThread() 或 Handler(Looper.getMainLooper())）；
• 资源释放：务必调用 image.close()，否则会导致内存泄漏与预览卡顿；
• Java 文档参考：官方 CameraX Java API 文档位于 developer.android.com/reference/androidx/camera；实战向 Java 教程推荐 LearnToDroid 的 QR 扫描教程（全程 Java，含完整源码）；
• 替代方案提示：若坚持使用 ZXing，建议改用 com.journeyapps:zxing-android-embedded:4.3.0（已适配 AndroidX），但其性能与兼容性仍弱于 ML Kit + CameraX 组合。

综上，通过精准的依赖管理 + 规范的 Java API 调用，你完全可以构建一个零 Kotlin 侵入、高稳定性、全功能的条码扫描应用。核心在于：统一 Kotlin 版本、排除冗余模块、遵循 CameraX 生命周期绑定规范、善用 ML Kit 的异步处理模型。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《CameraX与MLKit条码扫描教程》文章吧，也可关注golang学习网公众号了解相关技术文章。