🚀 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")
📷 示例效果图
📚 项目地址 & Demo
GitHub 地址:github.com/ZClee128/zc…
示例工程:Example/ViewController.swift
欢迎大家 Star ⭐️ 一下!
🧑💻 作者信息
作者:ZClee
Email:876231865@qq.com
📄 License
zcscan 使用 MIT 开源协议,免费商用,放心食用。
如果你觉得这个库不错,欢迎点赞收藏 ⭐️,转发给更多有需要的朋友!
如你需要二维码扫码、照片识别、界面自定义,zcscan 都能助你一臂之力!