简介本资源面向Android开发者与移动应用学习者聚焦在项目中集成ZXing实现二维码与条形码扫描功能解决条码识别、相机调用与结果解析等常见开发需求。压缩包共1874个文件以flat、json、xml、dex、class等构建与配置产物为主另含java源码、jar库、png资源及gradle脚本整体约18.42MB结构接近一个可直接参考的Android工程。资源附带说明使用文档.docx并包含MyApplication示例应用便于对照学习依赖配置、扫描界面搭建、Intent启动扫描、onActivityResult结果处理、相机权限检查、闪光灯支持与扫描区域提示等关键环节同时提供错误处理与用户体验优化思路。目前已有2535人学习下载适合希望快速掌握ZXing集成流程、理解扫描逻辑并落地到实际项目中的开发者参考。1. 扫码功能从零落地为什么我建议你从 ZXing 这套源码开始拆上个月帮一个做仓储盘点的小团队看代码他们 App 里扫码模块用的是某商业 SDK授权到期后整个入库流程直接卡死临时换库又发现接口封装得太深连个回调都改不动。这种被第三方绑定卡脖子的场景我在项目里见过太多次。所以当我拿到这份「实现二维码扫描和条形码扫描」的源码包时第一反应就是它把 ZXing 这头老黄牛直接摊开给你看从相机预览、图像裁剪、解码回调到结果处理整条链路都在你手里。这份资源适合两类人一类是刚接触 Android 扫码、想搞明白一帧画面怎么变成一串字符的新手另一类是做过多款 App、但一直用封装库、想自己掌控解码参数和性能调优的老手。它不依赖任何云端识别服务纯本地解码离线可用这一点在弱网仓库、地下车库这类场景里就是刚需。2. 技术选型与工程结构ZXing 在 Android 上到底怎么接2.1 为什么是 ZXing而不是别的方案扫码这件事市面上常见三条路调用系统相机 云端识别、集成商业 SDK、以及本地开源库。云端方案延迟高、有流量成本、隐私数据要出设备商业 SDK 功能全但授权和包体积是负担。ZXingZebra Crossing是 Java 实现的开源一维/二维条码处理库核心解码逻辑不依赖网络Apache 2.0 协议改起来没有法律包袱。这份源码走的就是 ZXing 本地解码路线相机预览用 Android 原生 Camera API部分分支用 CameraX解码线程独立主线程只负责 UI 和结果回调。选型上有个细节值得说ZXing 官方提供的android-core和android-integration两个模块前者是给开发者自己写扫描界面用的后者是 Intent 集成调起一个现成的扫码 Activity。这份源码用的是前者也就是说扫描界面、取景框、闪光灯按钮、权限申请这些都要自己写。对新手来说多了一点工作量但换来的是完全可控——取景框大小、解码格式白名单、连续扫描间隔全都能改。2.2 目录结构一览拿到源码后先别急着跑花五分钟把目录过一遍后面改起来心里有数。典型结构如下不同分支命名略有差异app/ ├── src/main/ │ ├── java/com/example/scanner/ │ │ ├── CameraManager.java // 相机打开、预览、对焦 │ │ ├── DecodeThread.java // 解码工作线程 │ │ ├── DecodeHandler.java // 处理预览帧消息 │ │ ├── CaptureActivity.java // 扫描主界面 │ │ ├── ViewfinderView.java // 取景框自定义 View │ │ └── ResultActivity.java // 结果展示页 │ ├── res/layout/ │ │ ├── activity_capture.xml │ │ └── activity_result.xml │ └── AndroidManifest.xml └── build.gradleCameraManager管硬件DecodeThread管计算CaptureActivity管生命周期和 UIViewfinderView负责画那个会动的扫描线。职责切得比较干净二次开发时想换 UI 只动 View想调解码策略只动 DecodeHandler。2.3 依赖与权限配置build.gradle里核心依赖就一个dependencies { implementation com.google.zxing:core:3.5.2 // 解码核心纯 Java implementation com.google.zxing:android-core:3.5.2 // 相机配置工具类 }AndroidManifest.xml里必须声明相机权限和硬件特性uses-permission android:nameandroid.permission.CAMERA / uses-permission android:nameandroid.permission.FLASHLIGHT / uses-feature android:nameandroid.hardware.camera android:requiredtrue / uses-feature android:nameandroid.hardware.camera.autofocus android:requiredfalse /注意autofocus设成false是常见做法因为部分低端设备没有自动对焦设成true会导致应用在应用市场被过滤掉。运行时权限Android 6.0在CaptureActivity的onResume里检查没授权就弹系统对话框拒绝后给一个引导去设置的提示。3. 核心链路拆解一帧预览画面如何变成扫码结果3.1 相机预览与帧数据获取扫码的起点是拿到相机的预览帧。这份源码用的是CameraAPI 的setPreviewCallbackWithBuffer比setPreviewCallback少一次内存分配在连续扫码场景下更稳。// CameraManager.java 片段 public void startPreview() { Camera.Parameters params camera.getParameters(); // 选择预览尺寸优先选接近 1280x720 的 Point previewSize findBestPreviewSize(params); params.setPreviewSize(previewSize.x, previewSize.y); // 连续对焦模式扫码时画面容易糊 params.setFocusMode(Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE); camera.setParameters(params); camera.setPreviewCallbackWithBuffer(this); // this 实现 PreviewCallback camera.startPreview(); } Override public void onPreviewFrame(byte[] data, Camera camera) { // data 是 NV21 格式的原始帧直接丢给解码线程 if (decodeHandler ! null) { decodeHandler.obtainMessage(DecodeHandler.DECODE, data).sendToTarget(); } camera.addCallbackBuffer(data); // 复用缓冲区 }这里有几个参数值得盯FOCUS_MODE_CONTINUOUS_PICTURE比FOCUS_MODE_AUTO更适合扫码因为它会持续微调焦距不会出现对焦一次后画面又糊掉的情况。预览尺寸不是越大越好1280x720 在多数中端机上解码速度和清晰度平衡得最好选 1920x1080 反而会因为单帧数据量大导致解码线程排队。3.2 解码线程与 ZXing 核心调用解码放在独立线程避免阻塞主线程导致预览卡顿。DecodeHandler收到帧数据后把 NV21 转成 ZXing 能吃的PlanarYUVLuminanceSource再交给MultiFormatReader。// DecodeHandler.java 片段 private void decode(byte[] data, int width, int height) { long start System.currentTimeMillis(); // 裁剪取景框区域减少无效计算 Rect rect viewfinderView.getScanRect(); byte[] rotated rotateYUV420Degree90(data, width, height); // 竖屏旋转 PlanarYUVLuminanceSource source new PlanarYUVLuminanceSource( rotated, height, width, rect.top, rect.left, rect.width(), rect.height(), false); BinaryBitmap bitmap new BinaryBitmap(new HybridBinarizer(source)); try { Result result multiFormatReader.decodeWithState(bitmap); // 解码成功回传结果 Message.obtain(captureHandler, CaptureActivity.DECODE_SUCCESS, result).sendToTarget(); } catch (NotFoundException e) { // 没扫到是常态不打印堆栈直接继续 } finally { multiFormatReader.reset(); } }HybridBinarizer是 ZXing 里对光照不均场景比较友好的二值化器比GlobalHistogramBinarizer更适合手机摄像头。decodeWithState配合reset是官方推荐的复用写法避免每次解码都重建 Reader。裁剪取景框区域这一步很关键——整帧 1280x720 有 92 万像素而取景框可能只占中间 60%裁剪后计算量直接砍掉近一半扫码响应肉眼可见变快。3.3 结果回调与连续扫描控制解码成功后CaptureActivity收到消息通常会做三件事震动/响铃提示、把结果传给调用方、决定是否继续扫。// CaptureActivity.java 片段 private Handler captureHandler new Handler(Looper.getMainLooper()) { Override public void handleMessage(Message msg) { if (msg.what DECODE_SUCCESS) { Result result (Result) msg.obj; // 1. 反馈 playBeepSoundAndVibrate(); // 2. 回传 Intent intent new Intent(); intent.putExtra(SCAN_RESULT, result.getText()); intent.putExtra(SCAN_FORMAT, result.getBarcodeFormat().name()); setResult(RESULT_OK, intent); // 3. 连续扫描模式延迟 1.5 秒再恢复预览 if (continuousMode) { isDecoding false; handler.postDelayed(() - isDecoding true, 1500); } else { finish(); } } } };isDecoding这个标志位是防重复的关键。扫码枪式的连续扫描如果不加节流同一个码会被连续识别十几次业务层收到一堆重复回调。1.5 秒是个经验值太短容易重复太长影响连续作业效率。result.getBarcodeFormat()返回的是QR_CODE、CODE_128、EAN_13这类枚举业务层可以据此判断扫的是二维码还是一维码。3.4 支持的码制与格式白名单ZXing 默认支持一大堆格式但实际项目里往往只需要几种。在DecodeThread初始化时设置白名单能减少误识别、提升速度// DecodeThread.java 片段 CollectionBarcodeFormat formats new ArrayList(); formats.add(BarcodeFormat.QR_CODE); formats.add(BarcodeFormat.CODE_128); formats.add(BarcodeFormat.EAN_13); hints.put(DecodeHintType.POSSIBLE_FORMATS, formats); hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE); // 提高识别率代价是慢一点TRY_HARDER这个 hint 在光线差、码有磨损时很有用但它会让解码尝试更多旋转和采样单帧耗时可能翻倍。我的建议是正常场景关掉遇到难扫的码再动态打开或者干脆给用户一个「增强模式」开关。4. 跑起来与真机调试从编译到第一次扫出结果4.1 环境准备与编译这份源码是标准 Android Gradle 工程编译前确认三件事JDK 版本建议 17、Android SDK 版本compileSdk一般 33 或 34、以及 Gradle 版本匹配。用 Android Studio 打开后先Sync Project with Gradle Files如果卡在下载依赖检查settings.gradle里的仓库地址是否包含google()和mavenCentral()。# 命令行编译 debug 包 ./gradlew assembleDebug # 安装到已连接设备 ./gradlew installDebug编译报错最常见的是minSdkVersion太低导致某些 API 找不到。ZXing 的android-core要求minSdk至少 19但相机 API 的某些方法在 21 以下行为不一致建议直接设成 21。4.2 真机调试要点模拟器扫不了码必须真机。第一次跑起来如果预览是黑屏按这个顺序排查相机权限是否授予、SurfaceView是否在surfaceCreated之后才startPreview、以及相机是否被其他应用占用。日志过滤Camera和DecodeHandler两个 tag能看到帧回调和解码尝试的节奏。调试时我习惯在DecodeHandler里加一行耗时日志if (System.currentTimeMillis() - start 200) { Log.w(DecodeHandler, slow frame: (System.currentTimeMillis() - start) ms); }超过 200ms 的帧说明解码压力大可能是预览尺寸选大了或者TRY_HARDER开着或者取景框裁剪没生效。4.3 常见问题排查现象预览画面拉伸变形。原因相机预览尺寸和 SurfaceView 宽高比不一致。解决在CameraManager里根据 SurfaceView 的实际宽高比去选最接近的预览尺寸而不是固定 1280x720。现象扫二维码秒出扫一维码死活扫不出。原因一维码需要更宽的取景区域和更高的水平分辨率二维码是二维的对高度也敏感。解决给一维码单独调大取景框宽度或者提示用户把码放远一点让整条码进入画面。现象连续扫多个码时第二个码要等好几秒才识别。原因解码线程还在处理上一帧或者isDecoding标志位恢复太慢。解决检查DecodeThread的消息队列是否堆积必要时用removeMessages清掉过期帧。现象暗光下完全扫不出。原因没有补光二值化失败。解决加闪光灯开关或者在Camera.Parameters里开FLASH_MODE_TORCH。注意有些设备开闪光灯后预览帧会变亮但解码反而更差需要实测。现象部分手机扫码时画面卡顿。原因onPreviewFrame里做了耗时操作或者缓冲区复用没做好导致 GC 频繁。解决确保onPreviewFrame里只做消息投递所有计算都在解码线程addCallbackBuffer一定要在投递后立刻调用。5. 二次开发改造从能扫到好用我踩过的几个坑5.1 把扫描结果接入业务流的正确姿势很多新手拿到源码后直接在CaptureActivity里写业务逻辑比如扫到码就发网络请求。这是大忌——扫描界面应该只负责「扫出字符串」业务处理交给调用方。正确做法是通过setResult回传调用方用startActivityForResult或ActivityResultLauncher接收。// 调用方 ActivityResultLauncherIntent scanLauncher registerForActivityResult( new ActivityResultContracts.StartActivityForResult(), result - { if (result.getResultCode() RESULT_OK result.getData() ! null) { String code result.getData().getStringExtra(SCAN_RESULT); String format result.getData().getStringExtra(SCAN_FORMAT); handleScannedCode(code, format); // 业务处理 } }); scanLauncher.launch(new Intent(this, CaptureActivity.class));这样扫描模块可以独立成 library 模块多个业务页面复用也方便单独测试。5.2 性能调优的三个抓手第一预览尺寸别贪大。我实测过一台骁龙 6 系的老机器1280x720 平均解码 80ms1920x1080 直接飙到 220ms扫码体验天差地别。第二取景框裁剪一定要做而且裁剪区域要跟着ViewfinderView的实际绘制区域走别写死坐标。第三解码格式白名单按业务需要开一个只扫二维码的 App 没必要把CODE_39、PDF_417全打开。5.3 一个容易忽略的细节屏幕旋转与帧方向竖屏 App 里相机传感器输出的帧默认是横的必须旋转 90 度才能正确解码。这份源码在DecodeHandler里做了rotateYUV420Degree90但如果你改了Activity的screenOrientation旋转逻辑也要跟着调。我见过一个项目把扫描页锁成横屏结果旋转代码没改二维码怎么都扫不出查了一下午才发现是方向问题。从那以后我每次改扫描页的屏幕方向配置都会强制走一遍竖屏和横屏两种真机测试确认帧方向和解码区域都对得上。5.4 扩展方向从扫码到图像识别入口ZXing 解码拿到的Result对象里除了文本还有getRawBytes()和getResultPoints()。前者是原始字节扫二进制码比如某些工业条码时有用后者是码在画面中的四个角点坐标可以做 AR 叠加、扫码动画跟随。如果你后续想接 OCR 或物体识别onPreviewFrame拿到的帧数据可以直接喂给其他模型这份源码的相机链路就是一个现成的图像采集入口。改造时注意线程模型——别在解码线程里跑模型推理另开一个线程池用帧队列做背压否则预览会卡成幻灯片。希望这份拆解能帮你少走点弯路把扫码这个看似简单、实则细节一堆的模块真正吃透。本文还有配套的精品资源点击获取