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 (Ditto ID SDK)

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

1. 🏗️ Adding and Embedding Ditto ID 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 Ditto ID 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 Ditto 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)