anyline-ocr-react-native-module 43.0.1 → 44.1.0

package/android/build.gradle

@@ -69,8 +69,16 @@ repositories {
 
 dependencies {
     implementation fileTree(dir: "libs", include: ["*.jar"])
-    implementation 'io.anyline:anylinesdk:43.1.0'
+    implementation 'io.anyline:anylinesdk:44.1.0'
     implementation "com.facebook.react:react-native:+"  // from node_modules
     implementation("com.google.android.material:material:1.4.0-rc01")
     implementation 'androidx.multidex:multidex:2.0.1'
+    constraints {
+        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.0") {
+            because("kotlin-stdlib-jdk7 is now a part of kotlin-stdlib")
+        }
+        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.0") {
+            because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
+        }
+    }
 }

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Thu Aug 17 14:31:23 CEST 2017
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-bin.zip
+networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip

package/android/gradlew

@@ -1,74 +1,129 @@
-#!/usr/bin/env bash
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
 
 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################
 
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS=""
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
 
-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum
 
-warn ( ) {
+warn () {
     echo "$*"
-}
+} >&2
 
-die ( ) {
+die () {
     echo
     echo "$*"
     echo
     exit 1
-}
+} >&2
 
 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac
 
-# Attempt to set APP_HOME
-# Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
-done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
-
 CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
 
+
 # Determine the Java command to use to start the JVM.
 if [ -n "$JAVA_HOME" ] ; then
     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
         # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
     else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
     fi
     if [ ! -x "$JAVACMD" ] ; then
         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -77,7 +132,7 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
     fi
 else
-    JAVACMD="java"
+    JAVACMD=java
     which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
@@ -85,76 +140,105 @@ location of your Java installation."
 fi
 
 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC3045 
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC3045 
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
 fi
 
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
 
-# For Cygwin, switch paths to Windows format before running java
-if $cygwin ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
     # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
         fi
-        i=$((i+1))
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
     done
-    case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
-    esac
 fi
 
-# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules
-function splitJvmOpts() {
-    JVM_OPTS=("$@")
-}
-eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS
-JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME"
+# Collect all arguments for the java command;
+#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+#     shell script including quotes and variable substitutions, so put them in
+#     double quotes to make sure that they get re-expanded; and
+#   * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
 
-exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@"
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

package/android/gradlew.bat

@@ -14,7 +14,7 @@
 @rem limitations under the License.
 @rem
 
-@if "%DEBUG%" == "" @echo off
+@if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
 @rem  Gradle startup script for Windows
@@ -25,7 +25,8 @@
 if "%OS%"=="Windows_NT" setlocal
 
 set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 
@@ -40,7 +41,7 @@ if defined JAVA_HOME goto findJavaFromJavaHome
 
 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto execute
+if %ERRORLEVEL% equ 0 goto execute
 
 echo.
 echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
@@ -75,15 +76,17 @@ set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
 
 :end
 @rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
+if %ERRORLEVEL% equ 0 goto mainEnd
 
 :fail
 rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
 rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
 
 :mainEnd
 if "%OS%"=="Windows_NT" endlocal
 
-:omega
+:omega

package/android/src/main/java/com/anyline/reactnative/FeedbackConfig.java

