flutter_barcode_sdk 5.1.2

The only Flutter barcode SDK for Android, iOS, Web, Windows, Linux, macOS. Empower developers to build 1D/2D barcode reader and barcode scanner.

flutter_barcode_sdk

A cross-platform Flutter plugin for barcode reading and scanning, powered by the Dynamsoft Barcode Reader SDK. Supports Android, iOS, Web, Windows, Linux, and macOS.

Decode a wide range of 1D and 2D barcode symbologies from image files and raw pixel buffers. Build robust barcode reader and scanner applications with minimal effort.

Tip: For production-grade live camera scanning, consider using the official Dynamsoft Capture Vision Flutter Edition which offers optimized real-time performance.

Table of Contents

• Getting Started
• Supported Platforms
• Supported Barcode Symbologies
• Platform Configuration
• Usage
• API Reference
• Examples
• License

Getting Started

1. Install the Package

dependencies:
  flutter_barcode_sdk: ^5.0.0

2. Obtain a License Key

A valid license is required to activate barcode decoding functionality.

3. Initialize the SDK

import 'package:flutter_barcode_sdk/flutter_barcode_sdk.dart';

final barcodeReader = FlutterBarcodeSdk();
await barcodeReader.setLicense('YOUR-LICENSE-KEY');
await barcodeReader.init();

Supported Platforms

Platform	Status
Android	Supported
iOS	Supported
Web	Supported
Windows	Supported
Linux	Supported
macOS	Supported

Supported Barcode Symbologies

Linear Barcodes (1D)

Code 39 (including Extended) | Code 93 | Code 128 | Code 11 | Code 32 | Codabar | Interleaved 2 of 5 | Industrial 2 of 5 | Matrix 2 of 5 | EAN-8 | EAN-13 | UPC-A | UPC-E | MSI Code | Telepen | Telepen Numeric

2D Barcodes

QR Code (including Micro QR) | Data Matrix | PDF417 (including Micro PDF417) | Aztec Code | MaxiCode (modes 2-5) | DotCode

GS1 DataBar

Omnidirectional | Truncated | Stacked | Stacked Omnidirectional | Expanded | Expanded Stacked | Limited

Postal Codes

USPS Intelligent Mail | Postnet | Planet | Australian Post | Royal Mail (RM4SCC) | KIX

Other

Patch Code | GS1 Composite Code | Pharmacode (One-Track / Two-Track) | Non-standard Barcode

Platform Configuration

Android

Set the minimum SDK version in android/app/build.gradle:

minSdkVersion 21

iOS

Add camera usage descriptions to ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required for barcode scanning.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required by the camera plugin.</string>

Windows and Linux

Ensure CMake and a platform-specific C++ compiler are installed.

macOS

Requires macOS 12+, Xcode 14+, and CocoaPods. The first build runs pod install automatically.

You must also bundle the Dynamsoft Templates/ and Models/ resource folders into your app, otherwise the SDK fails with InitSettings error -10030. A Flutter plugin cannot do this for you, so add the Copy Dynamsoft Resources build phase to your Runner target — the easiest way is pasting the ready-made post_install snippet from flutter_barcode_sdk_macos/README.md into your macos/Podfile and running pod install.

Grant these entitlements in your app's macos/Runner/*.entitlements (the bundled example already has them):

<key>com.apple.security.network.client</key><true/>
<key>com.apple.security.device.camera</key><true/>
<key>com.apple.security.files.user-selected.read-write</key><true/>

And add the camera usage description to macos/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required for barcode scanning.</string>

Web

Include the Dynamsoft JavaScript SDK in web/index.html:

<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.6.2000/dist/dbr.bundle.js"></script>

Usage

Decode from an Image File

List<BarcodeResult> results = await barcodeReader.decodeFile('path/to/image.png');

for (var result in results) {
  print('${result.format}: ${result.text}');
}

Decode from a Camera Buffer

List<BarcodeResult> results = await barcodeReader.decodeImageBuffer(
  bytes,      // Uint8List - raw pixel data
  width,      // Image width
  height,     // Image height
  stride,     // Bytes per row
  format,     // Pixel format index (e.g., ImagePixelFormat.IPF_NV21.index)
  rotation,   // 0, 90, 180, or 270
);

Set Barcode Formats

await barcodeReader.setBarcodeFormats(
  BarcodeFormat.QR_CODE | BarcodeFormat.CODE_128 | BarcodeFormat.EAN_13,
);

Configure Advanced Parameters

String params = await barcodeReader.getParameters();
// Modify the JSON string as needed...
await barcodeReader.setParameters(params);

API Reference

Method	Description	Return
setLicense(String license)	Activates the SDK with a license key.	Future<int>
init()	Initializes the barcode reader with default parameters.	Future<int>
decodeFile(String filename)	Decodes barcodes from an image file.	Future<List<BarcodeResult>>
decodeImageBuffer(...)	Decodes barcodes from raw pixel data (camera preview, etc.).	Future<List<BarcodeResult>>
setBarcodeFormats(int formats)	Sets which barcode formats to detect.	Future<int>
getParameters()	Returns the current detection settings as JSON.	Future<String>
setParameters(String params)	Updates detection settings from a JSON string.	Future<int>

See BarcodeFormat for all available format constants and ImagePixelFormat for supported pixel formats. Both are exported from package:flutter_barcode_sdk/flutter_barcode_sdk.dart.

Federated Packages

Since v5.0.0, this plugin is a federated plugin following the Flutter camera package pattern. Platform implementations are separate packages that are endorsed automatically — there is no need to add them to your pubspec.yaml:

Package	Platform
flutter_barcode_sdk_platform_interface	Platform interface contract
flutter_barcode_sdk_android	Android
flutter_barcode_sdk_macos	macOS
flutter_barcode_sdk_ios	iOS
flutter_barcode_sdk_windows	Windows
flutter_barcode_sdk_linux	Linux
flutter_barcode_sdk_web	Web

Each platform package is versioned and published independently, so each platform can be updated without affecting the others.

Examples

Mobile (Android / iOS)

cd example
flutter run

Desktop (Windows / Linux / macOS)

cd example
flutter run -d windows   # or -d linux/macos

Web

cd example
flutter run -d chrome