React Native

Release Notes

# v1.5.26 — 2025-10-27

# New Features

• Camera Switching Support (iOS) - Added comprehensive front/back camera switching functionality
• New cameraFacing prop for VisionCamera component ('back' | 'front')
• Automatic prop-based camera switching
• Added cameraPosition parameter to setCameraSettings method for VisionSdkView (legacy component)
• Support for imperative camera switching via ref (1 = back, 2 = front)

# v1.5.26 — 2025-10-20

# New Features

• Full Bounding Box Metadata Support (Android) - Achieved complete feature parity with iOS
• Upgraded Android VisionSDK from v2.4.22 to v2.4.23
• Extract full barcode metadata including scannedCode, symbology, and gs1ExtractedInfo from bounding boxes
• Updated onIndicationsBoundingBoxes to use List[ScannedCodeResult] for comprehensive metadata

# v1.5.25 — 2025-10-14

# New Features

• Model Management - Added VisionCore.unLoadModel() method
  • Cleanup on-device models from memory and disk
  • Helps manage storage and memory resources
• Enhanced Barcode Detection - Full metadata support across platforms
  • Added symbology, boundingBox, and gs1ExtractedInfo to barcode events
  • Enhanced onCapture event with sharpnessScore and barcodes array
  • Improved onBarcodeDetected with comprehensive metadata
• Better Error Handling - Added error codes to onError callback
  • iOS: Filters error codes 13, 14, 15, 16 for cleaner error handling
  • More granular error information for debugging

# v1.5.24 — 2025-10-07

New Component: VisionCamera.Added a new lightweight VisionCamera component as an alternative to the full-featured VisionSdkView, providing core camera functionality with a

# New Features

• Multi-Mode Scanning Support
  • Photo mode
  • Barcode scanning
  • QR code scanning
  • OCR (text recognition)
  • Combined modes
• Real-time Detection Events
  • Text detection
  • Barcode detection
  • QR code detection
  • Document detection
• Camera Controls
  • Flash control via props and ref methods
  • Zoom control via props and ref methods
  • Auto and manual capture modes
• Developer Experience
  • Custom overlay support via children prop
  • Full TypeScript support with comprehensive type definitions
  • Image sharpness scoring for quality assurance
  • Auto-start on mount with proper lifecycle management

# Platform Support

• Android: Native implementation using VisionCameraView from Vision SDK
• iOS: Native implementation using CodeScannerView from Vision SDK
• Both platforms support identical APIs and features

# v1.5.18 — 2025-09-29

Major Enhancement: Cross-Platform Event Consistency. This release brings complete parity between iOS and Android implementations with enhanced barcode metadata and sharpness scoring.

# New Features

• Comprehensive Sharpness Score Support
  • Added onSharpnessScore event callback across both platforms
  • Included sharpnessScore parameter in onImageCaptured events
  • New SharpnessScoreEvent TypeScript interface
• Enhanced Barcode Metadata - Both platforms now provide identical event structure:
  • scannedCode: Barcode value
  • symbology: Barcode type/format
  • boundingBox: Coordinate and dimension data
  • gs1ExtractedInfo: Extracted GS1 data (optional)

# v1.5.16 — 2025-09-13

# 🚀 Added

• Headless OCR Prediction Methods New camera-independent prediction methods for processing existing images:
  • predict(): On-device OCR prediction for existing images
  • predictShippingLabelCloud(): Cloud shipping label prediction
  • predictItemLabelCloud(): Cloud item label prediction
  • predictBillOfLadingCloud(): Cloud bill of lading prediction
  • predictDocumentClassificationCloud(): Cloud document classification
  • predictWithCloudTransformations(): Hybrid on-device + cloud prediction

# ⚙️ Changed

• Updated Native SDKs
  • iOS VisionSDK updated to latest version
  • Android VisionSDK updated to v2.4.16

# v1.5.12 — 2025-08-27

# 🚀 Added

• Metadata Support for Logging APIs Enhanced logItemLabelDataToPx and logShippingLabelDataToPx methods with optional metadata parameter for improved data context and tracking.

# ⚙️ Changed

• Updated Native SDKs
  • Android VisionSDK updated to v2.4.12
  • iOS VisionSDK updated to v1.9.1

# v1.5.8 — 2025-08-09

# ⚙️ Changed

• Model Download Status Improvements Fixed model download status reporting and improved readiness handling on Android. Enhanced isReady flag behavior for better loading state management.

# 🐛 Fixed

• Android Model Download Progress Improved accuracy of model download status reporting using isModelAlreadyDownloaded() method.

# v1.5.4 — 2025-07-28

# ⚙️ Changed

• Native SDK Updates
  • Upgraded Android Vision SDK to v2.4.6
  • Updated on-headers version for security improvements

# v1.5.0 — 2025-07-25

# 🚀 Added

