안드로이드에서 바코드 스캔 기능 구현하는 방법 (ZXing 라이브러리 활용)

이 튜토리얼에서는 ZXing 라이브러리를 활용해 안드로이드 앱에 바코드 스캔 기능을 구현하는 방법을 단계별로 알아봅니다. ZXing('Zebra Crossing'의 약자)은 QR 코드와 각종 바코드를 읽을 수 있는 오픈소스 라이브러리로, 안드로이드 바코드 스캐닝 구현에 가장 널리 사용되는 솔루션입니다.

1단계: 새 프로젝트 생성

Android Studio에서 File ⇒ New Project를 선택하고, 새 프로젝트 생성에 필요한 세부 정보를 모두 입력하여 프로젝트를 만듭니다.

2단계: 레이아웃 파일 작성 (activity_main.xml)

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 화면에는 스캔을 시작할 버튼과 스캔 결과를 표시할 TextView가 배치됩니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:id="@+id/relativeLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp"
    tools:context=".MainActivity">

<TextView
    android:layout_below="@id/button"
    android:layout_centerInParent="true"
    android:layout_marginBottom="10dp"
    android:text="code reader"
    android:textSize="16sp"
    android:textStyle="bold"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:id="@+id/txtContent"/>

<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Process"
    android:layout_marginTop="50dp"
    android:layout_centerHorizontal="true"
    android:id="@+id/button" />

</RelativeLayout>

3단계: Gradle 의존성 추가

앱 수준의 build.gradle 파일에 다음 두 개의 의존성을 추가합니다. 첫 번째는 ZXing 코어 라이브러리이고, 두 번째는 안드로이드에 최적화된 임베디드 버전입니다.

implementation 'com.google.zxing:core:3.2.1'
implementation 'com.journeyapps:zxing-android-embedded:3.2.0@aar'

의존성 추가 후에는 반드시 Sync Now를 클릭하여 Gradle 동기화를 완료하세요.

4단계: 메인 액티비티 코드 작성 (MainActivity.java)

src/MainActivity.java에 다음 코드를 추가합니다. 버튼 클릭 시 IntentIntegrator가 스캔 화면을 실행하고, 스캔 결과는 onActivityResult()를 통해 받아옵니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import com.google.zxing.integration.android.IntentIntegrator;
import com.google.zxing.integration.android.IntentResult;

public class MainActivity extends AppCompatActivity {

    Button btnBarcode;
    TextView textView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        btnBarcode = findViewById(R.id.button);
        textView = findViewById(R.id.txtContent);

        btnBarcode.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                IntentIntegrator intentIntegrator = new IntentIntegrator(MainActivity.this);
                intentIntegrator.setDesiredBarcodeFormats(intentIntegrator.ALL_CODE_TYPES);
                intentIntegrator.setBeepEnabled(false);
                intentIntegrator.setCameraId(0);
                intentIntegrator.setPrompt("SCAN");
                intentIntegrator.setBarcodeImageEnabled(false);
                intentIntegrator.initiateScan();
            }
        });
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        IntentResult Result = IntentIntegrator.parseActivityResult(requestCode, resultCode, data);
        if (Result != null) {
            if (Result.getContents() == null) {
                Toast.makeText(this, "cancelled", Toast.LENGTH_SHORT).show();
            } else {
                Log.d("MainActivity", "Scanned");
                Toast.makeText(this, "Scanned -> " + Result.getContents(), Toast.LENGTH_SHORT).show();
                textView.setText(String.format("Scanned Result: %s", Result));
            }
        } else {
            super.onActivityResult(requestCode, resultCode, data);
        }
    }
}

주요 설정 옵션 설명:

setDesiredBarcodeFormats(ALL_CODE_TYPES): 모든 종류의 바코드 형식(QR 코드, EAN, CODE_128 등)을 인식하도록 설정합니다.
setBeepEnabled(false): 스캔 성공 시 경고음을 끕니다.
setCameraId(0): 후면 카메라를 사용합니다.
setPrompt("SCAN"): 스캔 화면에 표시될 안내 문구를 지정합니다.

5단계: 매니페스트 권한 설정 (AndroidManifest.xml)

카메라 접근을 위해 androidManifest.xml에 카메라 관련 권한과 하드웨어 기능 선언을 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

    <uses-feature android:name="android.hardware.camera.autoFocus" />
    <uses-feature android:name="android.hardware.camera" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정하고 진행합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 후, 툴바의 Run(실행) 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면, 실제 기본 화면과 함께 앱이 실행되는 것을 확인할 수 있습니다.

버튼을 누르면 카메라 스캔 화면이 열리고, 바코드나 QR 코드를 인식하면 결과가 토스트 메시지와 함께 화면에 표시됩니다.

팁: 에뮬레이터는 카메라 기능이 제한적이므로, 정확한 테스트를 위해서는 반드시 실제 디바이스에서 확인하는 것이 좋습니다.