@capgo/capacitor-document-scanner 8.3.2 → 8.3.4

package/android/src/main/java/app/capgo/plugin/document_scanner/DocumentScannerPlugin.java

@@ -10,6 +10,7 @@ import android.graphics.ColorMatrix;
 import android.graphics.ColorMatrixColorFilter;
 import android.graphics.Paint;
 import android.net.Uri;
+import android.os.Build;
 import android.util.Base64;
 import androidx.activity.result.ActivityResult;
 import androidx.activity.result.ActivityResultLauncher;
@@ -92,6 +93,16 @@ public class DocumentScannerPlugin extends Plugin {
             return;
         }
 
+        // Check if running on emulator
+        if (isRunningOnEmulator()) {
+            call.reject(
+                "Document scanner is not supported on Android emulators. " +
+                    "The ML Kit Document Scanner requires a physical device with a hardware camera. " +
+                    "Please test on a real Android device."
+            );
+            return;
+        }
+
         Activity activity = getActivity();
         if (activity == null) {
             call.reject("Activity reference is unavailable.");
@@ -393,6 +404,33 @@ public class DocumentScannerPlugin extends Plugin {
         }
     }
 
+    /**
+     * Detects if the app is running on an Android emulator.
+     * Uses multiple heuristics to reliably detect emulator environments.
+     * @return true if running on an emulator, false otherwise
+     */
+    private boolean isRunningOnEmulator() {
+        String model = Build.MODEL.toLowerCase(Locale.ROOT);
+        String product = Build.PRODUCT.toLowerCase(Locale.ROOT);
+        String fingerprint = Build.FINGERPRINT.toLowerCase(Locale.ROOT);
+        String manufacturer = Build.MANUFACTURER.toLowerCase(Locale.ROOT);
+        String brand = Build.BRAND.toLowerCase(Locale.ROOT);
+        String device = Build.DEVICE.toLowerCase(Locale.ROOT);
+
+        return (
+            fingerprint.startsWith("generic") ||
+            fingerprint.startsWith("unknown") ||
+            model.contains("google_sdk") ||
+            model.contains("emulator") ||
+            model.contains("android sdk built for x86") ||
+            manufacturer.contains("genymotion") ||
+            (brand.startsWith("generic") && device.startsWith("generic")) ||
+            "google_sdk".equals(product) ||
+            product.contains("sdk_gphone") ||
+            product.contains("emulator")
+        );
+    }
+
     @PluginMethod
     public void getPluginVersion(final PluginCall call) {
         try {

package/ios/Sources/DocumentScannerPlugin/DocumentScannerPlugin.swift

@@ -3,7 +3,7 @@ import Foundation
 
 @objc(DocumentScannerPlugin)
 public class DocumentScannerPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.3.2"
+    private let pluginVersion: String = "8.3.4"
     public let identifier = "DocumentScannerPlugin"
     public let jsName = "DocumentScanner"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-document-scanner",
-  "version": "8.3.2",
+  "version": "8.3.4",
   "description": "Capacitor plugin to scan document iOS and Android",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",