@@ -0,0 +1,58 @@
+package com.anyline.reactnative;
+
+import android.content.Context;
+
+import org.json.JSONObject;
+
+import java.io.IOException;
+
+import io.anyline.util.SoundUtil;
+
+public class FeedbackConfig {
+    private SoundUtil soundUtil;
+    public ImageTextConfig wrongFormat = null;
+    public ImageTextConfig brightnessTooHigh = null;
+    public ImageTextConfig brightnessTooLow = null;
+    public ImageTextConfig distance = null;
+    public String sound = null;
+
+    public FeedbackConfig(Context context, JSONObject jsonObject) {
+        if (jsonObject.has("format")) {
+            wrongFormat = new ImageTextConfig(context, jsonObject.optJSONObject("format"));
+        }
+
+        if (jsonObject.has("distance")) {
+            distance = new ImageTextConfig(context, jsonObject.optJSONObject("distance"));
+        }
+
+        if (jsonObject.has("brightness")) {
+            JSONObject jsonBrightness = jsonObject.optJSONObject("brightness");
+            if (jsonBrightness.has("too_high")) {
+                brightnessTooHigh = new ImageTextConfig(context, jsonBrightness.optJSONObject("too_high"));
+            }
+            if (jsonBrightness.has("too_low")) {
+                brightnessTooLow = new ImageTextConfig(context, jsonBrightness.optJSONObject("too_low"));
+            }
+        }
+
+        if (jsonObject.has("sound")) {
+            sound = jsonObject.optString("sound", "");
+            soundUtil = new SoundUtil(context);
+            try {
+                soundUtil.loadSoundFromAssets(sound);
+            } catch (IOException e) {
+                soundUtil = null;
+            }
+        }
+
+    }
+
+    public void playBeepSound() {
+        if (sound != null) {
+            if (soundUtil != null) {
+                soundUtil.playSound(sound);
+            }
+        }
+    }
+
+}

package/android/src/main/java/com/anyline/reactnative/ImageTextConfig.java

@@ -0,0 +1,48 @@
+package com.anyline.reactnative;
+
+import android.content.Context;
+import android.content.res.AssetManager;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.util.Log;
+
+import org.json.JSONObject;
+
+import java.io.IOException;
+import java.io.InputStream;
+
+public class ImageTextConfig {
+    public String text = null;
+    public boolean hasImage = false;
+    public int imageResId = 0;
+
+    public ImageTextConfig(Context context, JSONObject jsonObject) {
+        if (jsonObject.has("text")) {
+            text = jsonObject.optString("text", "");
+        }
+
+        if (jsonObject.has("image")) {
+            imageResId = context.getResources().getIdentifier(jsonObject.optString("image", ""),
+                    "drawable",
+                    context.getPackageName());
+            hasImage = true;
+        }
+    }
+
+    protected Bitmap getBitmapFromAsset(Context context, String filePath) {
+        AssetManager assetManager = context.getAssets();
+
+        InputStream inputStream;
+        Bitmap bitmap = null;
+        try {
+            inputStream = assetManager.open(filePath);
+            bitmap = BitmapFactory.decodeStream(inputStream);
+            inputStream.close();
+        } catch (IOException e) {
+            Log.e("ImageTextConfig", e.getMessage());
+        }
+
+        return bitmap;
+    }
+
+}

package/android/src/main/java/com/anyline/reactnative/InstructionConfig.java

@@ -0,0 +1,19 @@
+package com.anyline.reactnative;
+
+import org.json.JSONObject;
+
+public class InstructionConfig {
+    public String text = null;
+    public String textColor = null;
+    public String backgroundColor = null;
+
+    public InstructionConfig(JSONObject jsonObject) {
+        text = jsonObject.optString("text", "");
+        if (jsonObject.has("textColor")) {
+            textColor = jsonObject.optString("textColor", "");
+        }
+        if (jsonObject.has("backgroundColor")) {
+            backgroundColor = jsonObject.optString("backgroundColor", "");
+        }
+    }
+}

package/android/src/main/java/com/anyline/reactnative/ScanActivity.java

@@ -6,9 +6,16 @@ import static com.anyline.reactnative.AnylineSDKPlugin.RESULT_ERROR;
 
 import android.content.Intent;
 import android.content.pm.ActivityInfo;
+import android.graphics.Bitmap;
+import android.graphics.Color;
+import android.graphics.Rect;
 import android.os.Bundle;
-import android.view.Gravity;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Pair;
 import android.view.View;
+import android.view.Gravity;
+import android.util.Log;
 
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -21,14 +28,21 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
+import java.io.IOException;
+import java.util.Timer;
+import java.util.TimerTask;
+
 import io.anyline2.ScanResult;
+import io.anyline2.view.BrightnessHelper;
 import io.anyline2.view.ScanView;
