Skip to content

Latest commit

 

History

History

README.md

How to build demo application

  1. Get the trial license at 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 (db.dat)
  3. 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.
  5. Copy the regula.license file to the example/ios/ folder.
  6. Copy the db.dat file to the example/android/app/src/main/assets/Regula/ folder.
  7. Copy the db.dat file to the example/ios/ folder.
  8. Run the following commands in Terminal:
$ 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.

  1. 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.

  1. 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).
  2. The license is valid (not expired).
  3. The date and time on the device, where you run the application, are valid.
  4. You use the latest release version of the Document Reader SDK.
  5. You placed the license into the correct folder as described here.