Native Android

🤖 Native Android Setup

🛠 Prerequisites

Before integrating the SDK, make sure your development environment is set up.

  • Android Studio (latest)
  • SDK 23+ and Jetpack support
  • Required AAR files: Aware-FaceCapture.aar, Aware-FaceCapture-DeviceControl.aar
  • Physical android device for testing

SDK Files

  • AAR Libraries:
    • Aware-FaceCapture.aar
    • Aware-FaceCapture-DeviceControl.aar
  • Required assets:
    • regula.license
    • db.dat
    • PKD Certificate (*.ldif)

Configuration

  • Android Studio (latest)
  • SDK 23+ with Jetpack
  • Physical Android device required

📲 Additional Configurations for Native Android (REL-ID IDV SDK)

This guide outlines all the setup steps required to configure and integrate REL-ID IDV SDK in a Native Android application.


1. 🏗️ Adding and Embedding REL-ID-IDV SDKs in Android Studio Project

Copy SDK AAR Files

Copy the following SDK files to the libs directory of your Android project:

  • Aware-FaceCapture.aar
  • Aware-FaceCapture-DeviceControl.aar

Add AARs as Dependencies

  1. Open Android Studio
  2. Navigate to: File > Project Structure > Dependencies
  3. Select your app module
  4. Click on the + icon and choose JAR/AAR Dependency
  5. Add each .aar file
  6. Set the configuration to implementation
  7. Click Apply and OK

2. 🧱 Repository Settings (settings.gradle)

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            url "https://maven.regulaforensics.com/RegulaDocumentReader/"
        }
    }
}

3. 📦 Add Module Dependencies (build.gradle)

implementation 'com.regula.documentreader.core:fullauthrfid:7.7.13549@aar'
implementation('com.regula.documentreader:api:7.7.11299@aar') {
    transitive = true
}

4. 📁 Add Required Asset Files

A. License

Copy regula.license to:

android/app/src/main/res/raw/

Create theraw folder if it doesn't exist.

B. Database

Copy db.dat to:

android/app/src/main/assets/Regula/

C. PKD Certificate

Copy the .ldif certificate file to:

android/app/src/main/assets/certificates/

5. 🏗 Build and Run Project

Run the following command to sync and build:

./gradlew sync

✅ Prerequisites

Ensure:

  • All REL-ID IDV SDK modules are installed correctly.
  • There are no compile-time errors in your code.

🧑‍💻 Native IDEs

  • Use Android Studio to build and run Android apps.
  • Use Xcode to build and run iOS apps.

💡 Before running the app in Xcode, navigate to the iOS project directory and execute:

pod install

⚠️ Important Notes

  • The REL-ID IDV SDK supports physical devices only for testing. Simulators/emulators are not supported.
  • Make sure the following files are correctly placed and bundled:
    • regula.license
    • db.dat
    • PKD Certificate (.ldif for Android, Certificates.bundle for iOS)