barcode_scanner changelog and release notes | pub.dev

NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →

7.0.02 Jun 2025Deprecated

Removed RTU-UI v1 startBarcodeScannerand startBatchBarcodeScanner deprecated APIs along with all related types.

🎉 New:
- Added support for barcode types Pharma Code, Pharma Code Two Track and PZN (Pharmazentralnummer).
- Added support for the HIBC barcode document format.
- Added support for advanced configuration of on-image barcode scanning. See more here BarcodeScannerConfiguration.
- Added the ability to configure the Barcode Scanner using the common barcode configuration, see BarcodeFormatCommonConfiguration.
- Added an option to ignore barcodes that do not decode to one of the accepted document formats for BarcodeScannerConfiguration. See more here: BarcodeScannerConfiguration.onlyAcceptDocuments.
- Added new engine modes NEXT_GEN_FAR_DISTANCE and NEXT_GEN_LOW_POWER_FAR_DISTANCE.
  - NEXT_GEN_FAR_DISTANCE is optimized for scanning from far distances.
  - NEXT_GEN_LOW_POWER_FAR_DISTANCE is optimized for scanning from far on low-power devices.
- Added new predefined subsets of barcode formats (1D, 2D, Postal, Pharma, etc.). See more here: BarcodeFormats.
- Barcode scanning results have been enhanced with more detailed information. See more here: BarcodeItem.
- Added the ability to return the barcode image in the result. See more here: BarcodeScannerConfiguration.returnBarcodeImage.
- Images returned in scanner results are now represented as image references. They can be converted to Uint8List or saved in a provided path. See more here: ImageRef.
- Introduced strictMode for certain barcode configurators. If this mode is disabled, it should allow for a higher detection rate in difficult scenarios, but with the possibility that false positive results may occur. Currently, we support strictMode for QR_CODE, MICRO_QR_CODE, RMQR_CODE, PDF_417, MICRO_PDF417 and GS1_COMPOSITE.
- Added extractImagesFromPdf function to extract images from PDF files. Returns a list of image paths as List<String>?.
- Added makeImageRefsSnapshot function to capture a snapshot of all active ImageRef instances. Returns ImageRefPoolSnapshot? with memory usage details.
- Added licenseStatusMessage property to SdkLicenseStatus.
- Added PLACE_OF_ISSUE to CommonFieldType for specifying the issuance location of identity cards.
- Added property hardwareButtonsEnabled to BarcodeCameraConfiguration in Classic component which toggles the original volume button behavior on iOS 17.2 and above.
- Added cameraZoomRange and minFocusDistanceLock properties to BarcodeCameraConfiguration in Classic component for configuring zoom range and locking minimum focus distance.
- Added onlyAcceptDocuments and returnBarcodeImage properties to BarcodeClassicScannerConfiguration for improved document filtering and barcode image output.
- Added new customization properties to SelectionOverlayScannerConfiguration in Classic component: highlightedPolygonColor, highlightedStrokeColor, highlightedTextColor, highlightedTextContainerColor, and strokeColor for improved barcode overlay appearance.
- Android: Added an option to the RTU-UI Barcode Scanner screen for keeping the screen on.
- Android: Proguard rules needed for Scanbot SDK are embedded in the package. There is no need to manually specify them in your project.
🚀 Improvements:
- Improved quiet zone checks for the barcode formats ITF, CODE_11, MSI_PLESSEY, IATA_2_OF_5, INDUSTRIAL_2_OF_5 and CODE_25.
- Improved the false positive rate for ITF barcodes.
- Improved our Barcode Scanner with a significant speed-up in live mode on very large input resolutions.
- Improved the recognition of PDF417 barcodes in the Barcode Scanner.
- Improved the Barcode Scanner to better recognize QR codes if the top left finder pattern is corrupted (up to QR code version size 20).
- More robust QR code recognition, more tolerance for destroyed or missing timing patterns and alignment patterns and a better performance on artistic QR codes.
- QR codes with non-square finder patterns and QR codes embedded in adversarial backgrounds (flow codes and more generally) can now be recognized.
- Improved barcode detection for various barcode types.
- Improved the performance when scanning four state postal barcodes (i.e. Australia Post, Japanese Post, RM4SCC, Royal TNT Post and USPS Intelligent Mail).
- Improved memory management, logging, and deallocation safety for classic component, ensuring cleaner lifecycle handling and preventing potential resource leaks.
- By default, Code 93 now includes check digits in the result. To disable this and restore the previous behavior, set stripCheckDigits = true.
🐞 Bug fixes:
- Fixed checksum for CODE_39 barcode format.
- Fixed the returned results for all types of UpcEanExtensionBehavior.
- Fixed an issue when scanning Code93 barcodes with stripCheckDigits = false (default), and the check digit was an extension character.
- iOS: Fixed processing of still images of an indexed color space model in the Barcode Scanner.
- iOS: Fixed a bug in the AR Barcode Scan and Count where the scanner would be stuck if there was no barcode detected.
- iOS: Fixed a bug in the Barcode Scanner RTU-UI v2 where the flip camera button was not resetting the widest camera available if chosen.
- iOS: Fixed a UI bug in the Barcode Scanner RTU-UI v2 where the sheet button overlapped with the action bar.
- iOS: Fixed an issue in the classic component where quickly stopping and starting the camera session could lead to a crash or unpredictable behavior.
- Android: Fixed an overflow when decoding a MICRO_QR_CODE barcode format with wrong bits in numeric mode.
- Android: Fixed minimumTextLength for ITF barcode format. Before, we used it to check the number of symbols instead of the true text length.
- Android: Fixed sorting of quad points for four-state/postal barcode types.
- Android: Fixed quad when flag BarcodeFormatConfigurationBase.addAdditionalQuietZone is enabled.
- Android: In RTU-UI v2, the modal dialog no longer appears below the status bar.
- Android: FindAndPickScanningMode.sheetContent.barcodeItemImageVisible in RTU-UI v2 now correctly applies the visibility setting.
- Android: Accessibility content for action buttons in RTU-UI v2 is now properly applied.
⚠️ Breaking Changes:
- Removed RTU-UI v1 startBarcodeScannerand startBatchBarcodeScanner deprecated APIs along with all related types.
- Removed detectBarcodesOnImages, merging image-based barcode detection into detectBarcodesOnImage for a unified API.
- Removed additionalParameters from BarcodeClassicScannerConfiguration.
- Removed NONE from CommonFieldType, as a default value is no longer required.
- Changed barcodeFormats to barcodeFormatConfigurations in BarcodeClassicScannerConfiguration, requiring a new structure for specifying barcode types.
- Changed startBarcodeScanner method's return type from ResultWrapper<BarcodeScannerResult> to ResultWrapper<BarcodeScannerUiResult>.
- initScanbotSdk API now returns a result of type SdkLicenseStatus instead of a status.
- The input parameters and result objects for detectBarcodesOnImage API were changed. See more here: ScanbotBarcodeSdk.detectBarcodesOnImage.
- Type literals for BarcodesExtensionFilter, BarcodeScannerEngineMode and FieldValidationStatus have been modified.
- Renamed types MSIPlesseyChecksumAlgorithm to MsiPlesseyChecksumAlgorithm, EngineMode to BarcodeScannerEngineMode, Gs1HandlingMode to Gs1Handling, ValidationStatus to FieldValidationStatus and BarcodeScannerConfiguration to BarcodeScannerScreenConfiguration.
- Renamed all CommonFieldType values to follow uppercase and underscore-separated naming for consistency.
- Renamed ValidationStatus to FieldValidationStatus and introduced new validation states (INFERRED, IGNORED).
- Changed Field.validationStatus default value from null to FieldValidationStatus.NONE.
- Renamed expirationDate to licenseExpirationDate and status to licenseStatus in SdkLicenseStatus.
- Renamed enum Status to LicenseStatus with updated PascalCase values (e.g., StatusOkay → Okay).
- Replaced shouldReturnCroppedImage with returnBarcodeImage in BarcodeClassicScannerConfiguration for clarity and consistency.
- Replaced type BarcodeType with BarcodeFormat.
- Replaced property recognizerConfiguration of type BarcodeRecognizerConfiguration with scannerConfiguration of type CommonBarcodeScannerConfiguration.
- Changed barcodeListener callback in BarcodeScannerCamera to use List<BarcodeItem> instead of BarcodeScanningResult.
- Changed errorListener callback in BarcodeScannerCamera to use SdkLicenseStatus instead of SdkLicenseException.
🚙 Under the hood:
- The regex filters are applied for substrings instead of the entire output string.
- Upgraded the native Scanbot iOS SDK to v7.0.2 (cf. changelog).
- Upgraded the native Scanbot Android SDK to v7.0.2 (cf. changelog).
- Updated some third party libraries. see Third-party Libraries.
- Added ffi package for interoperability with native code.
- Android: Updated Compile Sdk to 35.
- Android: Android Jetpack Compose updated to 1.7.8.

