在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/