从0到1设计扫码框架深度拆解XCodeScanner三层解耦架构【免费下载链接】XCodeScannerA new frame for decode QR code and bar code on Android. Its faster, simpler and more accurate.项目地址: https://gitcode.com/gh_mirrors/xc/XCodeScanner扫码功能是移动应用的基础三件套之一但很少有人认真思考一个优秀的扫码框架究竟该如何设计XCodeScanner 是一个基于 ZBar 的 Android 扫码框架主打更快、更简单、更精准其最值得学习的地方正是它用三层解耦架构把视图、相机、解码三大模块彻底分离。本文将从0到1带你看懂这套架构的设计思路无论你是想自研扫码框架还是想深入理解框架源码都能从中获得启发。为什么扫码框架必须解耦一个完整的扫码流程可以拆成三件事把画面显示出来视图、把画面数据采集进来相机、从数据中识别出条码解码。很多初学者会把这三件事写进同一个 Activity 里结果就是改一行预览代码要动相机逻辑换一个解码库要重写整个页面。XCodeScanner 的做法是把三者抽象成三个独立模块彼此只通过接口通信互不依赖实现。在源码中这种设计体现在清晰的包结构上视图层view/相机层core/解码层同样位于 core/ 下通过GraphicDecoder接口与相机层对接第一层视图层管好看得见的画面 ️视图层负责解决预览画面如何正确显示和扫描框如何好看好用两个问题。AdjustTextureView自动校正画面的预览组件预览画面常见的问题是变形、旋转。XCodeScanner 自定义了AdjustTextureView继承自TextureView开放setImageFrameMatrix接口可以根据自身尺寸、图像帧宽高及旋转角度自动校正画面解决预览变形等异常。参考AdjustTextureView.javaScannerFrameView可定制的扫描框扫描框、四角、扫描线的尺寸、颜色、动画全部支持通过 xml 属性或接口自定义甚至可以通过属性控制扫描框在父容器中的宽高占比。参考ScannerFrameView.java阴影遮罩与扫码区域MaskRelativeLayout与MaskConstraintLayout分别继承自RelativeLayout和ConstraintLayout负责绘制扫描框外部的半透明阴影让扫码区域视觉上更聚焦。设计启示视图层只关心画不关心数据从哪来因此任何扫码页面都可以直接复用这套 View 组件。第二层相机层管好数据的采集 相机层是整个框架的技术难点所在XCodeScanner 通过一个接口 两套实现的方式优雅化解了 Android 相机 API 分裂的历史难题。一个接口两套实现CameraScanner定义了相机操作的统一接口打开、关闭、闪光灯、设置预览、设置解码器等参考CameraScanner.java。针对 Android 5.0 的分水岭框架提供了两个实现NewCameraScanner基于android.hardware.camera2新 APIOldCameraScanner兼容android.hardware.Camera老 API使用时只需一行判断即可自由切换Build.VERSION.SDK_INT LOLLIPOP ? new NewCameraScanner(this) : new OldCameraScanner(this)由于都实现了同一个接口业务层完全无感知。参考NewCameraScanner.java、OldCameraScanner.java三个解决痛点的关键设计子线程开启相机防止相机打开过程阻塞主线程避免界面跳转卡顿。单例信号量CameraLock防止多个实例同时操作相机引发异常参考CameraLock.java。TextureReader代替ImageReader这是框架更快的核心秘诀——用 OpenGL 绘制图像纹理解决ImageReader实时输出 YUV 图像时预览掉帧严重的问题参考TextureReader.java。此外相机层还提供了亮度回馈能力可智能提示用户开启闪光灯以及扫码框 Rect 设置接口能根据预览尺寸、图像帧尺寸、预览方向精确计算出扫码框在图像帧上的实际识别区域。第三层解码层管好条码的识别 解码层把识别条码这件事完全抽象出来通过GraphicDecoder接口定义解码行为参考GraphicDecoder.java。接口支持的能力设置需要识别的条码类型setCodeTypes可任意指定暂停/延时解码stopDecode/startDecodeDelay支持多种输入源解码YUV 帧数据、像素数组、Bitmap、本地图片 Uri解码结果通过decodeComplete回调返回包含条码类型和精度开发者可据此自定义脏数据过滤规则ZBarDecoder默认的 ZBar 实现ZBarDecoder实现了该接口在子线程中完成 ZBar 图像解析兼容Android 4.0 (API14)及以上版本同时提供DebugZBarDecoder便于示例程序进行兼容性测试。参考ZBarDecoder.java设计启示如果未来想切换 Zxing 或其他解码库只需新增一个实现类业务代码一行都不用改——这正是接口解耦的最大价值。三层如何协作一次完整的扫码流程 回到开头的 UML 类图一次扫码的完整协作流程是这样的视图层AdjustTextureView的 SurfaceTexture 就绪后通知 Activity 开启相机。相机层CameraScanner打开相机将预览帧通过TextureReader高效采集同时根据扫描框位置计算识别区域。解码层相机层把帧数据交给GraphicDecoder如ZBarDecoder在子线程解码结果通过DecodeListener回调返回。Activity 只做组装负责创建相机、绑定解码器、处理生命周期参考示例ScanActivity.java简单说View 管显示、Camera 管采集、Decoder 管识别三者通过接口串联任何一层都可以独立替换。从0到1落地三步接入你的项目 ✅如果想亲自体验这套架构动手实践是最好的学习方式在build.gradle中添加依赖implementation cn.simonlee.xcodescanner:zbar:1.1.10在布局中放入AdjustTextureView和ScannerFrameView创建相机实例、绑定解码器、实现回调即可完成扫码页面你也可以通过git clone https://gitcode.com/gh_mirrors/xc/XCodeScanner拉取完整源码与示例 demo对照本文的 UML 类图逐一阅读理解会更透彻。总结 XCodeScanner 用三层解耦架构给出了一个教科书式的扫码框架设计范本接口定义契约、实现各自独立、Activity 只做组装。这套先抽象、后实现的思路不仅适用于扫码框架也适用于任何涉及多硬件模块协作的 Android 应用设计。理解了这三点你就掌握了从0到1设计一个可维护扫码框架的核心方法视图层管画面相机层管采集解码层管识别解耦让一切变得简单。【免费下载链接】XCodeScannerA new frame for decode QR code and bar code on Android. Its faster, simpler and more accurate.项目地址: https://gitcode.com/gh_mirrors/xc/XCodeScanner创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考