团队要做一个项目，里面要用到条码扫描，搜了一下，知道了Zxing。这是一个开源的条码扫描程序。官方网站有完整的Android程序可下载。但是，如果想将扫描功能融合在自己开发的程序里，则需要理清设计的思路，并去掉一些没有必要的代码。

为了让团队更方便使用，我将Zxing代码做了封装，做成了一个自定义View控件，并且生成了jar文件，可以在Android程序里直接引用。这个控件解决了不少网友询问的竖屏和横屏摆放的问题。

使用该控件很简单。首先要在项目目录下，建一个libs目录，将ZxingScanner.jar文件放进去。

然后建立项目引用，如下步骤：

1.通过Eclipse菜单Project->Properties->Java Build Path->Libraries，点击Add library；

2.选择User Library ，点击Next，点击User Library，点击New，输入随意的Library Name，比如ZxingScanner；

3.选择刚才创建的Library Name，点击Add JARs，找到libs目录下的ZxingScanner.jar，加入；

4.在Java Build Path的Libraries窗口中，就应该有这个带上了ZxingScanner.jar的library了。


 

因为扫描要用到相机，所以接着要设置AndroidManifest.xml，在里面加入使用相机的权限。

 

 
  
  1. <uses-permission android:name="android.permission.CAMERA"></uses-permission> 
  2.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> 
  3.     <uses-feature android:name="android.hardware.camera" /> 
  4.     <uses-feature android:name="android.hardware.camera.autofocus" /> 
  5.     <uses-permission android:name="android.permission.VIBRATE"/> 
  6.   <uses-permission android:name="android.permission.FLASHLIGHT"/> 
 
  
建议将控件放在一个横屏的Activity里，这样的话，由于扫描框的宽度大于高度，扫描条码时，可以将手机比较靠近条码。将Activity设为横屏大家都应该会了，但我还是附上代码吧，其实就是在AndroidManifest.xml的activity标签里加上下面这一句：
 
  
 
 
  
 
  
  1. <com.covics.zxingscanner.ScannerView 
  2.          android:id="@+id/scanner_view" 
  3.          android:layout_width="fill_parent" 
  4.          android:layout_height="fill_parent"/>   
 
  
这样，当activity打开时，会看到控件占据的区域内是相机影像，只要将中间的框对准条码，框中间的红线压住条码，就能识别。
 
  
 
 
  
别急，activity中还是要写一些代码的。
 
  
我定义的activity叫ZXingScannerActivity，它的作用是将控件识别的条码显示在一个TextView（txtResult）上。代码如下：
 
  
 
 
  
 
  
  1. package com.covics.zxingscanner;  
  2.  
  3. import android.app.Activity;  
  4. import android.graphics.Bitmap;  
  5. import android.os.Bundle;  
  6. import android.widget.TextView;  
  7. import android.widget.LinearLayout;  
  8. import android.widget.FrameLayout.LayoutParams;  
  9.  
  10. import com.covics.zxingscanner.ScannerView;  
  11.  
  12. import com.covics.zxingscanner.R;  
  13.  
  14. //activity需要实现com.covics.zxingscanner.OnDecodeCompletionListener接口  
  15. public class ZXingScannerActivity extends Activity implements OnDecodeCompletionListener{  
  16.     private ScannerView scannerView;  
  17.     private TextView txtResult;  
  18.       
  19.     /** Called when the activity is first created. */ 
  20.     @Override 
  21.     public void onCreate(Bundle savedInstanceState) {  
  22.         super.onCreate(savedInstanceState);  
  23.         setContentView(R.layout.main);  
  24.           
  25.         scannerView=(ScannerView)findViewById(R.id.scanner_view);  
  26.         txtResult = (TextView) findViewById(R.id.txtResult);  
  27.         //条码扫描后回调自己的onDecodeCompletion  
  28.         scannerView.setOnDecodeListener(this);        
  29.     }  
  30.       
  31.     //将条码扫描识别结果打印在textview上，barcodeFormat是条码格式，barcode是条码内容，bitmap是条码图像  
  32.     @Override 
  33.     public void onDecodeCompletion(String barcodeFormat,String barcode,Bitmap bitmap){  
  34.         txtResult.setText("Barcode Format:"+barcodeFormat+"  Barcode:"+barcode);  
  35.           
  36.     }  
  37.       
  38.     @Override 
  39.     protected void onResume() {  
  40.         super.onResume();  
  41.         //onResume时才打开相机和闪光灯  
  42.         scannerView.onResume();  
  43.     }  
  44.       
  45.     @Override 
  46.     protected void onPause() {  
  47.         super.onPause();      
  48.         //onPause时关闭相机和闪光灯  
  49.         scannerView.onPause();  
  50.           
  51.     }  
  52.  
  53.     @Override 
  54.     protected void onDestroy() {          
  55.               
  56.         super.onDestroy();  
  57.     }  
  58. } 
 
  
使用上就这么简单。
 
  
 
 
  

  
 
  
下面简单介绍一下ScannerView的实现原理。它扩展自FrameLayout，里面加入了一个SurfaceView和另一个扩展的View（ViewfinderView）。
 
  
SurfaceView用于显示相机的图像，通过将SurfaceView的surfaceholder传入相机对象，就能将相机的图像显示出来。
 
  
而ViewfinderView则是覆盖在SurfaceView上面，通过onDraw方法，画出中间一个框是全透明，其余区域是半透明的效果，让用户明白，通过中间全透明框取景。
 
  
扫描的原理：
 
  
CaptureActivityHandler 作为一个 handler，不断让相机自动对焦，并驱动相机获取preview图像，一旦获得preview图像，就传入给独立线程DecodeThread的 handler，有该handler负责将取景框部分的图像获取后，调用Zxing进行解码，如果解码成功，则通知ScannerView，将结果传给实现了OnDecodeCompletionListener接口的对象。
 
  

  
 
  
Zxing的简化代码是从这篇网文获取的：条码扫描二维码扫描——ZXing android 源码简化 感谢作者。
 
  
附件有两个内容：
 
  
1.ScannerView的项目源代码ZXingScanner
 
  
2.演示使用ScannerView的项目ZxingScanner Demo