@regulaforensics/react-native-document-reader-api 6.9.1 → 7.1.0

package/android/src/main/java/com/regula/documentreader/Utils.kt

@@ -0,0 +1,256 @@
+//
+//  Utils.java
+//  DocumentReader
+//
+//  Created by Pavel Masiuk on 21.09.2023.
+//  Copyright © 2023 Regula. All rights reserved.
+//
+@file:Suppress("UNCHECKED_CAST")
+
+package com.regula.documentreader
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.graphics.Canvas
+import android.graphics.Matrix
+import android.graphics.Paint
+import android.graphics.Typeface
+import android.graphics.drawable.BitmapDrawable
+import android.graphics.drawable.Drawable
+import android.util.Base64
+import com.regula.documentreader.api.enums.CustomizationFont
+import com.regula.documentreader.api.params.ParamsCustomization
+import org.json.JSONArray
+import org.json.JSONObject
+import java.io.ByteArrayOutputStream
+import kotlin.math.sqrt
+
+fun Any?.toSendable(): Any? = this?.let {
+    if (this is JSONObject || this is JSONArray) this.toString()
+    else this
+}
+
+fun arrayListToJSONArray(list: ArrayList<*>): JSONArray {
+    val result = JSONArray()
+    for (i in list.indices) {
+        when {
+            list[i] == null -> result.put(null)
+            list[i].javaClass == HashMap::class.java -> result.put(hashMapToJSONObject(list[i] as HashMap<String, *>))
+            list[i].javaClass == ArrayList::class.java -> result.put(arrayListToJSONArray(list[i] as ArrayList<*>))
+            else -> result.put(list[i])
+        }
+    }
+    return result
+}
+
+fun hashMapToJSONObject(map: HashMap<String, *>): JSONObject {
+    val result = JSONObject()
+    for ((key, value) in map) {
+        when {
+            value == null -> result.put(key, null)
+            value.javaClass == HashMap::class.java -> result.put(key, hashMapToJSONObject(value as HashMap<String, *>))
+            value.javaClass == ArrayList::class.java -> result.put(key, arrayListToJSONArray(value as ArrayList<*>))
+            else -> result.put(key, value)
+        }
+    }
+    return result
+}
+
+fun <T> generateList(list: List<T>?) = list?.let {
+    val result = JSONArray()
+    for (t in list) if (t != null) result.put(t)
+    result
+}
+
+fun <T> generateList(list: List<T>, toJson: (T?) -> JSONObject?): JSONArray {
+    val result = JSONArray()
+    for (t in list) if (t != null) result.put(toJson(t))
+    return result
+}
+
+fun <T> listFromJSON(input: JSONArray?, fromJson: (JSONObject?) -> T) = input?.let {
+    val result: MutableList<T> = ArrayList()
+    for (i in 0 until input.length()) {
+        val item = input.getJSONObject(i)
+        result.add(fromJson(item))
+    }
+    result
+}
+
+fun <T> listFromJSON(input: JSONArray): List<T> {
+    val result: MutableList<T> = ArrayList()
+    for (i in 0 until input.length()) result.add(input.opt(i) as T)
+    return result
+}
+
+fun <T> arrayFromJSON(input: JSONArray?, fromJson: (JSONObject?) -> T, result: Array<T>) = input?.let {
+    for (i in 0 until input.length())
+        result[i] = fromJson(input.getJSONObject(i))
+    result
+}
+
+fun <T> generateList(list: List<T>, toJson: (T?, Context?) -> JSONObject?, context: Context?): JSONArray {
+    val result = JSONArray()
+    for (t in list) if (t != null) result.put(toJson(t, context))
+    return result
+}
+
+fun <T> generateArray(array: Array<T>?) = array?.let {
+    val result = JSONArray()
+    for (i in array.indices) result.put(i, array[i])
+    result
+}
+
+fun <T> generateArray(array: Array<T>?, toJson: (T?) -> JSONObject?) = array?.let {
+    val result = JSONArray()
+    for (i in array.indices) result.put(i, toJson(array[i]))
+    result
+}
+
+fun generateLongArray(array: LongArray?) = array?.let {
+    val result = JSONArray()
+    for (i in array.indices) result.put(i, array[i])
+    result
+}
+
+fun stringListFromJson(jsonArray: JSONArray): List<String> {
+    val result: MutableList<String> = ArrayList()
+    for (i in 0 until jsonArray.length()) result.add(jsonArray.optString(i))
+    return result
+}
+
+fun stringArrayFromJson(jsonArray: JSONArray): Array<String?> {
+    val result = arrayOfNulls<String>(jsonArray.length())
+    for (i in 0 until jsonArray.length()) result[i] = jsonArray.optString(i)
+    return result
+}
+
+fun paintCapToInt(cap: Paint.Cap) = when (cap) {
+    Paint.Cap.BUTT -> 0
+    Paint.Cap.ROUND -> 1
+    Paint.Cap.SQUARE -> 2
+}
+
+fun JSONObject.forEach(action: (String, Any?) -> Unit) {
+    val keys: Iterator<String> = keys()
+    while (keys.hasNext()) {
+        val key = keys.next()
+        action(key, get(key))
+    }
+}
+
+fun Map<String, Any?>.toJsonObject(): JSONObject {
+    val result = JSONObject()
+    forEach { (key, value) -> result.put(key, value) }
+    return result
+}
+
+fun stringMapFromJson(input: JSONObject): Map<String, String> {
+    val result: MutableMap<String, String> = HashMap()
+    input.forEach { key, value -> result[key] = value as String }
+    return result
+}
+
+fun generateStringMap(input: Map<String, String?>?) = input?.let {
+    val result = JSONObject()
+    for ((key, value) in input) result.put(key, value)
+    result
+}
+
+fun Any?.toInt() = when (this) {
+    is Double -> toInt()
+    is Long -> toInt()
+    else -> this as Int
+}
+
+fun Any?.toLong() = when (this) {
+    is Double -> toLong()
+    is Int -> toLong()
+    else -> this as Long
+}
+
+fun Any?.toColor() = "#" + toLong().toString(16)
+
+fun Any?.toFloat() =
+    if (this is Double) toFloat()
+    else this as Float
+
+fun Any?.toMatrix() = this?.let {
+    val matrix = Matrix()
+    val result = FloatArray((this as JSONArray).length())
+    for (i in 0 until length()) result[i] = getDouble(i).toFloat()
+    matrix.setValues(result)
+    matrix
+}
+
+fun Any?.toIntArray() = (this as JSONArray?)?.let {
+    val result = IntArray(it.length())
+    for (i in 0 until it.length()) result[i] = it.getInt(i)
+    result
+}
+
+fun IntArray?.generate() = this?.let {
+    val result = JSONArray()
+    for (i in indices) result.put(i, this[i])
+    result
+}
+
+fun String?.toLong() = this?.let {
+    if (this[0] == '#') this.substring(1).toLong(16)
+    else this.toLong(16)
+}
+
+fun Matrix?.generate() = this?.let {
+    val floats = FloatArray(9)
+    getValues(floats)
+    val result = JSONArray()
+    for (f in floats) result.put(java.lang.Float.valueOf(f))
+    result
+}
+
+fun CustomizationFont.generate(fonts: Map<CustomizationFont, Typeface>, sizes: Map<CustomizationFont, Int>) = generateTypeface(fonts[this], sizes[this])
+
+fun CustomizationFont.setFont(editor: ParamsCustomization.CustomizationEditor, value: Any?) {
+    val font = typefaceFromJSON(value as JSONObject)
+    editor.setFont(this, font.first)
+    font.second?.let { editor.setFontSize(this, it) }
+}
+
+internal object Convert {
+    fun byteArrayFromBase64(base64: String?) = base64?.let { Base64.decode(it, Base64.NO_WRAP) }
+    fun generateByteArray(array: ByteArray?) = array?.let { Base64.encodeToString(it, Base64.NO_WRAP) }
+
+    fun bitmapFromBase64(base64: String?) = base64?.let {
+        val decodedString = byteArrayFromBase64(base64)
+        var result = BitmapFactory.decodeByteArray(decodedString, 0, decodedString!!.size)
+        val sizeMultiplier = result.byteCount / 5000000
+        if (result.byteCount > 5000000) result = Bitmap.createScaledBitmap(result, result.width / sqrt(sizeMultiplier.toDouble()).toInt(), result.height / sqrt(sizeMultiplier.toDouble()).toInt(), false)
+        result
+    }
+
+    fun bitmapToBase64(bitmap: Bitmap?) = bitmap?.let {
+        val byteArrayOutputStream = ByteArrayOutputStream()
+        bitmap.compress(Bitmap.CompressFormat.JPEG, 100, byteArrayOutputStream)
+        val byteArray = byteArrayOutputStream.toByteArray()
+        generateByteArray(byteArray)
+    }
+
+    fun Any?.toDrawable(context: Context) = (this as String?)?.let {
+        val decodedByte = byteArrayFromBase64(it)
+        val bitmap = BitmapFactory.decodeByteArray(decodedByte, 0, decodedByte!!.size)
+        val density = context.resources.displayMetrics.density
+        val width = (bitmap.width * density).toInt()
+        val height = (bitmap.height * density).toInt()
+        BitmapDrawable(context.resources, Bitmap.createScaledBitmap(bitmap, width, height, false))
+    }
+
+    fun Drawable?.toString() = this?.let {
+        if (this is BitmapDrawable) if (bitmap != null) return bitmapToBase64(bitmap)
+        val bitmap: Bitmap = if (intrinsicWidth <= 0 || intrinsicHeight <= 0) Bitmap.createBitmap(1, 1, Bitmap.Config.ARGB_8888) else Bitmap.createBitmap(intrinsicWidth, intrinsicHeight, Bitmap.Config.ARGB_8888)
+        val canvas = Canvas(bitmap)
+        setBounds(0, 0, canvas.width, canvas.height)
+        draw(canvas)
+        bitmapToBase64(bitmap)
+    }
+}

