基於Android的Barcode Scanner小程式

最近想開發一個基於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負責產生掃描動作。如圖：

<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目錄下：

四、進入應用入口主類：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