+import io.anyline2.viewplugin.ScanViewPlugin;
 import io.anyline2.viewplugin.ViewPluginBase;
 
 public class ScanActivity extends AppCompatActivity {
 
     private static final String KEY_DEFAULT_ORIENTATION_APPLIED = "default_orientation_applied";
 
+    private Handler handler = new Handler(Looper.getMainLooper());
     private ActivityScanBinding binding;
     private ScanView scanView;
 
@@ -36,6 +50,21 @@ public class ScanActivity extends AppCompatActivity {
     private boolean defaultOrientationApplied;
     private int orientation;
 
+    private InstructionConfig instructionConfig = null;
+    private ImageTextConfig imageCutoutConfig = null;
+    private FeedbackConfig feedbackConfig = null;
+
+    private long cleanUIFeedbackIntervalMills = 2000L;
+    private Timer cleanUIFeedbackTimer = null;
+
+    private static final String FEEDBACK_SCANINFO_LIGHTINGCONDITION = "$lightingCondition";
+    private static final String FEEDBACK_SCANINFO_LIGHTINGCONDITION_TOODARK = "TOODARK";
+    private static final String FEEDBACK_SCANINFO_LIGHTINGCONDITION_TOOBRIGHT = "TOOBRIGHT";
+    private static final int FEEDBACK_RUNSKIPPED_WRONGFORMAT = 5006;
+    private static final int FEEDBACK_RUNSKIPPED_WRONGDATE = 5027;
+    private static final int FEEDBACK_RUNSKIPPED_TOOCLOSE = 5023;
+    private static final int FEEDBACK_RUNSKIPPED_TOOFAR = 5024;
+
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
@@ -59,11 +88,47 @@ public class ScanActivity extends AppCompatActivity {
 
                 applyDefaultOrientation(configJSON);
                 setupChangeOrientationButton(configJSON);
+                setupCustomUIFeedback(configJSON);
 
                 scanView.init(configJSON);
 
                 ViewPluginBase viewPluginBase = scanView.getScanViewPlugin();
 
+                viewPluginBase.scanInfoReceived = jsonObject -> {
+                    if (jsonObject.optString("name", "").equals(FEEDBACK_SCANINFO_LIGHTINGCONDITION)) {
+                        String lightingConditionValue = jsonObject.optString("value", "");
+                        if (feedbackConfig != null) {
+                            if (lightingConditionValue.equalsIgnoreCase(FEEDBACK_SCANINFO_LIGHTINGCONDITION_TOODARK)) {
+                                if (feedbackConfig.brightnessTooLow != null) {
+                                    updateUIFeedback(feedbackConfig.brightnessTooLow);
+                                }
+                            }
+                            else if (lightingConditionValue.equalsIgnoreCase(FEEDBACK_SCANINFO_LIGHTINGCONDITION_TOOBRIGHT)) {
+                                if (feedbackConfig.brightnessTooHigh != null) {
+                                    updateUIFeedback(feedbackConfig.brightnessTooHigh);
+                                }
+                            }
+                        }
+                    }
+                };
+
+                viewPluginBase.runSkippedReceived = jsonObject -> {
+                    if (feedbackConfig != null) {
+                        if (jsonObject.optInt("code", 0) == FEEDBACK_RUNSKIPPED_WRONGFORMAT
+                                || jsonObject.optInt("code", 0) == FEEDBACK_RUNSKIPPED_WRONGDATE) {
+                            if (feedbackConfig.wrongFormat != null) {
+                                updateUIFeedback(feedbackConfig.wrongFormat);
+                            }
+                        }
+                        if (jsonObject.optInt("code", 0) == FEEDBACK_RUNSKIPPED_TOOCLOSE
+                                || jsonObject.optInt("code", 0) == FEEDBACK_RUNSKIPPED_TOOFAR) {
+                            if (feedbackConfig.distance != null) {
+                                updateUIFeedback(feedbackConfig.distance);
+                            }
+                        }
+                    }
+                };
+
                 viewPluginBase.resultReceived = scanResult -> {
                     setResult(AnylineSDKPlugin.RESULT_OK);
                     JSONObject resultObject = getResultWithImagePath(scanResult);
@@ -157,6 +222,120 @@ public class ScanActivity extends AppCompatActivity {
         }
     }
 
+    private void setupCustomUIFeedback(JSONObject configJSON) {
+        JSONObject optionsJsonObject = configJSON.optJSONObject("options");
+        if (optionsJsonObject != null) {
+            try {
+                if (optionsJsonObject.has("instruction")) {
+                    instructionConfig = new InstructionConfig(optionsJsonObject.getJSONObject("instruction"));
+                }
+                if (optionsJsonObject.has("imageCutout")) {
+                    imageCutoutConfig = new ImageTextConfig(this, optionsJsonObject.getJSONObject("imageCutout"));
+                }
+                if (optionsJsonObject.has("feedback")) {
+                    feedbackConfig = new FeedbackConfig(this, optionsJsonObject.getJSONObject("feedback"));
+                }
+            }
+            catch (JSONException e) {
+                finishWithError("Error setting up UI Feedback: " + e.getMessage());
+                return;
+            }
+
+            if (instructionConfig != null) {
+                if (instructionConfig.text != null) {
+                    binding.textviewInstruction.setText(instructionConfig.text);
+                }
+                if (instructionConfig.textColor != null) {
+                    binding.textviewInstruction.setTextColor(Color.parseColor("#" + instructionConfig.textColor));
+                }
+                if (instructionConfig.backgroundColor != null) {
+                    binding.textviewInstruction.setBackgroundColor(Color.parseColor("#" + instructionConfig.backgroundColor));
+                }
+            }
+
+            if (imageCutoutConfig != null) {
+                if (imageCutoutConfig.hasImage) {
+                    binding.imageviewCutoutOverlay.setImageResource(imageCutoutConfig.imageResId);
+                }
+            }
+
+        }
+
+        scanView.onCutoutChanged = cutouts -> {
+            Pair<ScanViewPlugin, android.graphics.Rect> firstCutout = cutouts.get(0);
+
+            ScanViewPlugin scanViewPlugin = firstCutout.first;
+            if (scanViewPlugin != null) {
+                Rect rect = firstCutout.second;
+                if (rect != null) {
+                    if (instructionConfig != null) {
+                        CoordinatorLayout.LayoutParams instructionLayoutParams =
+                                new CoordinatorLayout.LayoutParams(rect.width(), rect.top);
+                        instructionLayoutParams.setMargins(rect.left, 0, rect.right, rect.top);
+                        binding.layoutInstruction.setVisibility(View.VISIBLE);
+                        binding.layoutInstruction.setLayoutParams(instructionLayoutParams);
+                        binding.layoutInstruction.requestLayout();
+                    }
+
+                    if (imageCutoutConfig != null) {
+                        CoordinatorLayout.LayoutParams imageCutoutLayoutParams =
+                                new CoordinatorLayout.LayoutParams(rect.width(), rect.height());
+                        imageCutoutLayoutParams.setMargins(rect.left, rect.top, rect.right, rect.bottom);
+                        binding.imageviewCutoutOverlay.setVisibility(View.VISIBLE);
+                        binding.imageviewCutoutOverlay.setLayoutParams(imageCutoutLayoutParams);
+                        binding.imageviewCutoutOverlay.requestLayout();
+                    }
+
+                    if (feedbackConfig != null) {
+                        CoordinatorLayout.LayoutParams feedbackLayoutParams =
+                                new CoordinatorLayout.LayoutParams(rect.width(), scanView.getHeight());
+                        feedbackLayoutParams.setMargins(rect.left, rect.bottom, rect.right, scanView.getBottom());
+                        binding.layoutBrightDistanceFeedback.setVisibility(View.VISIBLE);
+                        binding.layoutBrightDistanceFeedback.setLayoutParams(feedbackLayoutParams);
+                        binding.layoutBrightDistanceFeedback.requestLayout();
+                    }
+                }
+            }
+        };
+    }
+
+    private void updateUIFeedback(ImageTextConfig imageTextFeedback) {
+        if (imageTextFeedback.text != null) {
+            if (binding.textviewBrightDistanceFeedback.getText().equals(imageTextFeedback.text)) {
+                return;
+            }
+        }
+
+        handler.post(() -> {
+            if (imageTextFeedback.text != null) {
+                binding.textviewBrightDistanceFeedback.setText(imageTextFeedback.text);
+            }
+            if (imageTextFeedback.hasImage) {
+                binding.imageviewBrightDistanceFeedback.setImageResource(imageTextFeedback.imageResId);
+            }
+
+            if (feedbackConfig != null) {
+                if (feedbackConfig.sound != null) {
+                    feedbackConfig.playBeepSound();
+                }
+            }
+
+            if (cleanUIFeedbackTimer != null) {
+                cleanUIFeedbackTimer.cancel();
+            }
+            cleanUIFeedbackTimer = new Timer();
+            cleanUIFeedbackTimer.schedule(new TimerTask() {
+                @Override
+                public void run() {
+                    handler.post(() -> {
+                        binding.textviewBrightDistanceFeedback.setText("");
+                        binding.imageviewBrightDistanceFeedback.setImageBitmap(null);
+                    });
+                }
+            }, cleanUIFeedbackIntervalMills);
+        });
+    }
+
     @NonNull
     private JSONObject getResultWithImagePath(ScanResult scanResult) {
         JSONObject resultObject = scanResult.getResult();

package/android/src/main/res/layout/activity_scan.xml

@@ -18,10 +18,61 @@
         android:padding="40px">
         <ImageView
             android:id="@+id/imageview_change_orientation"
-            android:layout_width="40dp"
-            android:layout_height="40dp"
+            android:layout_width="56dp"
+            android:layout_height="56dp"
             android:scaleType="fitStart"
             android:background="@drawable/rotate_screen_background"
             android:src="@drawable/rotate_screen_white" />
     </LinearLayout>
+
+    <LinearLayout
+        android:id="@+id/layout_instruction"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:visibility="gone"
+        android:layout_gravity="bottom"
+        android:gravity="bottom"
+        android:layout_marginVertical="30dp"
+        android:paddingBottom="30dp"
+        android:orientation="vertical">
+        <TextView
+            android:id="@+id/textview_instruction"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:gravity="bottom|center_horizontal"
+            android:padding="10dp"
+            android:text=""
+            android:textColor="@color/white"
+            android:textSize="14sp" />
+    </LinearLayout>
+
+    <LinearLayout
+        android:id="@+id/layout_bright_distance_feedback"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:visibility="gone"
+        android:layout_centerHorizontal="true"
+        android:gravity="center_horizontal"
+        android:paddingTop="100px"
+        android:orientation="vertical">
+        <ImageView
+            android:id="@+id/imageview_bright_distance_feedback"
+            android:layout_width="50dp"
+            android:layout_height="50dp"
+            android:layout_marginVertical="5dp" />
+        <TextView
+            android:id="@+id/textview_bright_distance_feedback"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text=""
+            android:textColor="@color/white"
+            android:textSize="14sp" />
+    </LinearLayout>
+
+    <ImageView
+        android:id="@+id/imageview_cutout_overlay"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:visibility="gone"
+        android:scaleType="fitStart" />
 </androidx.coordinatorlayout.widget.CoordinatorLayout>

package/ios/ALJsonUIConfiguration.m

@@ -57,7 +57,9 @@ NSString * const ENABLE_NATIVE_BARCODE = @"nativeBarcodeScanningFormats";
         _labelXPositionOffset = 0.0f;
         _labelYPositionOffset = 0.0f;
 
-        _nativeBarcodeFormats = @[];
+        // (ACO) 20230313
+        // nativeBarcodeFormats = [] would be interpreted as ['ALL']
+        _nativeBarcodeFormats = nil;
 
         if ([dictionary valueForKey:ENABLE_NATIVE_BARCODE]) {
             NSArray<NSString *> *formats = [dictionary valueForKey:ENABLE_NATIVE_BARCODE];

package/ios/ALNFCScanViewController.m

@@ -21,11 +21,6 @@ API_AVAILABLE(ios(13.0))
 // the result from NFC scanning is retained while NFC reading is initiated, and the results aggregated later
 @property (nonatomic, strong) NSMutableDictionary *resultDict;
 
-// TODO: make sure the following use the `options` group in the uiConfig
-// BOOL showingLabel
-// UILabel scannedLabel
-// ALRoundedView
-// Segment
 @property (nonatomic, strong) ALJSONUIConfiguration *uiConfig;
 
 @property (nonatomic, strong) UIView *hintView;
@@ -48,9 +43,6 @@ API_AVAILABLE(ios(13.0))
 
 @property (nonatomic, strong) NSMutableArray<NSDictionary *> *detectedBarcodes;
 
-// not used
-@property (nonatomic, strong) NSString *cropAndTransformErrorMessage;
-
 // JPEG compression quality 0-100
 @property (nonatomic, assign) NSUInteger quality;
 
@@ -71,7 +63,6 @@ API_AVAILABLE(ios(13.0))
         _uiConfig = uiConfig;
         
         self.quality = 90;
-        self.cropAndTransformErrorMessage = @"";
     }
     return self;
 }
@@ -245,7 +236,6 @@ API_AVAILABLE(ios(13.0))
     }
 
     NSObject<ALScanViewPluginBase> *scanViewPluginBase = self.scanView.scanViewPlugin;
-    // TODO: handle this for composites: cancelOnResult = true? dismiss
     if ([scanViewPluginBase isKindOfClass:ALScanViewPlugin.class]) {
         ALScanViewPlugin *scanViewPlugin = (ALScanViewPlugin *)scanViewPluginBase;
         BOOL cancelOnResult = scanViewPlugin.scanPlugin.scanPluginConfig.cancelOnResult;

package/ios/ALPluginHelper.m

@@ -4,7 +4,7 @@
 #import <objc/runtime.h>
 
 // Predefined domain for errors from most AppKit and Foundation APIs.
-NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
+NSErrorDomain const ALDefaultDomain = @"ALDefaultErrorDomain";
 
 @implementation ALPluginHelper
 
@@ -51,16 +51,10 @@ NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
                                                                                                       uiConfiguration:jsonUIConf
                                                                                                              finished:callback];
         
-        // TODO: should remove these extras
         if ([pluginConf valueForKey:@"quality"]){
             pluginScanViewController.quality = [[pluginConf valueForKey:@"quality"] integerValue];
         }
         
-        if ([pluginConf valueForKey:@"cropAndTransformErrorMessage"]) {
-            NSString *str = [pluginConf objectForKey:@"cropAndTransformErrorMessage"];
-            pluginScanViewController.cropAndTransformErrorMessage = str;
-        }
-
         if (pluginScanViewController) {
             [pluginScanViewController setModalPresentationStyle:UIModalPresentationFullScreen];
             [[[UIApplication sharedApplication] keyWindow].rootViewController presentViewController:pluginScanViewController
@@ -264,21 +258,6 @@ NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
 }
 
 #pragma mark - Date Parsing Utils
-//
-//+ (NSString *)stringForDate:(NSDate *)date {
-//    if (!date) {
-//        return nil;
-//    }
-//    
-//    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
-//    [dateFormatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"UTC+0:00"]];
-//    [dateFormatter setDateFormat:@"EEE MMM d hh:mm:ss ZZZZ yyyy"];
-//    
-//    //Date will be formatted to string - e.g.: "Fri Jan 11 12:00:00 GMT+0:00 1980"
-//    NSString *dateString = [dateFormatter stringFromDate:date];
-//    
-//    return dateString;
-//}
 
 // MARK: Utilities
 
@@ -321,7 +300,7 @@ NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
 }
 
 + (NSError *)errorWithMessage:(NSString *)message {
-    return [NSError errorWithDomain:ALFlutterDomain code:1000 userInfo:@{ NSLocalizedDescriptionKey: message }];
+    return [NSError errorWithDomain:ALDefaultDomain code:1000 userInfo:@{ NSLocalizedDescriptionKey: message }];
 }
 
 // MARK: - Date Utils
@@ -373,5 +352,12 @@ NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
     return nil;
 }
 
+// MARK: - Miscellaneous
+
+// actual implementation are in the view controllers
+- (void)segmentChange:(id)segment {}
+
+- (void)doneButtonPressed:(id)doneButton {}
+
 
 @end

package/ios/ALPluginScanViewController.h

@@ -5,8 +5,6 @@ NS_ASSUME_NONNULL_BEGIN
 
 @interface ALPluginScanViewController : UIViewController
 
-@property (nonatomic, strong) NSString *cropAndTransformErrorMessage;
-
 @property (nonatomic, assign) NSUInteger quality;
 
 - (instancetype)initWithLicensekey:(NSString *)licenseKey

package/ios/ALPluginScanViewController.m

@@ -55,7 +55,6 @@
         _uiConfig = JSONUIConfig;
         
         self.quality = 100;
-        self.cropAndTransformErrorMessage = @"";
     }
     return self;
 }

