Unico IDCloud - DevCenter
HomepageAuthenticationAPIsSDKs
English (United States)
English (United States)
  • Welcome
  • GETTING STARTED
    • Unico IDCloud
    • Capabilities
    • Integration Methods
    • Capabilities and Integration Methods
  • INTEGRATIONS
    • Quickstart
    • Authentication
      • Creating a Service Account
      • Preparing to Make an Authenticated API Request
      • Additional Resources
        • Example in Javascript
        • Authentication Errors
        • Postman Collection
    • Integration by Unico
      • Overview
      • API
        • API Reference
          • CreateProcess
            • CreateProcess separated by flows
          • GetProcess
          • GetSelfie
          • GetEvidenceSet
            • Specification of the evidential set
          • GetDocumentSigned
          • GetEvidenceSign
        • Errors
      • Controlling the experience
        • Redirecting the user
        • SDK
        • QR Code
        • Customizations
      • Additional Resources
        • Postman Collection
        • PoCs available
    • Integration by Client
      • Overview
      • API
        • API Reference
          • Liveness + Identity Verification + Behavior Alert
          • Liveness + Identity Verification + Behavior Alert + Risk Score
          • Liveness + Validation (1:1) + Behavior Alert
          • Document Capture and Reuse
        • Response Scenarios
        • Additional Resources
          • Postman Collection
      • Capture standard (without SDK)
    • Webhook
    • SDK
      • Overview
      • Update Policy
      • SDK Integration
        • Android SDK
          • Installation Guide
          • Usage and Integration Guide
            • Selfie Capture
            • Document Capture
          • Error Handling Guide
          • Android Customization
          • Troubleshooting
          • Release notes
        • iOS SDK
          • Installation Guide
          • Usage and Integration Guide
            • Selfie Capture
            • Document Capture
          • Error Handling Guide
          • iOS Customization
          • Troubleshooting
          • Release notes
        • Flutter SDK
          • Installation Guide
          • Usage and Integration Guide
            • Selfie Capture
            • Document Capture
          • Error Handling Guide
          • Flutter Customization
          • Troubleshooting
          • Release notes
        • Web SDK
          • Installation Guide
          • Usage and Integration Guide
            • Selfie Capture
            • Document Capture
            • Accessibility
          • Error Handling Guide
          • Web Customization
          • Release notes
      • Additional Resources
        • Available PoCs
        • Best Practices for SDK Implementation
  • help & faq
    • Glossary
    • Help Center
Powered by GitBook

Institucional

  • Sobre nós

Copyright © 2024 unico. All rights reserved

On this page
  • Development Environment Preconditions
  • Compatible Devices
  • Installing the Android SDK

Was this helpful?

Export as PDF
  1. INTEGRATIONS
  2. SDK
  3. SDK Integration
  4. Android SDK

Installation Guide

In this section, you will find all the information needed to install the Unico IDCloud platform SDK in your Android applications


Development Environment Preconditions


Your development environment must meet the following prerequisites:

  • 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.6.

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:

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:

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

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" />

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.

app/build.gradle
/* unico */
implementation 'io.unico:capture:$version'

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:

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

4

Obtaining Credentials

  • Contact the CS and/or Onboarding team.

  • Request the SDK Key by providing the identifiers of your applications: Bundle Identifier for iOS, PackageID for Android, and Host for WEB.

  • 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:

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;
    }
}
package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

class UnicoConfig : AcessoBioConfigDataSource {
    override fun getBundleIdentifier(): String {
        return BUNDLE_IDENTIFIER
    }

    override fun getHostKey(): String {
        return SDK_KEY
    }
}
Depracated Method - Java
package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;

public class UnicoConfig implements AcessoBioConfigDataSource {
    @Override
    public String getProjectNumber() {
        return PROJECT_NUMBER;
    }
    
    @Override
    public String getProjectId() {
        return PROJECT_ID;
    }
    
    @Override
    public String getMobileSdkAppId() {
        return MOBILE_SDK_APP_ID;
    }
    
    @Override
    public String getBundleIdentifier() {
        return BUNDLE_IDENTIFIER;
    }
    
    @Override
    public String getHostInfo() {
        return HOST_INFO;
    }
    
    @Override
    public String getHostKey() {
        return HOST_KEY;
    }
}
Deprecated Method - Kotlin
package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

class UnicoConfig : AcessoBioConfigDataSource {
    override fun getProjectNumber(): String {
        return PROJECT_NUMBER
    }

    override fun getProjectId(): String {
        return PROJECT_ID
    }

    override fun getMobileSdkAppId(): String {
        return MOBILE_SDK_APP_ID
    }

    override fun getBundleIdentifier(): String {
        return BUNDLE_IDENTIFIER
    }

    override fun getHostInfo(): String {
        return HOST_INFO
    }

    override fun getHostKey(): String {
        return HOST_KEY
    }
}


PreviousAndroid SDKNextUsage and Integration Guide

Last updated 2 months ago

Was this helpful?

Have version 9 or higher of installed (Google's official development IDE);

Done. Once the SDK installation is complete, proceed to the implementation by reading the following :

Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our .

Usage and Integration Guide
​
Help Center
Android Studio
Guia de uso e integração* | IDCloud APIs
Logo