@capgo/capacitor-document-scanner 8.3.3 → 8.3.5

package/README.md

@@ -11,6 +11,17 @@ Capacitor plugin to scan document iOS and Android
 
 The most complete doc is available here: https://capgo.app/docs/plugins/document-scanner/
 
+## Compatibility
+
+| Plugin version | Capacitor compatibility | Maintained |
+| -------------- | ----------------------- | ---------- |
+| v8.\*.\*       | v8.\*.\*                | ✅          |
+| v7.\*.\*       | v7.\*.\*                | On demand   |
+| v6.\*.\*       | v6.\*.\*                | ❌          |
+| v5.\*.\*       | v5.\*.\*                | ❌          |
+
+> **Note:** The major version of this plugin follows the major version of Capacitor. Use the version that matches your Capacitor installation (e.g., plugin v8 for Capacitor 8). Only the latest major version is actively maintained.
+
 ## Install
 
 ```bash

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.3"
+    private let pluginVersion: String = "8.3.5"
     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.3",
+  "version": "8.3.5",
   "description": "Capacitor plugin to scan document iOS and Android",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",