最近想开发一个基于Android的Barcode Scanner的简单程式,但是在网络上始终找不到简单易懂的Demo,于是在英文网站https://code.google.com/p/zxing/)找啊,找啊~终于摸索出来了,原来那么简单,但是排错的过程挺纠结~所以在此好好地记下来。


一、下载需要的资源

1、BarcodeScanner4.4.apk    一般我们的设备里都会预装此软件,但是如果没有的话,就需要装上。使用国产山寨手机的小伙伴们要注意了,你可能会装不上,因为预装的BarcodeScanner可能不能卸载,不能被覆盖,就是因为这个原因,让我不能在真机上测试,郁闷了很久。

2、ZXing-2.2.zip    这包含了zxing的源码,和部分demo程式。我们的程式将需要用到里面的类。


二、创建Android Application Project

这个过程非常简单,界面里需要两个组件:TextView负责显示扫描结果, Button负责产生扫描动作。如图:

150707522.png

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".BarCodeScannActivity" >
    <TextView
        android:id="@+id/tv_result"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/hello_world" />
                                                                                                                                                                                             
    <Button
        android:id="@+id/btn_scann"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_below="@+id/tv_result"
        android:text="Scanning" />
</RelativeLayout>

三、引入工具类

我们将引入两个工具类,来自之前下载的ZXing-2.2.zip文件:

E:\TOOLS\ZXING\zxing-1.6\android-integration\src\com\google\zxing\integration\android\IntentIntegrator.java

E:\TOOLS\ZXING\zxing-1.6\android-integration\src\com\google\zxing\integration\android\IntentResult.java

这两个类是官方给我们封装好的,我们可以直接简单的使用,将此两个类按照package层级复制到我们新建的Project中src目录下:

151636780.png

四、进入应用入口主类:BarCodeScannActivity.java

public class BarCodeScannActivity extends Activity {
                                                                               
    private TextView tvResult;
    private Button btnScann;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_bar_code_scann);
                                                                                   
        this.tvResult = (TextView) findViewById(R.id.tv_result);
        this.btnScann = (Button) findViewById(R.id.btn_scann);
                                                                                   
        this.btnScann.setOnClickListener(new View.OnClickListener() {
                                                                                       
            @Override
            public void onClick(View v) {
                // 通过观察IntentIntegrator代码发现,此类是构造函数是私有的,同时“触发”扫面器的
                // 方法initiateScan也是静态方法,所以可以直接调用。
                IntentIntegrator.initiateScan(BarCodeScannActivity.this);
                                                                                           
            }
        });
    }
                                                                               
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        // 返回并解析扫描得到的结果
        IntentResult scanResult = IntentIntegrator.parseActivityResult(requestCode, resultCode, data);
        if(scanResult != null) {
            this.tvResult.setText("Contents: " + scanResult.getContents() + "\n" +
                    "Format: " + scanResult.getFormatName());
        }
    }
}

五、添加权限与特性(我也是直接Copy官方文档的)

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.panny.mybarcodescanner"
    android:versionCode="1"
    android:versionName="1.0" >
    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="17" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.FLASHLIGHT" />
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="com.android.browser.permission.READ_HISTORY_BOOKMARKS" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-feature
        android:name="android.hardware.camera"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.camera.front"
        android:required="false" />
    <!-- TODO replace above two with next line after Android 4.2 -->
    <!-- <uses-feature android:name="android.hardware.camera.any"/> -->
    <uses-feature
        android:name="android.hardware.camera.autofocus"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.camera.flash"
        android:required="false" />
    <uses-feature android:name="android.hardware.screen.landscape" />
    <uses-feature
        android:name="android.hardware.wifi"
        android:required="false" />
    <!-- This excludes Google TV, which is unfortunately included by virtue of not requiring a camera -->
    <uses-feature android:name="android.hardware.touchscreen" />
    <!-- TODO make this not required again after android.hardware.camera.any is available -->
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.panny.mybarcodescanner.BarCodeScannActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

六、编码结束,在模拟器上运行不出效果,发布到设备上,找本书扫扫看吧~


总结:

此Demo只能作为简单的演示,如果希望符合生产场景,就需要仔细阅读其它重要的源码,比如:

E:\TOOLS\ZXING\zxing-1.6\android-integration\src\com\google\zxing\integration\android\IntentIntegrator.java

E:\TOOLS\ZXING\zxing-1.6\android-integration\src\com\google\zxing\integration\android\IntentResult.java

E:\TOOLS\ZXING\zxing-1.6\android\src\com\google\zxing\client\android\Intents.java

E:\TOOLS\ZXING\zxing-1.6\android\src\com\google\zxing\client\android\CaptureActivity.java