iOS 二维码扫描组件推荐:zcscan,一款轻量级可定制的扫码工具库!

0 阅读2分钟

🚀 iOS 二维码扫描组件推荐:zcscan,一款轻量级可定制的扫码工具库!

在日常 App 开发中,扫码早已成为一个非常常见的需求,比如登录、分享、支付、设备配对等等。而系统自带的 AVCapture 使用复杂、UI 样式千篇一律,不利于快速接入和个性化定制。

今天给大家推荐一款开源的 Swift 扫码组件库 👉 zcscan,支持二维码扫描 + 相册选择,并且提供了丰富的 UI 自定义能力。


🌟 项目亮点

  • ✅ 基于 Swift 构建,轻量且易集成
  • ✅ 支持自定义扫码界面样式(线条、按钮、图标等)
  • ✅ 支持选择相册图片进行二维码识别
  • ✅ 支持 present 和 push 两种方式展示扫码页
  • ✅ CocoaPods 和 SwiftPM 均支持
  • ✅ 默认样式已足够美观,开箱即用

📦 安装方式

1️⃣ CocoaPods

pod 'zcscan'

终端执行:

pod install

2️⃣ Swift Package Manager(SPM)

  • Xcode 菜单栏选择:File > Add Packages...
  • 输入地址:github.com/ZClee128/zc…
  • 也可以在 Package.swift 中添加:
.package(url: "https://github.com/ZClee128/zcscan.git", from: "1.0.0")

⚡️ 快速上手

✅ 导入模块

import zcscan

✅ 方式一:默认 present/push 扫码页面

let vc = ZCScanViewController.present(fromVC: self, albumClickBlock: nil, resultBlock: { link in
    print("扫描结果:\(link)")
})

✅ 方式二:push + 自定义相册选择行为

let vc = ZCScanViewController.push(fromVC: self, albumClickBlock: { selectPhoto in
    let picker = ZLPhotoPicker()
    picker.selectImageBlock = { results, _ in
        if let img = results.first?.image {
            selectPhoto(img)
        }
    }
    picker.cancelBlock = {
        // 用户取消选择
    }
    picker.showPhotoLibrary(sender: self)
}, resultBlock: { link in
    print("扫描结果:\(link)")
})

🎨 UI 高度可定制

zcscan 暴露了所有必要的 UI 属性,可以根据你的品牌样式灵活设置:

let config = ZCScanManager.shared.conifg
config.selectQrcodeBtnImage = UIImage(named: "qrcode_arrow")
config.scanninglineImage = UIImage(named: "scan_line")

📷 示例效果图

IMG_1651.PNG

IMG_1650.PNG

📚 项目地址 & Demo

GitHub 地址:github.com/ZClee128/zc…

示例工程:Example/ViewController.swift

欢迎大家 Star ⭐️ 一下!


🧑‍💻 作者信息

作者:ZClee

Email:876231865@qq.com


📄 License

zcscan 使用 MIT 开源协议,免费商用,放心食用。


如果你觉得这个库不错,欢迎点赞收藏 ⭐️,转发给更多有需要的朋友!

如你需要二维码扫码、照片识别、界面自定义,zcscan 都能助你一臂之力!