ios使用zxing

ZXing(
Github镜像地址)是一个开源的条码生成和扫描库&＃xff08;开源协议为
Apache2.0)。它不但支持众多的条码格式&＃xff0c;而且有各种语言的实现版本&＃xff0c;它支持的语言包括&＃xff1a;Java、 C&＃43;&＃43;、 C#、 Objective-C、ActionScript以及Ruby。



我以前在iOS项目开发中使用了ZXing的扫描二维码功能。在此总结一下如何将ZXing集成到已有的iOS工程中&＃xff0c;分享给大家。




集成步骤



首先去Google Code或Github将ZXing的代码下载下来&＃xff0c;整个工程比较大&＃xff0c;我们只需要其中涉及iOS的部分&＃xff0c;所以最好做一些裁剪。简单来说&＃xff0c;我们只需要保留cpp和iphone这2个文件夹&＃xff0c;其余的全部删掉。如下图所示&＃xff1a;

接着我们继续裁剪&＃xff0c;对于cpp这个目录&＃xff0c;只保留cpp/core/src/zxing下面的内容&＃xff0c;其余内容也可以删掉了。但是整个目录结构必须保持原样。裁剪完后&＃xff0c;整个目录结构如下所示&＃xff1a;

接下来&＃xff0c;我们把裁剪后的zxing目录整个移动到我们的iOS项目的目录下&＃xff0c;并且把上图中可以看到的ZXingWidget.xcodeproj文件拖动到我们的iOS工程中。

下一步&＃xff0c;我们需要设置ZXing项目和我们原本的iOS项目之间的依赖关系。在我们的iOS项目的设置中&＃xff0c;点击build phases tab&＃xff0c;然后增加 Target Dependencies 和 Link binary&＃xff0c;并且增加这些framework依赖&＃xff1a;
a. AVFoundation
b. AudioToolbox
c. CoreVideo
d. CoreMedia
e. libiconv
f. AddressBook
g. AddressBookUI
完成之后如下图所示&＃xff1a;

最后一步&＃xff0c;在设置中增加如下2个header search path:

./zxing/iphone/ZXingWidget/Classes
./zxing/cpp/core/src

需要注意的是&＃xff0c;第一个path要设置成循环查找子目录&＃xff0c;而第二个不循环查找&＃xff0c;如下图所示&＃xff1a;

恭喜你&＃xff0c;完成这步之后&＃xff0c;你就已经完成ZXing库的集成了。下面谈谈如何使用ZXing库来做二维码识别。

二维码识别

ZXing的iOS版本提供2种方法来做二维码识别功能&＃xff0c;第一种方法比较简单&＃xff0c;第二种方法比较复杂。我在做Demo时使用了第一种方法&＃xff0c;做真正项目开发的时候使用了第二种方法&＃xff0c;所以都给大家介绍一下。

使用方法一
ZXing直接提供了一个扫描二维码的View Controller&＃xff0c;即ZXingWidgetController。在需要使用的界面代码中&＃xff0c;加入文件依赖&＃xff1a;
1 #import
2 #import

然后在需要扫描的时候&＃xff0c;调用如下代码即可&＃xff1a;
1 - (IBAction)scanPressed:(id)sender {
2 ZXingWidgetController *widController &＃61; [[ZXingWidgetController alloc] initWithDelegate:self showCancel:YES OneDMode:NO];
3 NSMutableSet *readers &＃61; [[NSMutableSet alloc ] init];
4 QRCodeReader* qrcodeReader &＃61; [[QRCodeReader alloc] init];
5 [readers addObject:qrcodeReader];
6 [qrcodeReader release];
7 widController.readers &＃61; readers;
8 [readers release];
9 [self presentModalViewController:widController animated:YES];
10 [widController release];
11 }

在ZXing扫描有结果时&＃xff0c;会调用如下回调函数&＃xff1a;

1 &＃64;protocol ZXingDelegate
2 - (void)zxingController:(ZXingWidgetController*)controller didScanResult:(NSString *)result;
3 - (void)zxingControllerDidCancel:(ZXingWidgetController*)controller;
4 &＃64;end