package/ios/AnylineReact.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.source       = { :git => "https://github.com/Anyline/anyline-ocr-react-native-module.git", :tag => "#{s.version}" }
 
   s.source_files  = "*.{h,m}"
-  s.dependency "Anyline", "~> 43.0.0"
+  s.dependency "Anyline", "~> 44.1.0"
   s.dependency "React"
 
-end
+end

package/ios/AnylineSDKPlugin.m

@@ -66,8 +66,7 @@ RCT_EXPORT_METHOD(getSDKVersion:(RCTPromiseResolveBlock)resolve rejecter:(RCTPro
    resolve(AnylineSDK.versionNumber);
 }
 
-
--(void)initView:(NSString *)scanMode {
+- (void)initView:(NSString *)scanMode {
     NSData *data = [self.config dataUsingEncoding:NSUTF8StringEncoding];
     if(!data) {
       [NSException raise:@"Config could not be loaded from disk" format:@"Config could not be loaded from disk"];

package/package.json

@@ -1,6 +1,6 @@
 {
-  "_from": "anyline-ocr-react-native-module@^43.0.1",
-  "_id": "anyline-ocr-react-native-module@^43.0.1",
+  "_from": "anyline-ocr-react-native-module@^44.1.0",
+  "_id": "anyline-ocr-react-native-module@^44.1.0",
   "_inBundle": false,
   "_integrity": "sha512-BGi9zNkSsoxXywDBIqzgBRvKUBniQOJHDKBrozZubKthZNRBAj8Ry5tW0Me0yLXt/fauME//hbC0wsenfPJZqw==",
   "_location": "/anyline-ocr-react-native-module",
@@ -8,19 +8,19 @@
   "_requested": {
     "type": "range",
     "registry": true,
-    "raw": "anyline-ocr-react-native-module@^43.0.1",
+    "raw": "anyline-ocr-react-native-module@^44.1.0",
     "name": "anyline-ocr-react-native-module",
     "escapedName": "anyline-ocr-react-native-module",
-    "rawSpec": "^43.0.1",
+    "rawSpec": "^44.1.0",
     "saveSpec": null,
-    "fetchSpec": "^43.0.1"
+    "fetchSpec": "^44.1.0"
   },
   "_requiredBy": [
     "/"
   ],
-  "_resolved": "https://registry.npmjs.org/anyline-ocr-react-native-module/-/anyline-ocr-react-native-module-43.0.1.tgz",
+  "_resolved": "https://registry.npmjs.org/anyline-ocr-react-native-module/-/anyline-ocr-react-native-module-44.1.0.tgz",
   "_shasum": "bacbcd260cc662244f59393ed81a6edba009b52c",
-  "_spec": "anyline-ocr-react-native-module@^43.0.1",
+  "_spec": "anyline-ocr-react-native-module@^44.1.0",
   "_where": "/Users/amiransari/Projects/anyline-ocr-react-native-module1/example/RNExampleApp",
   "bugs": {
     "url": "https://github.com/Anyline/anyline-ocr-react-native-module/issues"
@@ -47,5 +47,5 @@
     "type": "git",
     "url": "git+https://github.com/Anyline/anyline-ocr-react-native-module.git"
   },
-  "version": "43.0.1"
+  "version": "44.1.0"
 }