Open source →

6.1.027 Jan 2025

Added support for new barcode types Maxicode, rMQR code, Code 11 and Code 32. Added literals that represent the new barcode types in BarcodeFormat.

🎉 New:
- Added support for new barcode types Maxicode, rMQR code, Code 11 and Code 32. Added literals that represent the new barcode types in BarcodeFormat.
- Added a new optional property addAdditionalQuietZone in BarcodeAdditionalParameters. The default value is false.
- Added a new property accessibilityDescription in RoundButton and ButtonConfiguration.
- Added a new property allowEmptySubmission in MultipleScanningMode to allow submission of an empty barcode list in the Multiple Barcodes use case in RTU-UI v2.
- Added new optional properties useIATA2OF5Checksum, useCode11Checksum and australiaPostCustomerFormat in BarcodeScannerConfiguration, BatchBarcodeScannerConfiguration, BarcodeRecognizerConfiguration and BarcodeAdditionalParameters.
- Added a new type literal CONFIRMED in ValidationStatus type in GenericDocument.
- Added a new type literal NONE in CommonFieldType type used in GenericDocument.
- iOS: Added new zoom control slider controlled by the new camera control button on all view controllers. Available on all the new iPhone 16 models.
- Android: Added support for 16KB page size (Android 15).
🚀 Improvements:
- Improved detection of UPC and EAN extensions.
- Added support for Extended Channel Interpretation (ECI) for Datamatrix and Aztec barcodes.
- For CODE_128 and ITF, we improved the recognition of barcodes generated by defective thermal printers that do not print certain black bars correctly.
🐞 Bug fixes:
- Fixed KANJI mode for QR codes.
- iOS: Fixed a UI issue in the RTU-UI v2 Barcode Scanner FindAndPickScanningMode that never showed the expected barcodes title, but always the barcode value.
- iOS: Fixed a UI issue in the RTU-UI v2 Barcode Scanner FindAndPickScanningMode in button sheet mode where the counter badge was not visible.
- iOS: Fixed a UI issue on the RTU-UI v2 Barcode Scanner's sheet screen where the subtitle label was being vertically cut off.
- iOS: Fixed a UI issue on the RTU-UI v2 Barcode Scanner's confirmation sheet in the SingleScanningMode where the loading indicator was not centered when the loading message was hidden.
- iOS: Fixed a UI issue in the RTU-UI v2 Barcode Scanner where a title that was too long would cut off the cancel button.
- iOS: Fixed a UI issue in the RTU-UI v2 Barcode Scanner's finder where the background color overlapped with the line color.
- iOS: Fixed a bug in RTU-UI v2 Barcode Scanner where extended barcodes are displayed along with their non-extended versions.
- iOS: Fixed a bug that did not mirror the front camera as expected.
- iOS: Fixed a crash in scanners when setting the same minZoom and maxZoom in ZoomRange.
- Android: Fixed R8 obfuscation config for SDK logging classes.
- Android: Minor fixes for appearance in RTU-UI v2 Barcode Scanner to make it consistent with its iOS counterpart.
- Android: Fixed an issue with AR Overlay and barcode mapping in RTU-UI v2 Barcode Scanner, where the mapped image wasn't shown on the AR Overlay until the same barcode appeared in the list below.
⚠️ Breaking Changes:
- Removed duplicate methods initScanbotSdk and getLicenseStatus from scanbot_barcode_sdk_v2.dart.
- Renamed the scanbot_barcode_sdk_v2.dart file to scanbot_barcode_sdk_ui_v2.dart.
- Removed property codeDensity from BarcodeScannerConfiguration, BatchBarcodeScannerConfiguration and BarcodeAdditionalParameters.
- Removed type literals VALIDATE and DECODE and replaced them with VALIDATE_STRUCTURE, DECODE_STRUCTURE, VALIDATE_FULL and DECODE_FULL in Gs1HandlingMode.
- Changed the default values for properties okButton, cancelButton and actionButton in ScanbotAlertDialog.
- Changed the default values for properties enableCameraButton and closeButton in CameraPermissionScreen.
- Changed the default value for property visible in ArOverlayFindAndPickConfiguration to true for FindAndPickScanningMode.
- Replaced standard and validationStatus fields with validationErrors in the GS1Element class.
- Android: Changed barcodesRegexFilter behavior in BarcodeRecognizerConfiguration for BarcodeScannerConfiguration config for RTU-UI v2 Barcode Scanner. Barcodes are accepted if the barcode data contains the part that matches the regex.
🚙 Under the hood:
- Upgraded the native Scanbot Android SDK to v6.1.1.
- Upgraded the native Scanbot iOS SDK to v6.1.1.
- Added gs1-syntax-dictionary lib.

