chore: Update documentation and improve scanner functionality

- Added comprehensive documentation for supported barcode formats, including PDF417
- Enhanced README with examples and troubleshooting sections
- Implemented Windows platform support documentation and runtime checks
- Improved scanning accuracy guidelines and best practices
- Fixed RenderFlex overflow in DraggableSheet widget
- Updated dependencies and example configurations
- Removed deprecated DraggableSheet component

Author: itsarvinddev

CHANGELOG.md

@@ -5,6 +5,26 @@
 - Added comprehensive documentation for supported barcode formats including PDF417
 - Updated example to demonstrate PDF417 format configuration
 - Enhanced README with format configuration examples
+- Added comprehensive documentation for supported barcode formats including PDF417
+- Updated example to demonstrate PDF417 format configuration
+- Enhanced README with format configuration examples
+- Added Windows platform support documentation and runtime checks
+- Added scanning accuracy and best practices documentation
+- Added troubleshooting sections for common issues:
+  - iOS CocoaPods dependency conflicts
+  - Scanner crashes and black screen issues
+  - Web mobile compatibility limitations
+  - Distance scanning accuracy limitations
+- Updated example to show proper navigation patterns for auto-closing scanner
+- Added orientation handling improvements with `restoreOrientationsOnClose` parameter
+- Fixed RenderFlex overflow in DraggableSheet widget
+
+**Documentation:**
+
+- Added comprehensive troubleshooting guide
+- Added platform support limitations documentation
+- Enhanced usage examples with best practices
+- Added known limitations section for dependency-related issues
 
 ## 6.0.1
 

README.md

@@ -22,6 +22,8 @@
 | ------- | --- | ----- | --- | ----- | ------- |
 | ✔       | ✔   | ✔     | ✔   | :x:   | :x:     |
 
