Deprecation warning

Please note that this is outdated documentation for an older release of the Scandit Barcode Scanner SDK.

We are deprecating the 5.x API on all platforms (except Linux). Release 5.19 in April 2021 will be our final. Applications running 5.x will continue to work, and we will continue to release critical bug fixes and security patches only, for one year. We encourage you to migrate to 6.x and take advantage of our latest / advanced features and improved performance.

You'll find the updated documentation at: Data Capture SDK Documentation for React Native

Integrate the Scandit Barcode Scanner plugin into your app

To integrate the Scandit Barcode Scanner into your React Native app, follow the simple steps below.

Create a new project

If you do not have a React Native project yet, you should create a new one.

react-native init helloworld

Add the plugin to your project

Use the React Native CLI to add the plugin to your already existing project.

cd <directory of your project>
npm install react-native-scandit@ --save
react-native link react-native-scandit

Add Android dependencies

  • Download the Barcode Scanner SDK for Android. It's available from your Scandit Barcode Scanner SDK account at in the Downloads section.
  • Inside the archive you will find a file named ScanditBarcodeScanner.aar . Copy it to <directory_of_your_project>/android/libs, then in your main build.gradle file add
allprojects {
repositories {
flatDir {
dirs "$rootDir/libs"

Add iOS dependencies

  • Download the Barcode Scanner SDK for iOS. It's available from your Scandit Barcode Scanner SDK account at in the Downloads section.
  • Create a ScanditSDK folder inside the iOS folder and move ScanditBarcodeScanner.framework inside the newly created folder.
  • Add the required frameworks to your Xcode project (see
  • Drag and drop ScanditBarcodeScanner.framework inside the Framework folder in Xcode (in the dialog, choose not to copy items).
  • From the Finder, go to ScanditBarcodeScanner.framework/Resources and drag and drop ScanditBarcodeScanner.bundle inside the Framework folder in Xcode (again choose not to copy items).
  • In Xcode, select your project in the Navigator, then select the app target and in the "Linked Frameworks and Libraries" section delete the greyed out libRCTScanditBarcodeScanner.a and link it again via the plus button.
  • Add the previously added ScanditBarcodeScanner.framework to the "Linked Frameworks and Libraries" section.
  • Go to "Build Phases", then to "Copy Bundle Resources", and add ScanditBarcodeScanner.bundle.
  • Go to "Build Settings", search "Framework Search Path" and add the following search path "$(PROJECT_DIR)/ScanditSDK".

Instantiate and configure the barcode picker

The scanning process is managed by the BarcodePicker. Before instantiating the picker, you will have to set your Scandit Barcode Scanner license key. The key is available from your Scandit Barcode Scanner SDK account at in the License Keys section. The barcode scanning is configured through an instance of scan settings that you pass to the BarcodePicker as props.

// Set your license key.
ScanditModule.setAppKey('-- ENTER YOUR SCANDIT LICENSE KEY HERE --');
this.settings = new ScanSettings();
this.settings.setSymbologyEnabled(Barcode.Symbology.EAN13, true);
this.settings.setSymbologyEnabled(Barcode.Symbology.EAN8, true);
this.settings.setSymbologyEnabled(Barcode.Symbology.UPCA, true);

Render the BarcodePicker

Show the scanner to the user by adding it to the render() function.

render() {
return (
ref={(scan) => { this.scanner = scan }}
scanSettings={ this.settings }
onScan={(session) => { this.onScan(session) }}
style={{ flex: 1 }}/>

Add callback to handle the scanning event

You now need to define the function that is referenced in the BarcodePicker props.

onScan(session) {
alert(session.newlyRecognizedCodes[0].data + " " + session.newlyRecognizedCodes[0].symbology);

Start the scanner

Start the actual scanning process to start the camera and look for codes.


Build and run the app

Compile your project. Attach a device and run the app on your desired plattform.

react-native run-android

Next steps