• Android Model Execution Provider Configuration New modelExecutionProviderAndroid prop allows configuration of OCR model execution on Android:
  • CPU: Default CPU execution (most compatible)
  • NNAPI: Android Neural Networks API for hardware acceleration
  • XNNPACK: Optimized CPU execution backend

# ⚙️ Changed

• Enhanced OCR Response Consistency Improved key consistency across iOS and Android platforms with backward-compatible duplicate keys (e.g., barcode_values and barcodeValues).

# 🐛 Fixed

• OCR Response Inconsistency Addressed inconsistent response keys between iOS and Android platforms while maintaining backward compatibility.

# v1.4.8 — 2025-05-12

# 🚀 Added

• Template-Based Barcode Detection
  New “Templates” mode lets users freeze the camera view and tap on specific barcode types to include or exclude them, targeting only the formats you need.

• priceTag Scanning Mode & onPriceTagDetected Event
  Dedicated priceTag mode optimized for retail price-tag scanning. Fires an onPriceTagDetected callback with:

  • price (string)
  • sku (string)
  • boundingBox (x, y, width, height)

• onBoundingBoxesDetected Event
  Emits whenever any barcode or QR code is detected on screen, returning an array of bounding boxes for real-time custom overlay rendering.

# ⚙️ Changed

• Bump VisionSDK Dependency
  Podspec and Gradle configurations now pin the underlying VisionSDK to v1.8.0.

• Example App Updates

  • Added TemplateSelectionView.tsx for barcode template selection.
  • Updated ModeSelectionView.tsx and CameraScreen.tsx to support the new modes and events.

# 🐛 Fixed

• TypeScript Types
  Added missing definitions for the onPriceTagDetected handler in src/types.ts.

# v1.4.7 — Apr 15, 2025

# 🐛 Bug Fixes

• Correct density conversion for focusImageRect on Android to ensure the focus rectangle scales properly across device densities.

# v1.4.6 — Apr 09, 2025

# ⚙️ Improvements

• Bumped core and example dependencies (e.g. @babel/helpers, image-size) to address vulnerabilities and keep packages up to date.

# 🐛 Bug Fixes

• iOS setFocusSettings now correctly updates shouldDisplayFocusImage for both true and false.

# v1.4.5 — Mar 27, 2025

# ⚙️ Improvements

• Updated peer dependencies to support React Native ≥ 0.73.0 and React ≥ 18.0.0.

# v1.4.4 — Mar 26, 2025

# ⚙️ Improvements

• iOS Podspec now pins the VisionSDK pod version automatically, removing the need for manual Podfile overrides.
• Upgraded Android VisionSDK library for compatibility with Android SDK 23.

# v1.4.3 — Mar 17, 2025

# ⚙️ Improvements

• Upgraded native Android VisionSDK to the latest release and added explicit typecasts in the Podspec to satisfy Android Gradle Plugin requirements.

# v1.4.2 — Mar 06, 2025

# ⚙️ Improvements

• Security updates: bumped cross-spawn to 7.0.6, @octokit/request-error to 5.1.1, and @octokit/request to 8.4.1.

# v1.4.1 — Mar 06, 2025

# ⚙️ Improvements

• Maintenance release with no user‑facing changes.

# v1.3.2 — Mar 06, 2025

# 🐛 Bug Fixes

• Downgraded Kotlin to 1.9.0 to restore compatibility with Android Expo builds.

# v1.3.1 — Mar 04, 2025

# ⚙️ Improvements

• Patch release with no significant changes.

# v1.3.0 — Feb 24, 2025

# ⚙️ Improvements

1. Refactored imperative handlers (prediction, error reporting, model configuration) to accept additional parameters for greater flexibility.
2. Optimized event listener registration and teardown to improve performance and prevent memory leaks.

# v1.2.2 — Feb 13, 2025

# ⚙️ Improvements

• Reverted an earlier event‑listener optimization to prevent unintended breaking changes.

# v1.2.1 — Feb 11, 2025

# ⚙️ Improvements

• Updated the VisionSDK Pod version in iOS Podspec; enforced Yarn by removing stray package-lock.json.

# v1.2.0 — Feb 11, 2025

# ⚙️ Improvements

• New shouldResizeImage prop to control whether images are resized before being sent to the SDK.

# v1.0.10 — Feb 06, 2025

# ⚙️ Improvements

• Introduced an isReady flag to signal when the model has fully initialized after download, on both iOS and Android.

# v1.0.9 — Jan 30, 2025

# ⚙️ Improvements

1. GS1 barcode support with gs1ExtractedInfo for richer barcode metadata.
2. New ocrType prop to decouple model type selection (e.g. shipping_label, item_label) from ocrMode.
3. Refactored reportError handler to handle multiple model classes and improved example app performance.
4. Fixed missing permissions setup for react-native-permissions-lib.