+> **Note:** Windows is **not supported** because the underlying [mobile_scanner](https://pub.dev/packages/mobile_scanner) package does not support Windows. If you need Windows support, please follow the mobile_scanner repository for updates.
+
 ## Features Supported
 
 See the example app for detailed implementation information.
@@ -67,6 +69,38 @@ Example,
 <string>This app needs photos access to get QR code from photo library</string>
 ```
 
+#### Troubleshooting iOS CocoaPods Issues
+
+If you encounter CocoaPods dependency conflicts (especially with Firebase), try these steps:
+
+1. **Update CocoaPods specs:**
+
+   ```bash
+   pod repo update
+   ```
+
+2. **If that doesn't work, clean and reinstall:**
+
+   ```bash
+   # Delete pod files
+   rm -rf ios/Pods ios/Podfile.lock
+
+   # Clean Flutter
+   flutter clean
+   flutter pub get
+
+   # Update iOS platform version in Podfile
+   # Change platform :ios, '11.0' to platform :ios, '14.0'
+
+   # Reinstall pods
+   cd ios
+   pod install
+   cd ..
+   flutter build ios
+   ```
+
+This is a known issue with the underlying mobile_scanner package and its dependencies.
+
 ### macOS
 
 Ensure that you granted camera permission in XCode -> Signing & Capabilities:
@@ -78,6 +112,8 @@ Ensure that you granted camera permission in XCode -> Signing & Capabilities:
 As of version 5.0.0 adding the barcode scanning library script to the `index.html` is no longer required,
 as the script is automatically loaded on first use.
 
+> **Note:** Web support may have compatibility issues on mobile devices (smartphones). For optimal mobile experience, consider using native Android/iOS apps instead of web apps.
+
 ### Providing a mirror for the barcode scanning library
 
 If a different mirror is needed to load the barcode scanning library,
@@ -134,64 +170,57 @@ controller: MobileScannerController(
 ),
 ```
 
+## Scanning Accuracy & Best Practices
+
+### Distance Scanning
+
+The barcode scanner may have reduced accuracy when scanning from a distance. For optimal results:
+
+- **Keep the barcode within 10-30 cm** of the camera
+- **Ensure good lighting** conditions
+- **Hold the device steady** while scanning
+- **Clean the camera lens** if scanning is unclear
+
+### Known Limitations
+
+- **Distance accuracy**: Scanning from far distances may result in incorrect readings
+- **This is a limitation of the underlying [mobile_scanner](https://pub.dev/packages/mobile_scanner) package and MLKit**
+- For critical applications, always verify scanned values and implement validation
+
+### Troubleshooting
+
+If you're getting incorrect scans:
+
+1. Move closer to the barcode
+2. Ensure the barcode is well-lit and not damaged
+3. Try different angles
+4. Clean the camera lens
+5. Check if the barcode format is supported
+
+### Scanner Crashes
+
+If the scanner crashes when opening or closing:
+
+1. **Ensure proper navigation**: Use `Navigator.of(context).pop()` in `onDetect` to close the scanner
+2. **Controller lifecycle**: The controller is automatically managed by the widget
+3. **Check permissions**: Ensure camera permissions are granted
+4. **Platform-specific issues**: Some crashes may be related to the underlying mobile_scanner package
+
+**Black Screen Issues:**
+
+- Use `canPop: true` in your navigation setup
+- Avoid calling `Navigator.of(context).pop()` manually in `if (context.mounted){}` blocks
+- Let the widget handle its own navigation lifecycle
+
+Example of proper navigation:
+
 ```dart
-import 'package:ai_barcode_scanner/ai_barcode_scanner.dart';
-
-/// Simple example of using the barcode scanner.
-AiBarcodeScanner(
-        onDetect: (BarcodeCapture barcodeCapture) {
-          debugPrint(barcodeCapture);
-        },
-      ),
-
-/// Example of using the barcode scanner with a controller.
-AiBarcodeScanner(
-        controller: MobileScannerController(
-             detectionSpeed: DetectionSpeed.noDuplicates,
-           ),
-        onDetect: (BarcodeCapture barcodeCapture) {
-          debugPrint(barcodeCapture);
-        },
-      ),
-
-/// Example of using the barcode scanner with validation.
-/// Validator works on the raw string, not the decoded value.
-/// If you want to validate the scanner, use the [validate] parameter.
-AiBarcodeScanner(
-  onDispose: () {
-    /// This is called when the barcode scanner is disposed.
-    /// You can write your own logic here.
-    debugPrint("Barcode scanner disposed!");
-  },
-  controller: MobileScannerController(
-    detectionSpeed: DetectionSpeed.noDuplicates,
-  ),
-  onDetect: (BarcodeCapture capture) {
-    /// The row string scanned barcode value
-    final String? scannedValue =
-        capture.barcodes.first.rawValue;
-
-    /// The `Uint8List` image is only available if `returnImage` is set to `true`.
-    final Uint8List? image = capture.image;
-
-    /// row data of the barcode
-    final Object? raw = capture.raw;
-
-    /// List of scanned barcodes if any
-    final List<Barcode> barcodes = capture.barcodes;
-  },
-  validator: (value) {
-    if (value.barcodes.isEmpty) {
-      return false;
-    }
-    if (!(value.barcodes.first.rawValue
-            ?.contains('flutter.dev') ??
-        false)) {
-      return false;
-    }
-    return true;
-  },
-),
+onDetect: (BarcodeCapture capture) {
+  final String? scannedValue = capture.barcodes.first.rawValue;
+  if (scannedValue != null) {
+    Navigator.of(context).pop(scannedValue); // Close scanner
+  }
+},
 ```
 
 ## Usage ([mobile_scanner](https://pub.dev/packages/mobile_scanner))
@@ -516,3 +545,9 @@ All contributions are welcome. Let's make this package better together.
 </a>
 
 Made with [contrib.rocks](https://contrib.rocks).
+
+## Windows Support
+
+**Windows is not supported.**
+
+This package depends on [mobile_scanner](https://pub.dev/packages/mobile_scanner), which does not support Windows. Attempts to use the scanner on Windows will result in an error. For more information, see the [mobile_scanner pub.dev page](https://pub.dev/packages/mobile_scanner).

example/.gitignore

@@ -5,9 +5,11 @@
 *.swp
 .DS_Store
 .atom/
+.build/
 .buildlog/
 .history
 .svn/
+.swiftpm/
 migrate_working_dir/
 
 # IntelliJ related

example/ios/Podfile.lock

@@ -1,37 +1,9 @@
 PODS:
-  - Firebase/Auth (10.3.0):
-    - Firebase/CoreOnly
-    - FirebaseAuth (~> 10.3.0)
-  - Firebase/CoreOnly (10.3.0):
-    - FirebaseCore (= 10.3.0)
-  - firebase_auth (4.2.6):
-    - Firebase/Auth (= 10.3.0)
-    - firebase_core
-    - Flutter
-  - firebase_core (2.5.0):
-    - Firebase/CoreOnly (= 10.3.0)
-    - Flutter
-  - FirebaseAuth (10.3.0):
-    - FirebaseCore (~> 10.0)
-    - GoogleUtilities/AppDelegateSwizzler (~> 7.8)
-    - GoogleUtilities/Environment (~> 7.8)
-    - GTMSessionFetcher/Core (< 4.0, >= 2.1)
-  - FirebaseCore (10.3.0):
-    - FirebaseCoreInternal (~> 10.0)
-    - GoogleUtilities/Environment (~> 7.8)
-    - GoogleUtilities/Logger (~> 7.8)
-  - FirebaseCoreInternal (10.5.0):
-    - "GoogleUtilities/NSData+zlib (~> 7.8)"
   - Flutter (1.0.0)
   - GoogleDataTransport (9.2.1):
     - GoogleUtilities/Environment (~> 7.7)
     - nanopb (< 2.30910.0, >= 2.30908.0)
     - PromisesObjC (< 3.0, >= 1.2)
-  - GoogleMLKit/BarcodeScanning (3.2.0):
-    - GoogleMLKit/MLKitCore
-    - MLKitBarcodeScanning (~> 2.2.0)
-  - GoogleMLKit/MLKitCore (3.2.0):
-    - MLKitCommon (~> 8.0.0)
   - GoogleToolboxForMac/DebugUtils (2.3.2):
     - GoogleToolboxForMac/Defines (= 2.3.2)
   - GoogleToolboxForMac/Defines (2.3.2)
@@ -44,30 +16,18 @@ PODS:
     - GoogleToolboxForMac/Defines (= 2.3.2)
     - "GoogleToolboxForMac/NSString+URLArguments (= 2.3.2)"
   - "GoogleToolboxForMac/NSString+URLArguments (2.3.2)"
-  - GoogleUtilities/AppDelegateSwizzler (7.11.0):
-    - GoogleUtilities/Environment
-    - GoogleUtilities/Logger
-    - GoogleUtilities/Network
   - GoogleUtilities/Environment (7.11.0):
     - PromisesObjC (< 3.0, >= 1.2)
   - GoogleUtilities/Logger (7.11.0):
     - GoogleUtilities/Environment
-  - GoogleUtilities/Network (7.11.0):
-    - GoogleUtilities/Logger
-    - "GoogleUtilities/NSData+zlib"
-    - GoogleUtilities/Reachability
-  - "GoogleUtilities/NSData+zlib (7.11.0)"
-  - GoogleUtilities/Reachability (7.11.0):
-    - GoogleUtilities/Logger
   - GoogleUtilities/UserDefaults (7.11.0):
     - GoogleUtilities/Logger
   - GoogleUtilitiesComponents (1.1.0):
     - GoogleUtilities/Logger
   - GTMSessionFetcher/Core (2.3.0)
+  - image_picker_ios (0.0.1):
+    - Flutter
   - MLImage (1.0.0-beta3)
-  - MLKitBarcodeScanning (2.2.0):
-    - MLKitCommon (~> 8.0)
-    - MLKitVision (~> 4.2)
   - MLKitCommon (8.0.0):
     - GoogleDataTransport (~> 9.0)
     - GoogleToolboxForMac/Logger (~> 2.1)
@@ -84,9 +44,9 @@ PODS:
     - MLImage (= 1.0.0-beta3)
     - MLKitCommon (~> 8.0)
     - Protobuf (~> 3.12)
-  - mobile_scanner (3.0.0):
+  - mobile_scanner (7.0.0):
     - Flutter
-    - GoogleMLKit/BarcodeScanning (~> 3.2.0)
+    - FlutterMacOS
   - nanopb (2.30909.0):
     - nanopb/decode (= 2.30909.0)
     - nanopb/encode (= 2.30909.0)
@@ -96,68 +56,52 @@ PODS:
   - Protobuf (3.22.0)
 
 DEPENDENCIES:
-  - firebase_auth (from `.symlinks/plugins/firebase_auth/ios`)
-  - firebase_core (from `.symlinks/plugins/firebase_core/ios`)
   - Flutter (from `Flutter`)
+  - image_picker_ios (from `.symlinks/plugins/image_picker_ios/ios`)
   - MLKitCommon (from `MLKitCommon.podspec.json`)
   - MLKitVision (from `MLKitVision.podspec.json`)
-  - mobile_scanner (from `.symlinks/plugins/mobile_scanner/ios`)
+  - mobile_scanner (from `.symlinks/plugins/mobile_scanner/darwin`)
 
 SPEC REPOS:
   trunk:
-    - Firebase
-    - FirebaseAuth
-    - FirebaseCore
-    - FirebaseCoreInternal
     - GoogleDataTransport
-    - GoogleMLKit
     - GoogleToolboxForMac
     - GoogleUtilities
     - GoogleUtilitiesComponents
     - GTMSessionFetcher
     - MLImage
-    - MLKitBarcodeScanning
     - nanopb
     - PromisesObjC
     - Protobuf
 
 EXTERNAL SOURCES:
-  firebase_auth:
-    :path: ".symlinks/plugins/firebase_auth/ios"
-  firebase_core:
-    :path: ".symlinks/plugins/firebase_core/ios"
   Flutter:
     :path: Flutter
+  image_picker_ios:
+    :path: ".symlinks/plugins/image_picker_ios/ios"
   MLKitCommon:
     :podspec: MLKitCommon.podspec.json
   MLKitVision:
     :podspec: MLKitVision.podspec.json
   mobile_scanner:
-    :path: ".symlinks/plugins/mobile_scanner/ios"
+    :path: ".symlinks/plugins/mobile_scanner/darwin"
 
 SPEC CHECKSUMS:
-  Firebase: f92fc551ead69c94168d36c2b26188263860acd9
-  firebase_auth: b196f91b4f7c6d72015c3c12aaa82eb6972b2c2c
-  firebase_core: f95c8bbe65213d406d592573ad42a12d64849cb8
-  FirebaseAuth: 0e415d29d846c1dce2fb641e46f35e9888d9bec6
-  FirebaseCore: 988754646ab3bd4bdcb740f1bfe26b9f6c0d5f2a
-  FirebaseCoreInternal: e463f41bb935cd049505bf7e9a5bdd7dcea90df6
-  Flutter: f04841e97a9d0b0a8025694d0796dd46242b2854
+  Flutter: e0871f40cf51350855a761d2e70bf5af5b9b5de7
   GoogleDataTransport: ea169759df570f4e37bdee1623ec32a7e64e67c4
-  GoogleMLKit: 0017a6a8372e1a182139b9def4d89be5d87ca5a7
   GoogleToolboxForMac: 8bef7c7c5cf7291c687cf5354f39f9db6399ad34
   GoogleUtilities: c2bdc4cf2ce786c4d2e6b3bcfd599a25ca78f06f
   GoogleUtilitiesComponents: 679b2c881db3b615a2777504623df6122dd20afe
   GTMSessionFetcher: 3a63d75eecd6aa32c2fc79f578064e1214dfdec2
+  image_picker_ios: 7fe1ff8e34c1790d6fff70a32484959f563a928a
   MLImage: 489dfec109f21da8621b28d476401aaf7a0d4ff4
-  MLKitBarcodeScanning: d92fe1911001ec36870162c5a0eb206f612b7169
   MLKitCommon: 8e5dbe4b12a434e790734211e1b00ed2db3c94ae
   MLKitVision: 7798eded05a31f1ec7be02290e146fc4a253f984
-  mobile_scanner: 004f7ad2fe4e2b5a3e6ed0bc4b83ca9c5b5dd975
+  mobile_scanner: 9157936403f5a0644ca3779a38ff8404c5434a93
   nanopb: b552cce312b6c8484180ef47159bc0f65a1f0431
   PromisesObjC: 09985d6d70fbe7878040aa746d78236e6946d2ef
   Protobuf: 5e6cbc143d02fe08585d86b0098f8b755d2caaab
 
-PODFILE CHECKSUM: 03b123506681943d03219f50e0feca4c81e97db7
+PODFILE CHECKSUM: ae7c5d48c79591186378fc9a3403ad923b66b876
 
-COCOAPODS: 1.11.3
+COCOAPODS: 1.16.2