Skip to content
master
Switch branches/tags
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
May 10, 2018

README.md

Regula Document Reader (Android version)

Regula Document Reader SDK allows you to read various kinds of identification documents, passports, driving licenses, ID cards, etc. All processing is performed completely offline on your device. No any data leaving your device.

You can use native camera to scan the documents or image from gallery for extract all data from it.

We have provided a simple application that demonstrates the API calls you can use to interact with the Document Reader Library.

Content

How to build the demo application

  1. Visit licensing.regulaforensics.com to get a trial license (regula.license file). The license creation wizard will guide you through the necessary steps.

Note: optionally, you can also download the documents database (db.dat file) to add it to the project manually and use the app without the Internet. Otherwise, it'll be downloaded from the Internet while the app is running.

  1. Download and install the latest Android Studio.
  2. Download or clone current repository using the command git clone https://github.com/regulaforensics/DocumentReader-Android.git.
  3. Launch Android Studio and select Open an existing Android Studio project, then select DocumentReader-sample or DocumentReader-sample_kotlin project in the file browser.
  4. Download additional files proposed by Android Studio to build the project (e.g., build tools).
  5. Change the application ID in the /app/build.gradle file to the one you have specified during the registration at licensing.regulaforensics.com (com.regula.documentreader is set by default).
  6. Copy the regula.license file to the /app/src/main/res/raw folder. If the database has been downloaded manually, place it to the /app/src/main/assets/Regula folder.
  7. Build and run the application.

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 (Android).
  2. The application ID, which you use, is specified in the license.
  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 project.

Documentation

The documentation on the SDK can be found here.

Additional information

If you have any technical questions or suggestions, feel free to contact us or create an issue here.

To use our SDK in your own app you have to purchase a commercial license.

About

Android Framework for reading and validation of identification documents

Resources

Packages

No packages published