Guia de instalação

Pré-requisitos do ambiente de desenvolvimento

É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:

Possuir a versão Koala ou superior do Android Studio instalado (IDE oficial de desenvolvimento do Google);
Possuir a versão do SDK Android na versão 21 ou superior;
Possuir o repositório Maven da Unico configurado.

O componente de captura disponibilizado por meio do SDK Android dá suporte às versões igual ou superiores para as tecnologias:

• Android: 5.0 (API 21);

• Kotlin: 1.8.22.

Dispositivos compatíveis

Este SDK não funciona em emuladores, somente em dispositivos físicos.

O SDK Android é compatível com a grande maioria dos dispositivos que possuam Android 5.0 (API de nível 21) ou versões superiores.

A tabela a seguir lista os dispositivos testados em laboratório, além da disponibilidade das extensões do fornecedor/fabricante. Algumas extensões listadas podem estar sujeitas as API ou SKUs específicos do fabricante. Clique abaixo para ver os dispositivos testados:

Dispositivos testados

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)

Instalando o SDK Android

Para implementar o SDK Android da plataforma Unico IDCloud ao seu aplicativo Android, siga o passo a passo listado abaixo:

1

Configurando o Repositório Maven

O SDK Android é disponibilizado através de um Repositório Maven, então, para integrá-lo em seu projeto, adicione ao bloco dependencyResolutionManagement do arquivo settings.gradle.kts existente na raiz do seu projeto:

Kotlin

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

Groovy

Se o seu projeto ainda utiliza a abordagem legada de configuração, faça essa alteração no bloco repositories do arquivo build.gradle existente na raiz do seu projeto:

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

Habilite o suporte ao AndroidX ao em seu arquivo gradle.properties na raiz de seu projeto (isto garante uma melhor performance e funcionamento do frame de captura):

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

Permissões para utilização da Câmera e Internet

Para utilizar o método de abertura de câmera e internet em seu projeto é necessário adicionar as permissões em seu arquivo AndroidManifest.xml:

AndroidManifest.xml

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

Desde o Android 6, a permissão expressa do usuário é necessária para ter acesso aos recursos de câmera, logo, é necessário que essa solicitação seja realizada pela sua aplicação.

3

Inclusão da dependência

Após configurar o SDK Android, basta importá-lo em seu projeto. Para isto, adicione acessobio-android ao bloco dependencies do arquivo app/build.gradle.

• A dependência deve ser incluída em um arquivo diferente do que foi utilizado no passo anterior. Neste passo, é necessário utilizar o arquivo build.gradle referente ao módulo e não ao projeto:

Kotlin

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

Groovy

Ao compilar o projeto, você pode se deparar com o seguinte erro:

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

Por incompatibilidade da versão do frame min-26. Adicione as linhas a seguir ao bloco compileOptions, no mesmo arquivo app/build.gradle:

Kotlin

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

Groovy

4

Obtendo as credenciais

• Entre em contato com o CSs e/ou time de Onboarding.

• Solicite a SDK Key informando os identificadores de suas aplicações. Bundle Identifier para iOS, PackageID para Android e Host para WEB.

• Os identificadores de suas aplicações serão vinculados a SDK Key pela equipe da Unico.

• Você recebe a sua SDK Key para implementar o AcessoBioConfigDataSource.

5

Embarcando as credenciais em seu projeto

Implemente o protocolo AcessoBioConfigDataSource em sua classe:

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