iOS 花式二维码生成和二维码识别

综合技术 2017-12-26

iOS 原生的二维码识别非常之棒,反正比 ZXing 和 ZBar 效果都好些,所以以后打算尽量用原生的二维码识别,然后最近把原生的二维码生成也顺便做了一遍,并且在原有基础上加了一些样式参数,封了一个小库方便以后使用。

项目地址: github.com/EyreFree/EF…


EFQRCode 是一个用 Swift 编写的用来生成和识别二维码的库,基于 CoreImage 进行开发。

  • 生成:利用输入的水印图/图标等资源生成各种艺术二维码;
  • 识别:识别率比 iOS 原生二维码识别率更高。

支持 iOS / macOS / tvOS 平台,支持 CocoaPods / Carthage / SPM 集成。

概述









示例

AppStore

你可以点击下方的 AppStore 按钮从应用商店下载示例程序,支持 iOS 和 tvOS。

itunes.apple.com/cn/app/EFQR…

手动

  1. 利用 git clone 命令下载本仓库, Examples 目录包含了所有的示例程序;
  2. 用 XCode 打开对应项目编译即可。

或执行以下命令:

git clone git@github.com:EyreFree/EFQRCode.git; cd EFQRCode/Examples/iOS; open 'iOS Example.xcodeproj'

环境

版本需求
1.x XCode 8.0+
Swift 3.0+
iOS 8.0+ / macOS 10.11+ / tvOS 9.0+
4.x XCode 9.0+
Swift 4.0+
iOS 8.0+ / macOS 10.11+ / tvOS 9.0+

安装

CocoaPods

EFQRCode 可以通过CocoaPods 进行获取。只需要在你的 Podfile 中添加如下代码就能实现引入:

pod "EFQRCode", '~> 4.1.0'

然后,执行如下命令即可:

$ pod install

Carthage

Carthage 是一个去中心化的依赖管理器,它为我们构建依赖并通过提供二进制 Frameworks 的方式供我们使用。

你可以通过Homebrew 使用如下命令来安装 Carthage:

$ brew update
$ brew install carthage

通过在你的 Cartfile 添加如下语句可以将 EFQRCode 引入你的项目:

github "EyreFree/EFQRCode" ~> 4.1.0

接下来执行 carthage update 命令生成 Framework 并且将生成的 EFQRCode.framework 拖入工程即可。

Swift Package Manager

Swift Package Manager 是一个集成在 swift 编译器中的用来进行 Swift 代码自动化发布的工具。

如果你已经建立了你的 Swift 包,将 EFQRCode 加入依赖是十分容易的,只需要将其添加到你的 Package.swift 文件的 dependencies 项中即可:

dependencies: [
    .Package(url: "https://github.com/EyreFree/EFQRCode.git", Version(4, 1, 0))
]

快速使用

1. 导入 EFQRCode

在你需要使用的地方添加如下代码引入 EFQRCode 模块:

import EFQRCode

2. 二维码识别

获取图片中所包含的二维码,同一张图片中可能包含多个二维码,所以返回值是一个字符串数组:

if let testImage = UIImage(named: "test.png")?.toCGImage() {
    if let tryCodes = EFQRCode.recognize(image: testImage) {
        if tryCodes.count > 0 {
            print("There are (tryCodes.count) codes in testImage.")
            for (index, code) in tryCodes.enumerated() {
                print("The content of (index) QR Code is: (code).")
            }
        } else {
            print("There is no QR Codes in testImage.")
        }
    } else {
        print("Recognize failed, check your input image!")
    }
}

3. 二维码生成

根据所输入参数创建各种艺术二维码图片,快速使用方式如下:

//                    content: 二维码内容
//            size (Optional): 二维码宽高
// backgroundColor (Optional): 二维码背景色
// foregroundColor (Optional): 二维码前景色
//       watermark (Optional): 水印图
if let tryImage = EFQRCode.generate(
    content: "https://github.com/EyreFree/EFQRCode",
    watermark: UIImage(named: "WWF")?.toCGImage()
) {
    print("Create QRCode image success: (tryImage)")
} else {
    print("Create QRCode image failed!")
}

结果:


4. 动态二维码

可通过 EFQRCode 的类方法 generateWithGIF 来创建 GIF 二维码,使用方式如下:

//                  data: 输入的 GIF 图片的数据
//             generator: 一个用来获取设置的 EFQRCodeGenerator 对象
// pathToSave (Optional): 用来存储 GIF 的路径,默认不填的话会存储在临时路径
//      delay (Optional): 输出的动态 QRCode 的帧间延时,默认不填的话从输入的 GIF 图片获取
//  loopCount (Optional): 输出的动态 QRCode 的循环次数,默认不填的话从输入的 GIF 图片获取
if let qrcodeData = EFQRCode.generateWithGIF(data: data, generator: generator) {
    print("Create QRCode image success.")
} else {
    print("Create QRCode image failed!")
}

你可以通过查看 Demo 代码的方式来获取更多信息,结果预览:

[图片上传失败...(image-e4b4f9-1512469562303)]

使用指南

详情可参见具体使用文档: github.com/EyreFree/EF…

备注

  1. 请选用对比度较高的前景色和背景色组合;
  2. 想要提高生成二维码的清晰度可以选择使用 magnificatio 替代 size ,或适当提高它们的数值;
  3. 放大倍数过高/边长过大/二维码内容过多可能会导致生成失败;
  4. 建议对生成的二维码进行测试后投入使用,例如微信能够扫描成功并不代表支付宝也能成功扫描,请务必根据您的具体业务需要做有针对性的测试;
  5. 若有任何问题,期待得到您的反馈, IssuePull request 都是受欢迎的。

备注的备注:好用的话可以给个 星星 ,蟹蟹,QAQ...

如有任何知识产权、版权问题或理论错误,还请指正。

https://juejin.im/post/5a3214a451882503eb4b4bed

转载请注明原作者及以上信息。

您可能感兴趣的

Texture 布局篇 Texture 拥有自己的一套成熟布局方案,虽然学习成本略高,但至少比原生的 AutoLayout 写起来舒服,重点是性能远好于 AutoLayout , Texture 文档上也指出了这套布局方案的的优点: Fast : As fast as manual layout...
iOS 上的 FlexBox 布局 最近时不时的听到关于 FlexBox 的声音,除了在 Weex 以及 React Native 两个著名的跨平台项目里有用到 FlexBox 外, AsyncDisplayKit 也同样引入了 FlexBox 。 先说说 iOS 本身提供给我们 2 种布局方式: Frame,直接...
How do I add multiple UIBarButtonItems on the righ... I would like to have more than a single UIBarButtonItem on the right side of my UINavigationBar . How can I achieve this? An example of what I am ...
一行命令统计iOS工程代码总行数 我们有时候想要统计一下我们的工程的总代码行数,来获取一些成就感或者作为别的用图,这里就介绍一些如何便捷地统计代码的行数,非常简单,方法如下: 1.打开终端; 2.通过cd命令到达我们的工程文件,这里注意如果要避免统计引用的第三方库的代码量,我们就要进一步进到我们自己写的代码文件中去,一般是一...
如何实践接口的自动化测试! 去年我们公司开发了一款电商产品,这是一款集成了app,web端的b2b2c的电商平台,而我们在开发web端的时候也采用了前后端分离的开发模式,那么web端加app端产生了大量的接口,这些接口需要管理维护,需要文档编辑,最麻烦的是,因为我们的业务比较复杂,有不少业务场景需要好几个接口联调,但是又...