- Get the trial license at client.regulaforensics.com (
regula.licensefile). The license creation wizard will guide you through the necessary steps. - Get the trial database at client.regulaforensics.com/customer/databases (
db.dat) - Download or clone this repository using the command
git clone https://github.com/regulaforensics/react-native-document-reader.git. - Copy the
regula.licensefile to theexample/android/app/src/main/assets/folder. - Copy the
regula.licensefile to theexample/ios/folder. - Copy the
db.datfile to theexample/android/app/src/main/assets/Regula/folder. - Copy the
db.datfile to theexample/ios/folder. - Run the following commands in Terminal:
$ cd example
$ npm install
$ cd ios
$ pod installNote: 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.
- Android:
- Copy the
regula.licensefile to theexample/android/app/src/main/assetsfolder. - Run
npx react-native run-androidinsideexamplefolder - this is just one way to run the app. You can also run it directly from within Android Studio. Note:npx react-native log-androidis used to view logs. - If gradle sync fails, select JDK-17 in Android Studio
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.
- iOS:
- Copy the
regula.licensefile to theexample/iosfolder. - Run
npx react-native run-iosinsideexamplefolder - this is just one way to run the app. You can also run it directly from within Xcode. - This example does not support MacOS-27+ and iOS-27+
If you have issues with license verification when running the application, please verify that next is true:
- The OS, which you use, is specified in the license (e.g., Android and/or iOS).
- The license is valid (not expired).
- The date and time on the device, where you run the application, are valid.
- You use the latest release version of the Document Reader SDK.
- You placed the
licenseinto the correct folder as described here.