react-native-regula-test

Building demo app

https://github.com/DmitrySmolyakov/react-native-document-reader-example-demo

Mostly automatic installation(recommended):

react-native init MyAwesomeProject

cd MyAwesomeProject

npm install react-native-document-reader-api --save

npm install react-native-document-reader-core-NAMEOFCORE --save Names of cores can be found at ...

npm install react-native-fs --save (optional, used to load license file from file system)

react-native link

Manual installation(outdated):

npm install react-native-fs --save

npm install react-native-document-reader-api --save

Android:

android/app/src/main/java/[...]/MainApplication.java:

import com.regula.documentreader.RNRegulaDocumentReaderPackage;
import com.rnfs.RNFSPackage;
...
getPackages(){
	...,
	new RNFSPackage(),
    new RNRegulaDocumentReaderPackage()
}

android/settings.gradle:

...
include ':react-native-fs'
project(':react-native-fs').projectDir = new File(settingsDir, '../node_modules/react-native-fs/android')
include ':react-native-document-reader-api'
project(':react-native-document-reader-api').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-document-reader-api/android')

android/app/build.gradle:

dependencies {
	...
	implementation project(':react-native-fs')
	implementation project(':react-native-document-reader-api')
}

After both manual and automatic installation:

Android:

android/app/src/main/AndroidManifest.xml:

android:allowBackup="true"

android/build.gradle:

minSdkVersion = 19    (or higher)
...
allprojects {
	repositories {
		...
		maven {
			url "http://maven.regulaforensics.com/RegulaDocumentReader"
		}
		maven {
			url "http://maven.regulaforensics.com/RegulaDocumentReader/Beta"
		}
	}
}

important: the urls above have to be in separate maven{} blocks

get regula.license here: https://licensing.regulaforensics.com/

put regula.license here: android\app\src\main\assets\

IOS:

Navigate to yourproject/ios and open yourproject.xcodeproj

Go to TARGETS(project navigator->your project->targets->project name->general->embedded binaries) settings and find the section Embedded Binaries. Then add DocumentReader.framework and DocumentReaderCore.framework (situated in node_modules/react-native-document-reader-api/ios and node_modules/react-native-document-reader-core-NAMEOFCORE/ios respectively) to Embedded Binaries

Go to TARGETS build settings and set always embed swift standart libraries to YES.

In Build settings add ${PROJECT_DIR}/../node_modules/react-native-document-reader-api/ios and ${PROJECT_DIR}/../node_modules/react-native-document-reader-core-NAMEOFCORE/ios to Framework search paths(you can copy this from header search paths)

Get regula.license here: https://licensing.regulaforensics.com/

Xcode->project navigator-> your project->folder named as your project->rightclick this folder->add files to...->select your regula.license file

Add Privacy - Camera Usage Description and Privacy - Photo Library Usage Description to Information property list of your info.plist

Usage:

On the first launch, if you don't provide a database file, connect to the internet and wait until the database is downloaded(You will get "init complete" in console)

Adding the following to App.js will show download progress in console:

const eventManager = new NativeEventEmitter(RNRegulaDocumentReader);
eventManager.addListener(
  'prepareDatabaseProgressChangeEvent',
  e => console.log(e["msg"])
);

Crashes:

If you see a crash like crash_sample.txt, then run the following commands from your app directory

npm install --save-dev jetifier
npx jetify
npx react-native run-android