ZXing Android Embedded 常见问题解决方案

项目基础介绍

ZXing Android Embedded 是一个基于 ZXing 解码器的 Android 条形码扫描库。该项目松散地基于 ZXing Android 条形码扫描仪应用程序，但不隶属于官方 ZXing 项目。主要编程语言为 Java 和 Kotlin。

新手使用注意事项及解决方案

1. 依赖添加问题

问题描述：新手在集成项目时，可能会遇到依赖添加失败的问题。

解决步骤：

1. 检查 Gradle 文件：确保在 build.gradle 文件中正确添加了依赖。

   repositories {
       mavenCentral()
   }
   
   dependencies {
       implementation 'com.journeyapps:zxing-android-embedded:4.3.0'
   }
   

2. 同步项目：在添加依赖后，点击 Android Studio 中的“Sync Now”按钮，确保依赖正确下载并同步到项目中。

2. SDK 版本兼容性问题

问题描述：默认情况下，ZXing Android Embedded 需要 Android SDK 24+，但有些项目可能需要支持更低版本的 SDK。

解决步骤：

1. 降级 zxing:core 版本：如果需要支持 SDK 19+，可以降级 zxing:core 版本。

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

2. 启用 Desugaring：如果不想降级 zxing:core 版本，可以使用 Desugaring 技术。

   android {
       defaultConfig {
           minSdkVersion 19
       }
       compileOptions {
           coreLibraryDesugaringEnabled true
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
   

3. 扫描界面自定义问题

问题描述：新手可能希望自定义扫描界面，但不知道如何进行。

解决步骤：

1. 嵌入 Activity：将扫描功能嵌入到自定义的 Activity 中。

   public class CustomScannerActivity extends AppCompatActivity {
       private CaptureManager capture;
       private DecoratedBarcodeView barcodeScannerView;
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.activity_custom_scanner);
   
           barcodeScannerView = findViewById(R.id.zxing_barcode_scanner);
           capture = new CaptureManager(this, barcodeScannerView);
           capture.initializeFromIntent(getIntent(), savedInstanceState);
           capture.decode();
       }
   
       @Override
       protected void onResume() {
           super.onResume();
           capture.onResume();
       }
   
       @Override
       protected void onPause() {
           super.onPause();
           capture.onPause();
       }
   
       @Override
       protected void onDestroy() {
           super.onDestroy();
           capture.onDestroy();
       }
   
       @Override
       protected void onSaveInstanceState(Bundle outState) {
           super.onSaveInstanceState(outState);
           capture.onSaveInstanceState(outState);
       }
   }
   

2. 自定义布局：在 res/layout 目录下创建自定义的扫描界面布局文件 activity_custom_scanner.xml。

   <com.journeyapps.barcodescanner.DecoratedBarcodeView
       android:id="@+id/zxing_barcode_scanner"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />
   

通过以上步骤，新手可以顺利集成 ZXing Android Embedded 库，并解决常见的问题。