使用方法二

方法二与方法一的区别就相当于AVFoundation和UIImagePickerController的区别一样。简单来说&＃xff0c;就是使用方法二比方法一更加麻烦&＃xff0c;但是获得的可定制性更高。

使用方法二时&＃xff0c;你需要自己用AVFoundation获得Camera返回的实时图象&＃xff0c;然后转成UIImage&＃xff0c;最后传给ZXing的Decoder类完成二维码的识别。由于使用AVFoundation涉及的代码略多&＃xff0c;我写的示意代码如下&＃xff1a;

1 #import "Decoder.h"
2 #import "TwoDDecoderResult.h"
3 #import "QRCodeReader.h"
4
5 - (void)viewDidLoad {
6 // setup QR reader
7 self.qrReader &＃61; [[NSMutableSet alloc ] init];
8 QRCodeReader* qrcodeReader &＃61; [[QRCodeReader alloc] init];
9 [self.qrReader addObject:qrcodeReader];
10 self.scanningQR &＃61; NO;
11 self.step &＃61; STEP_QR;
12 }
13
14 // AVFoundation的回调函数
15 - (void)captureOutput:(AVCaptureOutput *)captureOutput didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer fromConnection:(AVCaptureConnection *)connection {
16 // 第一步&＃xff0c;将sampleBuffer转成UIImage
17 UIImage *image&＃61; [self getCaptureImage:sampleBuffer];
18 // 第二步&＃xff0c;用Decoder识别图象
19 Decoder *d &＃61; [[Decoder alloc] init];
20 d.readers &＃61; self.qrReader;
21 d.delegate &＃61; self;
22 self.scanningQR &＃61; [d decodeImage:image] &＃61;&＃61; YES ? NO : YES;
23 }

ZXing的Decoder类提供了以下回调函数获得识别结果&＃xff1a;
1 &＃64;protocol DecoderDelegate
2 &＃64;optional
3 - (void)decoder:(Decoder *)decoder willDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset;
4 - (void)decoder:(Decoder *)decoder didDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset withResult:(TwoDDecoderResult *)result {
5 NSLog(&＃64;"result &＃61; %&＃64;", [result text]);
6 }
7 - (void)decoder:(Decoder *)decoder failedToDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset reason:(NSString *)reason;
8 - (void)decoder:(Decoder *)decoder foundPossibleResultPoint:(CGPoint)point;
9
10 &＃64;end

Trouble Shoot & Tips

我在使用中遇到了一些问题&＃xff0c;主要是编译的问题。

一个是找不到 头文件。解决方法&＃xff1a;把用到ZXing的源文件扩展名由.m改成.mm。
报错&＃xff1a;Undefined symbols for architecture armv7s&＃xff0c;解决方法&＃xff1a;把ZXingWidget的一个build target参数&＃xff1a;”Build Active Architecture Only” 修改成 “NO”.
报错&＃xff1a;No such file or directory&＃xff0c;出现该错误可能是你的Header Search Path写错了&＃xff0c;或者就是你的zxing库的目录结构不是我上面强调的&＃xff0c;好好检查一下吧。
如果你需要生成二维码做测试&＃xff0c;推荐一个不错的在线生成二维码的网站&＃xff1a;http://cli.im/

ZXing和OpenCV的兼容问题

ZXing 2.1 和OpenCV 2.4.3的iOS库有一些兼容问题&＃xff0c;他们对C&＃43;&＃43;标准库的版本和编译器版本都有一些需求&＃xff0c;造成满足一方了&＃xff0c;另一方就编译不通过了。Stackoverflow上有人终于找到了一个让它们和平共处的方法&＃xff0c;但是只适用于iOS5.0以上版本。正好我们的App只支持iOS5.0&＃43;&＃xff0c;所以就搞定了。所以如果你也正好遇到这个问题&＃xff0c;可以参考这个贴子。

from: http://www.cocoachina.com/applenews/devnews/2013/0104/5462.html