Open source →

5.1.027 Aug 2024Deprecated

Deprecated the Ready to Use UI v1 barcode scanners. Adoption of the RTU UI v2 barcode scanner API is strongly recommended.

🎉 New:
- Introduced the redesigned RTU-UI version 2 for enhanced Barcode scanning, featuring advanced agile configuration options. See Ready-to-Use UI for documentation and various use cases.
- Added support for the Micro PDF 417 barcode format.
- Added support for parsing of AAMVA Certificate of Title for motor vehicle barcodes.
- Added a new field shouldReturnCroppedImage in BarcodeClassicScannerConfiguration for the BarcodeScannerCamera Classic UI. If set to true, the result will be returned in the barcodeImageBase64 field of the BarcodeItem model.
- Launched the new FindAndPickScanningMode
🚀 Improvements:
- Optimized camera preview quality and processing speed for all scanners.
- iOS:
  - IMPORTANT: Changed the default rear cameras on all scanners to the triple or dual camera. On some devices with triple camera this results in a different view port (more zoomed in). Please make sure to adapt your zoom ranges and factors.
  - Added support of haptic feedback on capable devices.
- Android:
  - Changed the touch to focus square in the native camera view to a circle.
🐞 Bug fixes:
- Fixed issue with misaligned barcode polygons on some devices with horizontal orientation.
- For BarcodeFormat.PDF_417, a single case to generate clusters was not covered, which led to a crash.
- iOS:
  - Fixes a crash with all Classic UI components when energy saving is disabled.
