Installation

Add the Owl Eyes Android mDL SDK to your project.

Maven Central (Recommended)

Add the dependency to your app's build.gradle.kts:

app/build.gradle.ktskotlin
Loading...

GitHub Packages (Alternative)

If you prefer GitHub Packages, add the repository to your settings.gradle.kts:

settings.gradle.ktskotlin
Loading...

Required Permissions

Add the following permissions to your AndroidManifest.xml based on which verification channels you plan to use:

AndroidManifest.xmlxml
Loading...
Note: Set android:required="false" for hardware features to ensure your app can be installed on devices without NFC or BLE. The SDK provides methods to check device capabilities at runtime.

Permission Summary

ChannelRequired Permissions
AllINTERNET
QR CodeCAMERA
NFCNFC
Bluetooth LEBLUETOOTH,BLUETOOTH_ADMIN,BLUETOOTH_CONNECT,BLUETOOTH_SCAN,ACCESS_FINE_LOCATION

ProGuard / R8 Rules

The SDK includes consumer ProGuard rules automatically. No additional configuration is required for code shrinking and obfuscation.

Verify Installation

After syncing your Gradle files, verify the SDK is available by importing it:

MainActivity.ktkotlin
Loading...

Next Step

With the SDK installed, proceed to the Quick Start guide to perform your first mDL verification.