**ZXing Android Embedded安装与配置完全指南**

ZXing Android Embedded安装与配置完全指南

zxing-android-embedded Barcode scanner library for Android, based on the ZXing decoder 项目地址: https://gitcode.com/gh_mirrors/zx/zxing-android-embedded

项目基础介绍

ZXing Android Embedded是一个专为Android平台打造的条形码扫描库，它基于著名的ZXing（“Zebra Crossing”）项目来实现条码解码。这个库允许开发者轻松地将条形码和二维码扫描功能融入其Android应用之中，无需深入了解ZXing的复杂细节。项目采用Java作为主要编程语言，并充分利用Android的特性进行了优化。

关键技术与框架

• 核心解码引擎: 利用ZXing提供的解码技术，高效解析各种类型的条形码和二维码。
• 多线程: 相机管理和扫描过程在后台线程运行，确保了用户界面的流畅性。
• UI自定义: 支持高度的用户界面自定义，便于集成至不同风格的应用中。
• Intents机制: 支持通过Intent轻松调用扫描功能，减少代码量。
• 兼容性: 支持Android SDK 19及以上版本，通过不同配置可以适配更早期的SDK版本。

安装与配置步骤

准备工作

1. 确保环境：你需要一个安装有Android Studio的开发环境，以及有效的Java Development Kit (JDK)。
2. Git克隆：打开终端或命令提示符，使用下面的命令克隆项目：

   git clone https://github.com/journeyapps/zxing-android-embedded.git
   

详细安装与配置

1. 添加依赖

在你的Android项目的build.gradle(通常是app模块下的)文件里，添加以下依赖项：

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.journeyapps:zxing-android-embedded:4.3.0'
}

如果你的应用支持低于Android 24（API级别24）的版本，还需按照文档进行额外配置。

2. 针对旧版SDK配置

对于SDK版本19至23之间的应用，你需要降级zxing:core的版本或启用Java 8的desugaring特性。以下是示例代码：

降级zxing:core版本:

dependencies {
    implementation('com.journeyapps:zxing-android-embedded:4.3.0') {
        transitive = false
    }
    implementation 'com.google.zxing:core:3.3.0'
}

或使用Desugaring:

android {
    defaultConfig {
        // ...其他配置
        coreLibraryDesugaringEnabled true
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }

    dependencies {
        coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.5'
    }
}

3. 实现扫描功能

• 在Activity或Fragment中，使用IntentIntegrator来初始化扫描：

  IntentIntegrator integrator = new IntentIntegrator(this);
  integrator.setDesiredBarcodeFormats(IntentIntegrator.ONE_D_CODE_TYPES); // 设置要扫描的条码类型
  integrator.setPrompt("请扫描"); // 提示信息
  integrator.initiateScan();
  

• 处理扫描结果，在onActivityResult方法中：

  @Override
  protected void onActivityResult(int requestCode, int resultCode, Intent data) {
      super.onActivityResult(requestCode, resultCode, data);
      IntentResult result = IntentIntegrator.parseActivityResult(requestCode, resultCode, data);
      if (result != null) {
          if (result.getContents() == null) {
              Toast.makeText(this, "取消", Toast.LENGTH_LONG).show();
          } else {
              Toast.makeText(this, "扫描结果：" + result.getContents(), Toast.LENGTH_LONG).show();
          }
      } else {
          super.onActivityResult(requestCode, resultCode, data);
      }
  }
  

注意事项

• 确保在AndroidManifest.xml中已经开启了硬件加速(android:hardwareAccelerated="true")，因为项目使用了TextureView。
• 对于Android 6.0及以上版本，如果直接使用BarcodeView而不通过IntentIntegrator，需手动请求相机权限。

至此，您已成功将ZXing Android Embedded添加到您的Android项目中，可以根据需要调整配置，享受便捷的条形码扫描功能。

zxing-android-embedded Barcode scanner library for Android, based on the ZXing decoder 项目地址: https://gitcode.com/gh_mirrors/zx/zxing-android-embedded