Skip to content

Latest commit

 

History

History
266 lines (185 loc) · 13.7 KB

README.md

File metadata and controls

266 lines (185 loc) · 13.7 KB

ZXingLite

Image

Download MavenCentral JCenter JitPack CI CircleCI API License

ZXingLite for Android 是ZXing的精简极速版,基于ZXing库优化扫码和生成二维码/条形码功能,扫码界面完全支持自定义;使用ZXingLite可快速实现扫码识别相关功能。

简单如斯,你不试试?

Gif 展示

Image

你也可以直接下载 演示App 体验效果

引入

Gradle:

  1. 在Project的 build.gradlesetting.gradle 中添加远程仓库

    repositories {
        //...
        mavenCentral()
    }
  2. 在Module的 build.gradle 里面添加引入依赖项

    implementation 'com.github.jenly1314:zxing-lite:3.2.0'
    

温馨提示

关于ZXingLite版本与编译的SDK版本要求

使用 v3.1.x 以上版本时,要求 compileSdkVersion >= 34

使用 v3.0.x 以上版本时,要求 compileSdkVersion >= 33

如果 compileSdkVersion < 33 请使用 v2.x版本

使用

版本变化说明

3.x版本的变化

2.x3.x 主要变化如下:

  • 2.x版本中的 CameraScan 相关核心类被移除了;

从3.0.0版本开始改为依赖 CameraScan;(CameraScan是一个独立的库,单独进行维护)

  • 2.x版本中的 ViewfinderView 被移除了;

从3.0.0版本开始改为依赖 ViewfinderView;(ViewfinderView是一个独立的库,单独进行维护)

  • 2.x版本中的 CaptureActivityCaptureFragment 相关基类被移除了;

从3.0.0版本开始改为 BarcodeCameraActivityBarcodeCameraFragment

除了以上几点主要差异变化,3.x版本的整体使用方式和2.x基本类似;3.x版本在2.x版本的基础上再次进行重构,将 CameraScan 相关的公共基础类从 ZXingLite 中移除后,维护起来更方便了。

如果你是从 2.x 版本升级至 3.x 版本,那么你需要知道上面所说的主要差异;特别是独立出去单独维护的库,其包名都有所变化,这一点需要特别注意;请谨慎升级。

如果你使用的是2.x版本的话请直接查看v2.x分支版本

3.x版本的使用

3.x的实现主要是以 CameraScan作为基础库去实现具体的分析检测功能,所以你可以先去看下 CameraScan的使用说明;在了解了 CameraScan的基本使用方式后,然后再结合当前的使用说明就可以轻松的集成并使用 ZXingLite 了。

主要类说明

关于Analyzer的实现类

内部提供了Analyzer对应的实现,都是为快速实现扫码识别而提供的分析器。

内部提供的分析器有多个;一般情况下,你只需要知道最终实现的 MultiFormatAnalyzerQRCodeAnalyzer 即可:

MultiFormatAnalyzerQRCodeAnalyzer 的主要区别,从名字大概就能看的出来;一个是可识别多种格式,一个是只识别二维码(具体需要支持识别哪些格式的条码,其实还要看提供的 DecodeConfig 是怎么配置的)。

本可以不需要 QRCodeAnalyzer,之所以提供一个 QRCodeAnalyzer 是因为有很多需求是只需要识别二维码就行;如果你有连续扫码的需求或不知道怎么选时,推荐直接选择 MultiFormatAnalyzer

关于DecodeConfig

DecodeConfig:解码配置;主要用于在扫码识别时,提供一些配置,便于扩展。通过配置可决定内置分析器的能力,从而间接的控制并简化扫码识别的流程。一般在使用 Analyzer 的实现类时,你可能会用到。

关于DecodeFormatManager

DecodeConfig:解码格式管理器;主要将多种条码格式进行划分与归类,便于提供快捷配置。

关于CodeUtils

工具类 CodeUtils 中主要提供;解析条形码/二维码、生成条形码/二维码相关的能力。

CodeUtils的使用示例

    // 生成二维码
    CodeUtils.createQRCode(content,600,logo);
    // 生成条形码
    CodeUtils.createBarCode(content, BarcodeFormat.CODE_128,800,200);
    // 解析条形码/二维码
    CodeUtils.parseCode(bitmap);
    // 解析二维码
    CodeUtils.parseQRCode(bitmap);

关于BarcodeCameraScanActivity

通过继承BarcodeCameraScanActivity实现扫二维码完整示例

public class QRCodeScanActivity extends BarcodeCameraScanActivity {

    @Override
    public void initCameraScan(@NonNull CameraScan<Result> cameraScan) {
        super.initCameraScan(cameraScan);
        // 根据需要设置CameraScan相关配置
        cameraScan.setPlayBeep(true);
    }