package/example/App.tsx

@@ -1,8 +1,8 @@
 import React from 'react'
 import { SafeAreaView, ScrollView, StyleSheet, Text, View, NativeEventEmitter, Platform, TouchableOpacity, Image, Button } from 'react-native'
-import DocumentReader, { Enum, DocumentReaderCompletion, DocumentReaderScenario, RNRegulaDocumentReader, DocumentReaderResults, DocumentReaderNotification, ScannerConfig, RecognizeConfig } from '@regulaforensics/react-native-document-reader-api'
+import DocumentReader, { Enum, DocumentReaderCompletion, DocumentReaderScenario, RNRegulaDocumentReader, DocumentReaderResults, DocumentReaderNotification, ScannerConfig, RecognizeConfig, DocReaderConfig } from '@regulaforensics/react-native-document-reader-api'
 import * as RNFS from 'react-native-fs'
-import RadioGroup from 'react-native-radio-buttons-group'
+import RadioGroup, { RadioButtonProps } from 'react-native-radio-buttons-group'
 import { CheckBox } from '@rneui/themed'
 import Icon from 'react-native-vector-icons/FontAwesome'
 import { launchImageLibrary } from 'react-native-image-picker'
@@ -30,72 +30,54 @@ interface IState {
 }
 
 export default class App extends React.Component<IProps, IState> {
+  onInitialized() {
+    this.setState({ fullName: "Ready" })
+
+    DocumentReader.setFunctionality({
+      showCaptureButton: true
+    }, _ => { }, _ => { })
+  }
+
   constructor(props: {} | Readonly<{}>) {
     super(props)
     Icon.loadFont()
 
     var eventManager = new NativeEventEmitter(RNRegulaDocumentReader)
-    eventManager.addListener('prepareDatabaseProgressChangeEvent', e => this.setState({ fullName: "Downloading database: " + e["msg"] + "%" }))
-    eventManager.addListener('completionEvent', (e) => this.handleCompletion(DocumentReaderCompletion.fromJson(JSON.parse(e["msg"]))!))
-    eventManager.addListener('rfidNotificationCompletionEvent', e => console.log("rfidNotificationCompletionEvent: " + e["msg"]))
-    eventManager.addListener('paCertificateCompletionEvent', e => console.log("paCertificateCompletionEvent: " + e["msg"]))
-    eventManager.addListener('onCustomButtonTappedEvent', e => console.log("onCustomButtonTappedEvent: " + e["msg"]))
-
-    DocumentReader.prepareDatabase("Full", (respond) => {
-      console.log(respond)
-      var licPath = Platform.OS === 'ios' ? (RNFS.MainBundlePath + "/regula.license") : "regula.license"
-      var readFile = Platform.OS === 'ios' ? RNFS.readFile : RNFS.readFileAssets
-      readFile(licPath, 'base64').then((res) => {
-        this.setState({ fullName: "Initializing..." })
-        DocumentReader.initializeReader({
-          license: res,
-          delayedNNLoad: true
-        }, (respond) => {
-          console.log(respond)
-          DocumentReader.isRFIDAvailableForUse((canRfid) => {
-            if (canRfid) {
-              this.setState({ canRfid: true, rfidUIHeader: "Reading RFID", rfidDescription: "Place your phone on top of the NFC tag", rfidUIHeaderColor: "black" })
-              this.setState({ canRfidTitle: '' })
-            }
-          }, error => console.log(error))
-          DocumentReader.getAvailableScenarios((jstring) => {
-            var scenarios = JSON.parse(jstring)
-            var items = []
-            for (var i in scenarios) {
-              var scenario = DocumentReaderScenario.fromJson(typeof scenarios[i] === "string" ? JSON.parse(scenarios[i]) : scenarios[i])!.name
-              items.push({
-                label: scenario,
-                id: scenario
-              })
-            }
-            this.setState({ radioButtons: items })
-            this.setState({ selectedScenario: this.state.radioButtons[0]['id'] })
-            DocumentReader.setConfig({
-              functionality: {
-                videoCaptureMotionControl: true,
-                showCaptureButton: true
-              },
-              customization: {
-                showResultStatusMessages: true,
-                showStatusMessages: true
-              },
-              processParams: {
-                scenario: this.state.selectedScenario,
-                doRfid: this.state.doRfid,
-              },
-            }, _ => { }, error => console.log(error))
-
-            DocumentReader.getDocumentReaderIsReady((isReady) => {
-              if (isReady) {
-                this.setState({ fullName: "Ready" })
-                DocumentReader.setRfidDelegate(Enum.RFIDDelegate.NO_PA, _ => { }, error => console.log(error))
-              } else
-                this.setState({ fullName: "Failed" })
-            }, error => console.log(error))
-          }, error => console.log(error))
+    eventManager.addListener('completion', (e) => this.handleCompletion(DocumentReaderCompletion.fromJson(JSON.parse(e["msg"]))!))
+    eventManager.addListener('rfidOnProgressCompletion', e => this.updateRfidUI(DocumentReaderNotification.fromJson(JSON.parse(e["msg"]))!))
+
+    var licPath = Platform.OS === 'ios' ? (RNFS.MainBundlePath + "/regula.license") : "regula.license"
+    var readFile = Platform.OS === 'ios' ? RNFS.readFile : RNFS.readFileAssets
+    readFile(licPath, 'base64').then((res) => {
+      this.setState({ fullName: "Initializing..." })
+      var config = new DocReaderConfig()
+      config.license = res
+      config.delayedNNLoad = true
+      DocumentReader.initializeReader(config, (response) => {
+        if (!JSON.parse(response)["success"]) {
+          console.log(response)
+          return
+        }
+        console.log("Init complete")
+        DocumentReader.getIsRFIDAvailableForUse((canRfid) => {
+          if (canRfid) {
+            this.setState({ canRfid: true, rfidUIHeader: "Reading RFID", rfidDescription: "Place your phone on top of the NFC tag", rfidUIHeaderColor: "black" })
+            this.setState({ canRfidTitle: '' })
+          }
+        }, error => console.log(error))
+        DocumentReader.getAvailableScenarios((jstring) => {
+          var scenarios = JSON.parse(jstring)
+          var items: RadioButtonProps[] = []
+          for (var i in scenarios) {
+            var scenario = DocumentReaderScenario.fromJson(typeof scenarios[i] === "string" ? JSON.parse(scenarios[i]) : scenarios[i])!.name!
+            items.push({ label: scenario, id: scenario })
+          }
+          this.setState({ radioButtons: items })
+          this.setState({ selectedScenario: this.state.radioButtons[0]['id'] })
         }, error => console.log(error))
-      })
-    }, error => console.log(error))
+        this.onInitialized()
+      }, error => console.log(error))
+    })
 
     this.state = {
       fullName: "Please wait...",
@@ -115,25 +97,26 @@ export default class App extends React.Component<IProps, IState> {
   }
 
   handleCompletion(completion: DocumentReaderCompletion) {
-    console.log("DocReaderAction: " + completion.action)
-    if (this.state.isReadingRfidCustomUi && (completion.action === Enum.DocReaderAction.CANCEL || completion.action === Enum.DocReaderAction.ERROR))
-      this.hideRfidUI()
-    if (this.state.isReadingRfidCustomUi && completion.action === Enum.DocReaderAction.NOTIFICATION)
-      this.updateRfidUI(completion.results!.documentReaderNotification!)
-    if (completion.action === Enum.DocReaderAction.COMPLETE)
-      if (this.state.isReadingRfidCustomUi)
-        if (completion.results!.rfidResult !== 1)
-          this.restartRfidUI()
-        else {
-          this.hideRfidUI()
-          this.displayResults(completion.results!)
-        }
-      else
-        this.handleResults(completion.results!)
-    if (completion.action === Enum.DocReaderAction.TIMEOUT)
+    if (this.state.isReadingRfidCustomUi) {
+      if (completion.action == Enum.DocReaderAction.ERROR) this.restartRfidUI()
+      if (this.actionSuccess(completion.action!) || this.actionError(completion.action!)) {
+        this.hideRfidUI()
+        this.displayResults(completion.results!)
+      }
+    } else if (this.actionSuccess(completion.action!))
       this.handleResults(completion.results!)
   }
 
+  actionSuccess(action: number) {
+    if (action == Enum.DocReaderAction.COMPLETE || action == Enum.DocReaderAction.TIMEOUT) return true
+    return false
+  }
+
+  actionError(action: number) {
+    if (action == Enum.DocReaderAction.CANCEL || action == Enum.DocReaderAction.ERROR) return true
+    return false
+  }
+
   showRfidUI() {
     // show animation
     this.setState({ isReadingRfidCustomUi: true })
@@ -141,6 +124,7 @@ export default class App extends React.Component<IProps, IState> {
 
   hideRfidUI() {
     // show animation
+    DocumentReader.stopRFIDReader(_ => { }, _ => { });
     this.restartRfidUI()
     this.setState({ isReadingRfidCustomUi: false, rfidUIHeader: "Reading RFID", rfidUIHeaderColor: "black" })
   }
@@ -187,7 +171,7 @@ export default class App extends React.Component<IProps, IState> {
       this.setState({ fullName: "COPYING IMAGE..." })
       var response = r.assets
 
-      var images = []
+      var images: any = []
 
       for (var i = 0; i < response!.length; i++) {
         images.push(response![i].base64!)
@@ -221,16 +205,16 @@ export default class App extends React.Component<IProps, IState> {
 
   customRFID() {
     this.showRfidUI()
-    DocumentReader.readRFID(_ => { }, _ => { })
+    DocumentReader.readRFID(false, false, false, _ => { }, _ => { })
   }
 
   usualRFID() {
     isReadingRfid = true
-    DocumentReader.startRFIDReader(_ => { }, _ => { })
+    DocumentReader.startRFIDReader(false, false, false, _ => { }, _ => { })
   }
 
   handleResults(results: DocumentReaderResults) {
-    if (this.state.doRfid && !isReadingRfid && results != null && results.chipPage != 0) {
+    if (this.state.doRfid && !isReadingRfid && results.chipPage != 0) {
       // this.customRFID()
       this.usualRFID()
     } else {
@@ -242,73 +226,25 @@ export default class App extends React.Component<IProps, IState> {
   render() {
     return (
       <SafeAreaView style={styles.container}>
-        {(this.state.isReadingRfidCustomUi) && <View style={styles.container}>
-          <Text style={{ paddingBottom: 30, fontSize: 23, color: this.state.rfidUIHeaderColor }}>{this.state.rfidUIHeader}</Text>
-          <Text style={{ paddingBottom: 50, fontSize: 20, color: "black" }}>{this.state.rfidDescription}</Text>
-          <Progress.Bar width={200} useNativeDriver={true} color="#4285F4" progress={this.state.rfidProgress} />
-          <TouchableOpacity style={styles.cancelButton} onPress={() => { this.hideRfidUI() }}>
-            <Text style={{ fontSize: 20, color: "black" }}>X</Text>
-          </TouchableOpacity>
-        </View>
-        }
         {!this.state.isReadingRfidCustomUi && <View style={styles.container}>
-          <Text /><Text />
-          <Text style={{
-            top: 1,
-            left: 1,
-            padding: 30,
-            fontSize: 20,
-            color: "black"
-          }}>
-            {this.state.fullName}
-          </Text>
+          <Text style={styles.title}>{this.state.fullName}</Text>
+
           <View style={{ flexDirection: "row", padding: 5 }}>
             <View style={{ flexDirection: "column", alignItems: "center" }}>
-              <Text style={{
-                top: 1,
-                right: 1,
-                padding: 5,
-                color: "black"
-              }}>
-                Portrait
-              </Text>
-              <Image
-                style={{
-                  height: 150,
-                  width: 150,
-                }}
-                source={this.state.portrait}
-                resizeMode="contain"
-              />
+              <Text style={styles.imageLabel}>Portrait</Text>
+              <Image style={{ height: 150, width: 150 }} source={this.state.portrait} resizeMode="contain" />
             </View>
             <View style={{ flexDirection: "column", alignItems: "center", padding: 5 }}>
-              <Text style={{
-                top: 1,
-                right: 1,
-                padding: 5,
-                color: "black"
-              }}>
-                Document image
-              </Text>
-              <Image
-                style={{
-                  height: 150,
-                  width: 200,
-                }}
-                source={this.state.docFront}
-                resizeMode="contain"
-              />
+              <Text style={styles.imageLabel}>Document image</Text>
+              <Image style={{ height: 150, width: 200 }} source={this.state.docFront} resizeMode="contain" />
             </View>
           </View>
 
           <ScrollView style={{ padding: 5, alignSelf: 'center' }} showsVerticalScrollIndicator={false}>
-            <RadioGroup containerStyle={styles.radio}
+            <RadioGroup
+              containerStyle={{ alignItems: 'flex-start' }}
               radioButtons={this.state.radioButtons}
-              onPress={
-                (selectedID) => {
-                  this.setState({ selectedScenario: selectedID })
-                }
-              }
+              onPress={(selectedID) => { this.setState({ selectedScenario: selectedID }) }}
               selectedId={this.state.selectedScenario}
             />
           </ScrollView>
@@ -328,10 +264,18 @@ export default class App extends React.Component<IProps, IState> {
           <View style={{ flexDirection: 'row' }}>
             <Button color="#4285F4" title="Scan document" onPress={() => this.scan()} />
             <Text style={{ padding: 5 }}></Text>
-            <Button color="#4285F4" title="     Scan image     " onPress={() => this.recognize()} />
+            <Button color="#4285F4" title="Scan image" onPress={() => this.recognize()} />
           </View>
-        </View>
-        }
+        </View>}
+
+        {(this.state.isReadingRfidCustomUi) && <View style={styles.container}>
+          <Text style={{ paddingBottom: 30, fontSize: 23, color: this.state.rfidUIHeaderColor }}>{this.state.rfidUIHeader}</Text>
+          <Text style={{ paddingBottom: 50, fontSize: 20 }}>{this.state.rfidDescription}</Text>
+          <Progress.Bar style={{ marginBottom: 30 }} width={200} useNativeDriver={true} color="#4285F4" progress={this.state.rfidProgress} />
+          <TouchableOpacity style={styles.cancelButton} onPress={() => { this.hideRfidUI() }}>
+            <Text style={{ fontSize: 20 }}>X</Text>
+          </TouchableOpacity>
+        </View>}
       </SafeAreaView>
     )
   }
@@ -347,12 +291,20 @@ const styles = StyleSheet.create({
     backgroundColor: '#F5FCFF',
     marginBottom: 12,
   },
-  radio: {
-    alignItems: 'flex-start'
-  },
   cancelButton: {
     position: 'absolute',
     bottom: 0,
     right: 20
+  },
+  imageLabel: {
+    top: 1,
+    right: 1,
+    padding: 5
+  },
+  title: {
+    top: 1,
+    left: 1,
+    padding: 30,
+    fontSize: 20
   }
 })

package/example/README.md

@@ -0,0 +1,37 @@
+# How to build demo application
+
+1. Get the trial license at [client.regulaforensics.com](https://client.regulaforensics.com/) (`regula.license` file). The license creation wizard will guide you through the necessary steps.
+2. Get the trial database at [client.regulaforensics.com/customer/databases](https://client.regulaforensics.com/customer/databases) (`db.dat`)
+2. Download or clone this repository using the command `git clone https://github.com/regulaforensics/react-native-document-reader.git`.
+4. Copy the `regula.license` file to the `example/android/app/src/main/assets/` folder.
+4. Copy the `regula.license` file to the `example/ios/` folder.
+5. Copy the `db.dat` file to the `example/android/app/src/main/assets/Regula/` folder.
+6. Copy the `db.dat` file to the `example/ios/` folder.
+3. Run the following commands in Terminal:
+```bash
+$ cd example
+$ npm install
+$ cd ios
+$ pod install
+```
+
+**Note**: make sure that Metro Bundler is running when you run your app. Otherwise, run `npx react-native start` command. If it fails to start, run `git init` from Project root, then `npx react-native start`.
+
+4. Android:
+  * Copy the `regula.license` file to the `example/android/app/src/main/assets` folder.
+  * Run `npx react-native run-android` inside `example` folder - this is just one way to run the app. You can also run it directly from within Android Studio. **Note**: `npx react-native log-android` is used to view logs.
+
+**Note**: if the running failed with the following error `Error: spawn ./gradlew EACCES`, try to run the following command `chmod +x gradlew` within the `example/android` directory.
+
+5. iOS:
+  * Copy the `regula.license` file to the `example/ios` folder.
+  * Run `npx react-native run-ios` inside `example` folder - this is just one way to run the app. You can also run it directly from within Xcode.
+
+# Troubleshooting license issues
+
+If you have issues with license verification when running the application, please verify that next is true:
+1. The OS, which you use, is specified in the license (e.g., Android and/or iOS).
+3. The license is valid (not expired).
+4. The date and time on the device, where you run the application, are valid.
+5. You use the latest release version of the Document Reader SDK.
+6. You placed the  `license` into the correct folder as described [here](#how-to-build-demo-application).

package/example/android/app/build.gradle

@@ -71,7 +71,7 @@ def jscFlavor = 'org.webkit:android-jsc:+'
 android {
     ndkVersion rootProject.ext.ndkVersion
 
-    compileSdkVersion rootProject.ext.compileSdkVersion
+    compileSdk rootProject.ext.compileSdkVersion
 
     namespace "com.regula.dr.fullrfid"
     defaultConfig {

package/example/android/app/src/main/java/com/regula/dr/fullrfid/MainApplication.java

@@ -57,6 +57,5 @@ public class MainApplication extends Application implements ReactApplication {
       // If you opted-in for the New Architecture, we load the native entry point for this app.
       DefaultNewArchitectureEntryPoint.load();
     }
-    ReactNativeFlipper.initializeFlipper(this, getReactNativeHost().getReactInstanceManager());
   }
 }

package/example/android/app/src/main/res/values/styles.xml

@@ -1,9 +1,8 @@
 <resources>
-
     <!-- Base application theme. -->
     <style name="AppTheme" parent="Theme.AppCompat.DayNight.NoActionBar">
         <!-- Customize your theme here. -->
         <item name="android:editTextBackground">@drawable/rn_edit_text_material</item>
+        <item name="android:textColor">#000000</item>
     </style>
-
 </resources>

package/example/android/build.gradle

@@ -1,11 +1,9 @@
-// Top-level build file where you can add configuration options common to all sub-projects/modules.
-
 buildscript {
     ext {
         buildToolsVersion = "33.0.0"
         minSdkVersion = 21
-        compileSdkVersion = 33
-        targetSdkVersion = 33
+        compileSdkVersion = 34
+        targetSdkVersion = 34
 
         // We use NDK 23 which has both M1 support and is the side-by-side NDK version from AGP.
         ndkVersion = "23.1.7779620"