Installation Guide

Development Environment Preconditions

Your development environment must meet the following prerequisites:

Have version 9 or higher of Android Studio installed (Google's official development IDE);
Have the Android SDK version 21 or higher;
Have the Unico Maven repository configured.

The capture component provided through the Android SDK supports versions equal to or higher for the following technologies:

• Android: 5.0 (API 21);

• Kotlin: 1.8.22.

Compatible Devices

This SDK does not work on emulators, only on physical devices.

The Android SDK is compatible with the majority of devices running Android 5.0 (API level 21) or higher.

The table below lists the devices tested in the lab, along with the availability of the supplier/manufacturer extensions. Some extensions listed may be subject to specific APIs or SKUs from the manufacturer. Click below to view the tested devices:

Tested devices

Dispositivo	Versão do Android	Resultado do teste	Tipo do teste
ASUS - X01BDA	10.0.0		Físico
ASUS - Z01KD	8.0.1		Físico
HUAWEY - P30 Lite	9.0.0		Físico
LG - K22	10.0.0		Físico
LG - Q6	7.0.0		Físico
MOTOROLA - Moto one macro	10.0.0		Físico
MOTOROLA - Moto G4	6.0.1		Físico
MOTOROLA - Moto G5s Plus	8.1.0		Físico
MOTOROLA - Moto G6 Play	9.0.0		Físico
MOTOROLA - Moto G7 Play	10.0.0		Físico
MOTOROLA - Moto G7 Power	10.0.0		Físico
MOTOROLA - Moto G8 Power Lite	10.0.0		Físico
SAMSUNG - A01	10.0.0		Físico
SAMSUNG - J8 SM J810M	8.1.0		Físico
SAMSUNG - Galaxy A30s SM-A307GT	10.0.0		Físico
SAMSUNG - Galaxy A51	10.0.0		Físico
SAMSUNG - Galaxy A71	11.0.0		Físico
SAMSUNG - Galaxy S20+	11.0.0		Físico
SAMSUNG - s10e	11.0.0		Físico
XIAOMI - Mi 8 Lite	9.0.0		Físico
XIAOMI - Mi 8 Lite	10.0.0		Físico
XIAOMI - Poco X3	10.0.0		Físico
XIAOMI - Redmi Note 8	10.0.0		Físico
XIAOMI - Redmi Note 8 Pro	10.0.0		Físico
XIAOMI - Redmi Note 9	10.0.0		Físico
XIAOMI - Redmi Note 9 Pro	10.0.0		Físico
GOOGLE - Pixel sailfish	8.0.0		Virtual (TestLab)
HUAWEY - ALE L23	5.0.0		Virtual (TestLab)
HUAWEY - ANE LX1	9.0.0		Virtual (TestLab)
HUAWEY - ANE LX2	9.0.0		Virtual (TestLab)
HUAWEY - COR L29	8.1.0		Virtual (TestLab)
HUAWEY - MHA L29	7.0.0		Virtual (TestLab)
HUAWEY - NEO L29	9.0.0		Virtual (TestLab)
SAMSUNG - SC 02J	8.0.0		Virtual (TestLab)
SAMSUNG - SM G891A	9.0.0		Virtual (TestLab)
SAMSUNG - SM G930AZ	8.0.0		Virtual (TestLab)
SAMSUNG - SM G935A	8.0.0		Virtual (TestLab)
SAMSUNG - SM G965N	9.0.0		Virtual (TestLab)
SAMSUNG - SM G965U1	8.0.0		Virtual (TestLab)
SAMSUNG - SM G981U1	10.0.0		Virtual (TestLab)
SAMSUNG - SM J727V	8.1.0		Virtual (TestLab)
SAMSUNG - SM N950F	9.0.0		Virtual (TestLab)
SAMSUNG - SM N950N	9.0.0		Virtual (TestLab)
SAMSUNG - SM N950U	8.0.0		Virtual (TestLab)
SAMSUNG - SM N960F	9.0.0		Virtual (TestLab)
SAMSUNG - SM N960N	9.0.0		Virtual (TestLab)
SAMSUNG - SM N960U1	8.1.0		stLab)

Installing the Android SDK

To implement the Unico IDCloud Android SDK into your Android application, follow the step-by-step instructions listed below:

1

Configuring the Maven Repository

The Android SDK is provided through a Maven Repository. Add the following to the repositories block in the build.gradle file located at the root of your project:

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven-sdk.unico.run/sdk-mobile")
        }
    }
}

Groovy

If your project still uses the legacy configuration approach, make this change in the repositories block of the existing build.gradle file at the root of your project:

Kotlin

// Top-level build file where you can add configuration options common to all sub-projects/modules.
allprojects {
    repositories {
        google()
        maven { 
            url = uri("https://maven-sdk.unico.run/sdk-mobile")
        }
    }
}

Groovy

Enable AndroidX support in your gradle.properties file at the root of your project (this ensures better performance and operation of the capture framework):

gradle.properties

# Project-wide Gradle settings.
# https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true

2

Camera and Internet Permissions

To use the camera and internet opening method in your project, you need to add the permissions in your file AndroidManifest.xml:

AndroidManifest.xml

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />

Since Android 6, express user permission is required to access camera features, so this request must be made by your application.

3

Adding the Dependency

After configuring the Android SDK, simply import it into your project. To do this, add acessobio-android to the dependencies block in the app/build.gradle file.

• The dependency should be included in a file different from the one used in the previous step. In this step, you need to use the build.gradle file for the module, not the project.

Kotlin

implementation("io.unico:capture:${version}")

Groovy

When compiling the project, you may encounter the following error:

• Invoke-customs are only supported starting with android --min-api 26

This is due to the incompatibility with the min-26 frame version. Add the following lines to the compileOptions block in the same app/build.gradle file:

Kotlin

android { 
    compileOptions { 
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8 
      } 
}

Groovy

4

Obtaining Credentials

• Contact the CS and/or Onboarding team.

• Request the SDK Key by providing the identifiers of your applications: PackageID and SHA-256 for Android.

• The identifiers of your applications will be linked to the SDK Key by the Unico team.

• You will receive your SDK Key to implement the AcessoBioConfigDataSource.

5

Embedding Credentials in Your Project

Implement the AcessoBioConfigDataSource protocol in your class:

Java

package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;

public class UnicoConfig implements AcessoBioConfigDataSource {
    @Override
    public String getBundleIdentifier() {
        return BUNDLE_IDENTIFIER;
    }
        
    @Override
    public String getHostKey() {
        return SDK_KEY;
    }
}

Kotlin