Skip to main content

Changelog | MAUI Barcode Scanner

tip

For additional details about the API, please refer to our API reference documentation.

MAUI - Version 5.1.0 (7 Aug 2024)

  • 🎉 New:
    • Added new freshly designed RTU-UI version 2 for Barcode scanning with advanced agile configuration. Use ScanbotSDK.MAUI.ScanbotBarcodeSDK.BarcodeScanner to leverage the new UI. See Ready-to-Use UI for documentation and various use cases.
    • Added support for filtering barcodes using a regular expression in our barcode classic component.
    • Added support for the Micro PDF 417 barcode format.
    • Added support for parsing of AAMVA Certificate of Title for motor vehicle barcodes.
  • 🚀 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.
    • Added several missing, and mostly platform specific, properties to the RTU v1 scanner configurations:
      • BarcodeScannerConfiguration and BatchBarcodeScannerConfiguration the following properties where exposed:
        • Both iOS and Android:
          • AutoCancelTimeout (this was already present in BarcodeScannerConfiguration, but was added to BatchBarcodeScannerConfiguration).
        • For Android only (accessible through #if ANDROID):
          • CameraPreviewMode
          • UseButtonsAllCaps
          • DelayAfterScan
          • TouchToFocusEnabled
          • MinFocusDistanceLock
        • For iOS only (accessible through #if iOS):
          • FocusLockEnabled
          • FocusLockPosition
          • DoubleTapToZoomEnabled
          • PinchToZoomEnabled
          • ShouldAnimateZooming
  • 🐞 Bug fixes:
    • For BarcodeFormat.Pdf417, a single case to generate clusters was not covered, which led to a crash.
    • Fixed issue with misaligned barcode polygons on some devices with horizontal orientation.
  • ⚠️ Breaking Changes:
    • IMPORTANT: The MAUI Classic UI Components: BarcodeScannerView and BarcodeScanAndCountView must now be wrapped inside ScanbotClassicUIContainer. See the example here.
    • Our Ready to Use UI v1 barcode scanners are now deprecated and it is highly encouraged to use the new RTU UI v2 barcode scanner API. All RTU v1 code has been moved to the ScanbotSDK.MAUI.RTU.v1 namespace, with RTU v2 code existing under ScanbotSDK.MAUI.
    • The structure of barcode formatted results has been changed from record classes to using GenericDocument. See API reference for the new structure here. This change affects RTU UI v1, however, the same structures are used across RTU UI v1 and RTU UI v2.
    • Renamed BarcodeFormat.Rss14 to BarcodeFormat.Databar and BarcodeFormat.RssExpanded to BarcodeFormat.DatabarExpanded.
    • ZoomRange can be created with any input values but will be limited under the hood by internal MIN_ZOOM (x0.2) and MAX_ZOOM (x100) values.
    • iOS:
      • MinFocusDistanceLock removed from BarcodeScannerConfiguration and BatchBarcodeScannerConfiguration.
        • FocusLockEnabled and FocusLockPosition are exposed for iOS and these values give more control for camera focus.
      • 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.
  • 🚙 Under the hood:

MAUI - Version 4.2.1 (25 Mar 2024)

  • 🎉 New:
    • Added new events for ScanbotSDK.MAUI.ClassicComponent.BarcodeScannerView:
      • OnBarcodeScanResult, triggered after a barcode scan result is obtained;
      • OnSelectBarcodeResult, which occurs when a barcode result is selected.
  • 🚀 Improvements:
    • Previously targeting .NET 7, now supports both .NET 7 and .NET 8.
  • 🐞 Bug Fixes:
    • Namespace issues in the classic component resolved;
    • The OverlayTextFormat property is now consistently reflected across platforms.
  • ⚠️ Breaking Changes:
    • Changes in SelectionOverlayConfiguration:
      • PolygonColor has been renamed to StrokeColor.
      • HighlightedPolygonColor has been renamed to HighlightedStrokeColor.
    • BarcodeScannerView.OverlayTextEnabled is set to true by default.
  • 🚙 Under the hood:
    • The native Scanbot iOS SDK upgraded to v4.2.2.

MAUI - Version 4.2.0 (6 Mar 2024)

  • 🎉 New:
    • Added support for several new barcode formats including:
      • AustraliaPost
      • DatabarLimited
      • Gs1Composite
      • JapanPost
      • RoyalMail
      • RoyalTntPost
      • UspsIntelligentMail
    • Enhanced control over how to handle GS1 messages in barcodes.
    • Added new components ScanbotSDK.MAUI.ClassicComponent.BarcodeScannerView and ScanbotSDK.MAUI.ClassicComponent.BarcodeScanAndCountView. It's recommended to utilize .NET 8 as your target platform because .NET 7 has issues with its Shell control which affect our Classic Component.
    • Formatted barcode documents are now exposed on barcodes via a new property called FormattedResult, which contains strongly typed records of the data contained within the barcode. The new record types include:
      • AAMVADocument
      • DEMedicalPlanDocument
      • Gs1Document
      • IDCardPDF417Document
      • MedicalCertificateDocument
      • SEPADocument
      • SwissQRDocument
      • VCardDocument
      • BoardingPass
    • Added CameraZoomRange in BarcodeScannerConfiguration and BatchBarcodeScannerConfiguration.
  • 🚀 Improvements:
    • Improved the speed of barcode recognition for most barcode symbologies.
    • Improved contour lines detection with ML Based detection.
  • 🐞 Bug fixes:
    • Android:
      • Optimized camera functionalities in ScanbotCameraXView.
  • ⚠️ Breaking changes:
    • GS1 codes are now handled differently for various barcode types. Using the default option GS1Handling.Parse will give the same result as before for all barcode types, except for BarcodeFormat.RssExpanded. Previously, for RssExpanded, the result was inconsistently returned with parentheses. Now, to get results with parentheses for all barcode types, choose the option GS1Handling.Decode.
  • 🚙 Under the hood:
    • iOS:
      • Added new methods in SBSDKCameraDevice class for camera and licensing functionalities.
    • The native Scanbot iOS SDK upgraded to v4.2.1.
    • The native Scanbot Android SDK upgraded to v4.2.0.

MAUI - Version 4.0.0 (9 Jan 2024)

  • 🚀 Improvements:
    • Improved the speed of barcode recognition for most barcode symbologies.
    • No need to call DependencyManager.RegisterServices in platform specific start-up code. Services are registered as soon as the SDK is initialized.
  • 🐞 Bug fixes:
    • Both iOS and Android:
      • InitialScanDelay only used some portions of the TimeSpan object (seconds for iOS, milliseconds for Android). Now the full total is used.
      • AutoCancelTimeout removed from BatchBarcodeScannerConfiguration as it is only currently supported for the regular barcode scanner via BarcodeScannerConfiguration.
    • Android:
      • Before, for certain invalid decodings of QR and MicroQR codes, an exception was thrown from ZXing. Now we rigorously treat this as a format error.
      • Before, we returned BarcodeFormat.Code25 results when BarcodeFormat.Industrial2Of5 was enabled and BarcodeFormat.Code25 was disabled. Now, we do not return the BarcodeFormat.Code25 result for such decoding options.
      • AutoCancelTimeout only used the seconds portion of the TimeSpan object. Now the total number of seconds is correctly used.
    • iOS:
      • Fixed a crash when denying camera permission.
      • Fixed issue with ScanbotBarcodeSDK.BarcodeService.OpenBarcodeScannerView in which the default title of the confirm button was set to the default title of the retry button.
      • AutoCancelTimeout is now applied correctly when using ScanbotBarcodeSDK.BarcodeService.OpenBarcodeScannerView.
  • ⚠️ Breaking changes:
    • All types under the BarcodeSDK namespace have been moved to the ScanbotSDK namespace.
  • 🚙 Under the hood:
    • The ScanbotBarcodeSDK.NET package is no longer referenced as a dependency. All needed files and dependencies are included directly in the package.
    • BarcodeSDK.MAUI.iOS and BarcodeSDK.MAUI.Droid assemblies merged into one assembly named BarcodeSDK.MAUI.
    • The native Scanbot Android SDK upgraded to v4.0.1.
    • The native Scanbot iOS SDK upgraded to v4.0.3.

MAUI - Version 3.7.0 (5 Oct 2023)

  • 🎉 New:
    • More supported barcode types:
      • Micro QR Code
    • Support for configuring a confirmation dialog for the Barcode Scanner Ready-To-Use UI Component.
  • 🚀 Improvements:
    • Improved accuracy and detection speed of QR_CODE, Code39, and Code93 barcode types.
    • Added support for inverted PDF-417 barcodes.
  • 🐞 Bug fixes:
    • BarcodeSDK.MAUI.ScanbotBarcodeSDK.LicenseInfo now returns the correct license status.
    • Fixed iOS-specific issue with barcode RTU-UI components not scanning on first use.
    • For BarcodeSDK.MAUI.ScanbotBarcodeSDK.DetectionService.DetectBarcodesFrom:
      • Fixed NullReferenceException when using a null ImageSource (usually from a cancelled image selection).
      • Fixed iOS-specific issue with barcodes not being scanned when no configuration is provided.
      • Fixed Android-specific issue with the method always returning null when using the ImageSource overload.
  • ⚠️ Breaking changes:
    • Renamed the BarcodeSDK.MAUI.Constants.OverlayFormat enum to BarcodeSDK.MAUI.Constants.BarcodeTextFormat.
      • Any types which use the enum have also been updated, such as BarcodeSDK.MAUI.Configurations.SelectionOverlayConfiguration.
    • If using named parameters for BarcodeSDK.MAUI.Configurations.SelectionOverlayConfiguration, the misspelled automaticSelectionEnaled parameter has been renamed to automaticSelectionEnabled.
  • 🚙 Under the hood:
    • The native Scanbot Android SDK upgraded to v3.7.0.
    • The native Scanbot iOS SDK upgraded to v3.7.1.

MAUI - Version 3.6.0 (20 Jul 2023)

  • 🎉 First release of the ScanbotBarcodeSDK.MAUI NuGet package.
  • Provides Ready-To-Use UI Components - a set of easy to integrate and customize high-level MAUI components for the most common tasks in Scanbot Barcode SDK:
    • Barcode & QR Code Scanning
    • Batch Barcode Scanning.
  • Provides additional SDK features based on image picked from the device photos application:
    • Detect Barcodes on Image
  • New unified Scanbot SDK API:
    • Idiomatic asynchronous design
    • MAUI-based unified API for Android & iOS
  • Example App demonstrating the new functionality: scanbot-barcode-sdk-maui-example

Want to scan longer than one minute?

Generate a free trial license to test the Scanbot SDK thoroughly.

Get your free Trial License

What do you think of this documentation?