⚠️ Breaking Changes:
- Deprecated the Ready to Use UI v1 barcode scanners. Adoption of the RTU UI v2 barcode scanner API is strongly recommended.
- Transitioned the format of barcode result structures from record classes to GenericDocument. This adjustment impacts RTU UI v1 but is standardized across both RTU UI v1 and RTU UI v2.
- Renamed BarcodeFormat.RSS_14 to BarcodeFormat.DATABAR and BarcodeFormat.RSS_EXPANDED to BarcodeFormat.DATABAR_EXPANDED.
- Eliminated the LiveDetector and CameraController classes. All corresponding functionalities are now integrated within the widgets themselves.
- Updated widgets to automatically adjust to configuration changes received by the camera widget constructors.
🚙 Under the hood:
- Upgraded the native Scanbot iOS SDK to v5.1.3 (cf. changelog).
- Upgraded the native Scanbot Android SDK to v5.1.0 (cf. changelog).
- Android:
  - Updated Kotlin to version 1.9.0.
  - jvmTarget = "17".
  - Updated 3rd-party libraries:
    - libjpeg-turbo to 2.1.5.1
    - libpng to 1.6.40
    - libtiff to 4.6.0
    - added zlib library
- iOS:
  - Updated 3rd-party libraries:
    - zlib to version 1.3.1
    - libtiff to 4.6.0
    - libjpeg-turbo to 2.1.5.1
    - libpng to 1.6.40.

Open source →