    @Nullable
    @Override
    public Analyzer<Result> createAnalyzer() {
        // 初始化解码配置
        DecodeConfig decodeConfig = new DecodeConfig();
        decodeConfig.setHints(DecodeFormatManager.QR_CODE_HINTS)//如果只有识别二维码的需求,这样设置效率会更高,不设置默认为DecodeFormatManager.DEFAULT_HINTS
                .setFullAreaScan(false)//设置是否全区域识别,默认false
                .setAreaRectRatio(0.8f)//设置识别区域比例,默认0.8,设置的比例最终会在预览区域裁剪基于此比例的一个矩形进行扫码识别
                .setAreaRectVerticalOffset(0)//设置识别区域垂直方向偏移量,默认为0,为0表示居中,可以为负数
                .setAreaRectHorizontalOffset(0);//设置识别区域水平方向偏移量,默认为0,为0表示居中,可以为负数
        // BarcodeCameraScanActivity默认使用的MultiFormatAnalyzer,如果只识别二维码,这里可以改为使用QRCodeAnalyzer
        return new MultiFormatAnalyzer(decodeConfig);
    }

    /**
     * 布局ID;通过覆写此方法可以自定义布局
     *
     * @return 布局ID
     */
    @Override
    public int getLayoutId() {
        return R.layout.activity_qrcode_scan;
    }

    @Override
    public void onScanResultCallback(@NonNull AnalyzeResult<Result> result) {
        // 停止分析
        getCameraScan().setAnalyzeImage(false);
        // 返回结果
        Intent intent = new Intent();
        intent.putExtra(CameraScan.SCAN_RESULT, result.getResult().getText());
        setResult(Activity.RESULT_OK, intent);
        finish();
    }
}

BarcodeCameraScanFragment 的使用方式与之类似。

更多使用详情,请查看app中的源码使用示例或直接查看API帮助文档

其他

JDK版本与API脱糖

当使用ZXingLite为 v2.3.x 以上版本时,(即:更新zxing至v3.5.1后);如果要兼容Android 7.0 (N) 以下版本(即:minSdk<24),可通过脱糖获得 Java 8 及更高版本 API。

compileOptions {
    // Flag to enable support for the new language APIs
    coreLibraryDesugaringEnabled true
    // Sets Java compatibility to Java 11
    targetCompatibility JavaVersion.VERSION_11
    sourceCompatibility JavaVersion.VERSION_11
}
dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.2.3'
}

相关推荐

MLKit 一个强大易用的工具包。通过ML Kit您可以很轻松的实现文字识别、条码识别、图像标记、人脸检测、对象检测等功能。

WeChatQRCode 基于OpenCV开源的微信二维码引擎移植的扫码识别库。

CameraScan 一个简化扫描识别流程的通用基础库。

ViewfinderView ViewfinderView一个取景视图:主要用于渲染扫描相关的动画效果。

版本日志

v3.2.0:2024-07-16

  • 更新CameraScan至v1.2.0
  • 更新ViewfinderView至v1.2.0
  • 优化细节

v3.1.1:2024-04-29

  • 更新CameraScan至v1.1.1
  • 更新zxing至v3.5.3

v3.1.0:2023-12-31

  • 更新CameraScan至v1.1.0
  • 更新zxing至v3.5.2
  • 更新compileSdkVersion至34
  • 更新Gradle至v8.0

v3.0.1:2023-9-13

  • 更新CameraScan至v1.0.1
  • 更新ViewfinderView至v1.1.0

v3.0.0:2023-8-23

  • 将通用基础类拆分移除并进行重构,后续维护更便捷
  • 移除 CameraScan 相关核心类,改为依赖 CameraScan
  • 移除扫码取景视图 ViewfinderView,改为依赖 ViewfinderView
  • 移除 CaptureActivityCaptureFragment,新增 BarcodeCameraScanActivityBarcodeCameraScanFragment 来替代
  • 优化扫描分析过程的性能体验(优化帧数据分析过程)

v2.4.0:2023-4-15

  • 优化CameraScan的缺省配置(CameraConfig相关配置)
  • 优化ViewfinderView自定义属性(新增laserDrawableRatio)
  • 优化ImageAnalyzer中YUV数据的处理
  • 更新CameraX至v1.2.2

赞赏

如果您喜欢ZXingLite,或感觉ZXingLite帮助到了您,可以点右上角“Star”支持一下,您的支持就是我的动力,谢谢 😃

您也可以扫描下面的二维码,请作者喝杯咖啡 ☕

关于我

我的博客 GitHub Gitee CSDN 博客园
Jenly's Blog jenly1314 jenly1314 jenly121 jenly

联系我

微信公众号 Gmail邮箱 QQ邮箱 QQ群 QQ群
Jenly666 jenly1314 jenly1314 20867961 64020761