在iOS中使用ZXing库[转]

 

前言

ZXing(Github镜像地址)是一个开源的条码生成和扫描库（开源协议为Apache2.0)。它不但支持众多的条码格式，并且有各类语言的实现版本，它支持的语言包括：Java, C++, C#, Objective-C, ActionScript和Ruby。

我上周在iOS项目开发中使用了ZXing的扫描二维码功能。在此总结一下如何将ZXing集成到已有的iOS工程中，分享给你们。

集成步骤

首先去Google Code或Github将ZXing的代码下载下来，整个工程比较大，咱们只须要其中涉及iOS的部分，因此最好作一些裁剪。简单来讲，咱们只须要保留cpp和iphone这2个文件夹，其他的所有删掉。以下图所示：

接着咱们继续裁剪，对于cpp这个目录，只保留cpp/core/src/zxing下面的内容，其他内容也能够删掉了。可是整个目录结构必须保持原样。裁剪完后，整个目录结构以下所示：

接下来，咱们把裁剪后的zxing目录整个移动到咱们的iOS项目的目录下，而且把上图中能够看到的ZXingWidget.xcodeproj文件拖动到咱们的iOS工程中。

下一步，咱们须要设置ZXing项目和咱们本来的iOS项目之间的依赖关系。在咱们的iOS项目的设置中，点击build phases tab，而后增长 Target Dependencies 和 Link binary，而且增长这些framework依赖：

a. AVFoundation
b. AudioToolbox
c. CoreVideo
d. CoreMedia
e. libiconv
f. AddressBook
g. AddressBookUI

完成以后以下图所示：

最后一步，在设置中增长以下2个header search path:

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

须要注意的是，第一个path要设置成循环查找子目录，而第二个不循环查找，以下图所示：

恭喜你，完成这步以后，你就已经完成ZXing库的集成了。下面谈谈如何使用ZXing库来作二维码识别。

二维码识别

ZXing的iOS版本提供2种方法来作二维码识别功能，第一种方法比较简单，第二种方法比较复杂。我在作Demo时使用了第一种方法，作真正项目开发的时候使用了第二种方法，因此都给你们介绍一下。

使用方法一

ZXing直接提供了一个扫描二维码的View Controller，即ZXingWidgetController。在须要使用的界面代码中，加入文件依赖：

1 2	#import <ZXingWidgetController.h> #import <QRCodeReader.h>

而后在须要扫描的时候，调用以下代码便可：

1 2 3 4 5 6 7 8 9 10 11

- (IBAction)scanPressed:(id)sender { ZXingWidgetController *widController = [[ZXingWidgetController alloc] initWithDelegate:self showCancel:YES OneDMode:NO]; NSMutableSet *readers = [[NSMutableSet alloc ] init]; QRCodeReader* qrcodeReader = [[QRCodeReader alloc] init]; [readers addObject:qrcodeReader]; [qrcodeReader release]; widController.readers = readers; [readers release]; [self presentModalViewController:widController animated:YES]; [widController release]; }

在ZXing扫描有结果时，会调用以下回调函数：

1 2 3 4

@protocol ZXingDelegate - (void)zxingController:(ZXingWidgetController*)controller didScanResult:(NSString *)result; - (void)zxingControllerDidCancel:(ZXingWidgetController*)controller; @end

使用方法二

方法二与方法一的区别就至关于AVFoundation和UIImagePickerController的区别同样。简单来讲，就是使用方法二比方法一更加麻烦，可是得到的可定制性更高。

使用方法二时，你须要本身用AVFoundation得到Camera返回的实时图象，而后转成UIImage，最后传给ZXing的Decoder类完成二维码的识别。因为使用AVFoundation涉及的代码略多，我写的示意代码以下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

#import "Decoder.h" #import "TwoDDecoderResult.h" #import "QRCodeReader.h" - (void)viewDidLoad { // setup QR reader self.qrReader = [[NSMutableSet alloc ] init]; QRCodeReader* qrcodeReader = [[QRCodeReader alloc] init]; [self.qrReader addObject:qrcodeReader]; self.scanningQR = NO; self.step = STEP_QR; } // AVFoundation的回调函数 - (void)captureOutput:(AVCaptureOutput *)captureOutput didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer fromConnection:(AVCaptureConnection *)connection { // 第一步，将sampleBuffer转成UIImage UIImage *image= [self getCaptureImage:sampleBuffer]; // 第二步，用Decoder识别图象 Decoder *d = [[Decoder alloc] init]; d.readers = self.qrReader; d.delegate = self; self.scanningQR = [d decodeImage:image] == YES ? NO : YES; }

ZXing的Decoder类提供了如下回调函数得到识别结果：

1 2 3 4 5 6 7 8 9 10

@protocol DecoderDelegate<NSObject> @optional - (void)decoder:(Decoder *)decoder willDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset; - (void)decoder:(Decoder *)decoder didDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset withResult:(TwoDDecoderResult *)result { NSLog(@"result = %@", [result text]); } - (void)decoder:(Decoder *)decoder failedToDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset reason:(NSString *)reason; - (void)decoder:(Decoder *)decoder foundPossibleResultPoint:(CGPoint)point; @end

Trouble Shoot & Tips

我在使用中遇到了一些问题，主要是编译的问题。

1. 一个是找不到 头文件。解决方法：把用到ZXing的源文件扩展名由.m改为.mm。
2. 报错：Undefined symbols for architecture armv7s，解决方法：把ZXingWidget的一个build target参数：”Build Active Architecture Only” 修改为 “NO”c++ Standard Libray:libstdc++(GNU C++ standard library)
3. 报错：No such file or directory，出现该错误多是你的Header Search Path写错了，或者就是你的zxing库的目录结构不是我上面强调的，好好检查一下吧。
4. 若是你须要生成二维码作测试，推荐一个不错的在线生成二维码的网站：http://cli.im/

ZXing和OpenCV的兼容问题

ZXing 2.1 和OpenCV 2.4.3的iOS库有一些兼容问题，他们对C++标准库的版本和编译器版本都有一些需求，形成知足一方了，另外一方就编译不经过了。Stackoverflow上有人终于找到了一个让它们和平共处的方法，可是只适用于iOS5.0以上版本。正好咱们的App只支持iOS5.0+，因此就搞定了。因此若是你也正好遇到这个问题，能够参考这个贴子。

 

http://blog.devtang.com/blog/2012/12/23/use-zxing-library/