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.

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:

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.

AnteriorSDK Android PróximoGuía de uso e integración

Atualizado há 4 dias

Isto foi útil?