Barcode Scanner View

A barcode scanner view for Android. Batteries included. Requires minSdkVersion of 9 or higher.

This is an Open Source alternative for the Google code scanner in Google's ML Kit. If you just need to scan a barcode and do not need to embed the scanning view, you should also check out the ML Kit solution.

How to include

Gradle

Add the JitPack repository in your root build.gradle at the end of repositories:

allprojects {
	repositories {
		…
		maven { url 'https://jitpack.io' }
	}
}

Then add the dependency in your app/build.gradle:

dependencies {
	implementation 'com.github.markusfisch:BarcodeScannerView:1.6.4'
}

Manually

Alternatively you may just download the latest aar from Releases and put it into app/libs in your app.

In this case you need to add the dependencies of this library to your app/build.gradle, too:

dependencies {
	implementation fileTree(dir: 'libs', include: '*')
	implementation 'com.github.markusfisch:CameraView:…'
	implementation 'com.github.markusfisch:zxing-cpp:…'
	…
}

Please take the version numbers for these two dependencies from barcodescannerview/build.gradle.

How to use

Add it to a layout:

<de.markusfisch.android.barcodescannerview.widget.BarcodeScannerView
	xmlns:android="http://schemas.android.com/apk/res/android"
	android:id="@+id/barcode_scanner"
	android:layout_width="match_parent"
	android:layout_height="match_parent"/>

Or create it programmatically:

import de.markusfisch.android.barcodescannerview.widget.BarcodeScannerView;

BarcodeScannerView scannerView = new BarcodeScannerView(context);

Run BarcodeScannerView.openAsync()/.close() in onResume()/onPause() of your activity or fragment:

	@Override
	public void onResume() {
		super.onResume();
		scannerView.openAsync();
	}

	@Override
	public void onPause() {
		super.onPause();
		scannerView.close();
	}

Crop window

You can define a square crop window with setCropRatio():

scannerView.setCropRatio(0.75f);

The number is the ratio between the size of the crop square and the shorter dimension of the view. For example, 0.75 means 75% of the view width in portrait orientation.

A crop window can improve the user experience by providing a clear UI and it also improves performance because there's less data to process.

Set barcode formats

By default only Format.QR_CODE is set.

If you don't want to scan for QR Codes you can do:

scannerView.formats.clear();

To scan for Format.EAN_13 for example:

scannerView.formats.add(de.markusfisch.android.zxingcpp.ZxingCpp.Format.EAN_13);

The following formats are supported:

• AZTEC
• CODABAR
• CODE_39
• CODE_93
• CODE_128
• DATA_BAR
• DATA_BAR_EXPANDED
• DATA_MATRIX
• EAN_8
• EAN_13
• ITF
• MAXICODE
• PDF_417
• QR_CODE
• MICRO_QR_CODE
• UPC_A
• UPC_E

Demo

You can run the enclosed demo app to see if this widget is what you're looking for.

Either import it into Android Studio or just type make to build, install and run it on a connected device.