Android
AAR artifact-based integration
To integrate the Biometric Sensor SDK into your Android project via aar file
Link BiometricSensorSDK.aar from the OneSpan Mobile Security Suite package to your project.
Link the androidx.appcompat:appcompat library from Google version 1.7.1 and later to your project.
Link the androidx.biometric:biometric library from Google version 1.1.0 and later to your project.
Maven-based integration
The SDK artifact is also delivered as a local Maven repository with transitive dependencies, and the package includes a documentation jar file to view the technical documentation in Android Studio (to be used in conjunction with the Maven repository).
To integrate the SDK via maven repository
Copy the maven folder from the published artifacts to the root folder of your application.
Define the dependency in your build.gradle file:
implementation: 'com.onespan:sdk_biometric_sensor_android:+'.Comment out any existing definitions, for example:
implementation(name: 'BiometricSensorSDK', ext: 'aar').
To be able to access the biometric authentication service, you need to set appropriate permissions in your application configuration.
For devices that run on Android versions earlier than Android 9, you need to add the USE_FINGERPRINT permission to the AndroidManifest.xml file.
For devices that run on Android 9 or later, you need to add the USE_BIOMETRIC permission to the AndroidManifest.xml file.
iOS
To integrate the Biometric Sensor SDK into your iOS project
Link the MSSBiometricSensor.xcframework from the OneSpan Mobile Security Suite package to your Xcode project.
In the Build Settings > Other Linker flags section of your Xcode project, add the following line:
-weak_framework LocalAuthentication.In the Info.plist file, define the NSFaceIDUsageDescription key.
You are now ready to use the OneSpan Biometric Sensor SDK.
API reference documentation and sample applications
To learn more about the public APIs and their functions, exceptions, and error codes, refer to the technical documentation that is included in the product package for each SDK and each platform. In the product package, you can also find the sample applications provided for each platform to see examples of how the SDKs can be used.
These sample apps are intended only to demonstrate basic scenarios and SDK usage. They are not designed to be copied directly into production projects!