1 de 1

Guía de instalación

En esta sección, encontrará toda la información necesaria para la instalación del SDK de la plataforma Unico IDCloud en sus aplicaciones Android.

Requisitos previos del entorno de desarrollo

Es necesario que su entorno de desarrollo cumpla con los siguientes requisitos previos:

Tener la versión del SDK Android en la versión 21 o superior;

Tener configurado el repositorio Maven de Unico.

El componente de captura proporcionado a través del SDK Android es compatible con las versiones iguales o superiores de las siguientes tecnologías:

Android: 5.0 (API 21);
Kotlin: 1.6.

Dispositivos compatibles

Este SDK no funciona en emuladores, solo en dispositivos físicos.

El SDK Android es compatible con la gran mayoría de dispositivos que tengan Android 5.0 (API de nivel 21) o versiones superiores.

La siguiente tabla lista los dispositivos probados en laboratorio, además de la disponibilidad de las extensiones del proveedor/fabricante. Algunas extensiones listadas pueden estar sujetas a APIs o SKUs específicos del fabricante. Haga clic a continuación para ver los dispositivos probados:

Dispositivo

Versión de Android

Resultado de la prueba

Tipo de prueba

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 el SDK Android

Para implementar el SDK Android de la plataforma Unico IDCloud en su aplicación Android, siga los pasos listados a continuación:

Configurando el Repositorio Maven

El SDK Android se proporciona a través de un Repositorio Maven. Agregue al bloque de repositories del archivo build.gradle existente en la raíz de su proyecto:

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

Habilite el soporte para AndroidX en su archivo gradle.properties en la raíz de su proyecto (esto garantiza un mejor rendimiento y funcionamiento del 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

Permisos para el uso de la cámara e internet

Para utilizar el método de apertura de cámara e internet en su proyecto, es necesario agregar los permisos en su archivo AndroidManifest.xml:

AndroidManifest.xml

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

Inclusión de la dependencia

Después de configurar el SDK Android, solo debe importarlo en su proyecto. Para ello, agregue acessobio-android al bloque dependencies del archivo app/build.gradle.

La dependencia debe ser incluida en un archivo diferente al utilizado en el paso anterior. En este paso, es necesario utilizar el archivo build.gradle correspondiente al módulo y no al proyecto:

app/build.gradle

/* unico */
implementation 'io.unico:capture:$version'

Al compilar el proyecto, puede encontrarse con el siguiente error:

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

Esto ocurre por una incompatibilidad con la versión del frame min-26. Agregue las siguientes líneas al bloque compileOptions en el mismo archivo app/build.gradle:

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

Obtención de las credenciales

Póngase en contacto con el equipo de CSs y/o el equipo de Onboarding.
Solicite la SDK Key proporcionando los identificadores de sus aplicaciones: Bundle Identifier para iOS, PackageID para Android y Host para WEB.
Los identificadores de sus aplicaciones serán vinculados a la SDK Key por el equipo de Unico.
Recibirá su SDK Key para implementar el AcessoBioConfigDataSource.

Incorporando las credenciales en su proyecto

Implemente el protocolo AcessoBioConfigDataSource en su clase:

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


import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

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

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

Método obsoleto - 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;
    }
}

Método obsoleto - 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
    }
}

Listo. Una vez finalizada la instalación del SDK, continúe con la implementación leyendo el material Guía de uso e integración a continuación:

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Guía de instalación

En esta sección, encontrará toda la información necesaria para la instalación del SDK de la plataforma Unico IDCloud en sus aplicaciones Android.

Requisitos previos del entorno de desarrollo

Es necesario que su entorno de desarrollo cumpla con los siguientes requisitos previos:

Tener instalada la versión 9 o superior de (IDE oficial de desarrollo de Google);

Tener la versión del SDK Android en la versión 21 o superior;

Tener configurado el repositorio Maven de Unico.

El componente de captura proporcionado a través del SDK Android es compatible con las versiones iguales o superiores de las siguientes tecnologías:

Android: 5.0 (API 21);
Kotlin: 1.6.

Dispositivos compatibles

Este SDK no funciona en emuladores, solo en dispositivos físicos.

El SDK Android es compatible con la gran mayoría de dispositivos que tengan Android 5.0 (API de nivel 21) o versiones superiores.

Dispositivo

Versión de Android

Resultado de la prueba

Tipo de prueba

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 el SDK Android

Para implementar el SDK Android de la plataforma Unico IDCloud en su aplicación Android, siga los pasos listados a continuación:

Configurando el Repositorio Maven

El SDK Android se proporciona a través de un Repositorio Maven. Agregue al bloque de repositories del archivo build.gradle existente en la raíz de su proyecto:

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

Habilite el soporte para AndroidX en su archivo gradle.properties en la raíz de su proyecto (esto garantiza un mejor rendimiento y funcionamiento del 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

Permisos para el uso de la cámara e internet

Para utilizar el método de apertura de cámara e internet en su proyecto, es necesario agregar los permisos en su archivo AndroidManifest.xml:

AndroidManifest.xml

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

Inclusión de la dependencia

Después de configurar el SDK Android, solo debe importarlo en su proyecto. Para ello, agregue acessobio-android al bloque dependencies del archivo app/build.gradle.

La dependencia debe ser incluida en un archivo diferente al utilizado en el paso anterior. En este paso, es necesario utilizar el archivo build.gradle correspondiente al módulo y no al proyecto:

app/build.gradle

/* unico */
implementation 'io.unico:capture:$version'

Al compilar el proyecto, puede encontrarse con el siguiente error:

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

Esto ocurre por una incompatibilidad con la versión del frame min-26. Agregue las siguientes líneas al bloque compileOptions en el mismo archivo app/build.gradle:

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

Obtención de las credenciales

Póngase en contacto con el equipo de CSs y/o el equipo de Onboarding.
Solicite la SDK Key proporcionando los identificadores de sus aplicaciones: Bundle Identifier para iOS, PackageID para Android y Host para WEB.
Los identificadores de sus aplicaciones serán vinculados a la SDK Key por el equipo de Unico.
Recibirá su SDK Key para implementar el AcessoBioConfigDataSource.

Incorporando las credenciales en su proyecto

Implemente el protocolo AcessoBioConfigDataSource en su clase:

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


import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

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

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

Método obsoleto - 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;
    }
}

Método obsoleto - 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
    }
}

Listo. Una vez finalizada la instalación del SDK, continúe con la implementación leyendo el material Guía de uso e integración a continuación:

Guia de uso e integração | Unico IDCloud - DevCenter

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.