Instalación

AMBIENTE DE DESARROLLO​

Su entorno de desarrollo debe cumplir con los siguientes prerrequisitos:

• Tener Android Studio versión 9 o superior instalada (IDE de desarrollo oficial de Google);
• Tener Android SDK versión 21 o superior;
• Tenga configurado el repositorio Maven de Unico.

CONFIGURAR REPOSITORIO MAVEN

El SDK de Android está disponible a través de un repositorio de Maven, agréguelo al bloque de repositorios 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()
        jcenter()
        maven { 
            url "https://maven-sdk.unico.run/sdk-mobile" 
        }
    }
}

Habilite la compatibilidad con 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 usar el método de apertura de cámara e Internet en su proyecto, debe 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 de Android, impórtelo en su proyecto. Para hacer esto, agregue accessobio-android al bloque de dependencies del archivo app/build.gradle.

NOTA

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

app/build.gradle

/* unico */
implementation 'com.github.acesso-io:acessobio-android:$version'

ERROR AL COMPILAR

Al compilar el proyecto, si se muestra el error:

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

Debido a la incompatibilidad de la versión del frame min-26. Agregue las siguientes líneas al bloque compileOptions compileOptions, en el mismo archivo app/build.gradle:

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

OBTENER LAS CREDENCIALES​

Para utilizar o SDK Android é necessário obter a credencial SDK Key, uma chave única de identificação do cliente gerada pela equipe da Unico.

1. Entre em contato com o CSs e/ou time de Onboarding.
2. Solicite a SDK Key informando os identificadores de suas aplicações. Bundle Identifier para iOS, PackageID para Android e Host para WEB.
3. Os identificadores de suas aplicações serão vinculados a SDK Key pela equipe da Unico.
4. Você recebe a sua SDK Key para implementar o AcessoBioConfigDataSource

Credenciales (clave API del cliente): método obsoleto

Para importar credenciales (Clave API del cliente) a su proyecto, utilice la siguiente guía:

1. Acceda a su instancia con nombre de usuario y contraseña;
2. Desplácese hacia abajo en la barra de menú y haga clic en el menú Configuración , luego haga clic en el menú Integración y finalmente haga clic en el menú API Key;
3. Para crear API Key, haga clic en + Nueva API Key or o para editar, haga clic en API Key deseada;
4. Si desea utilizar el modo de cámara selfie de prueba de vida de FaceTec, asegúrese de que el campo Usar vivacidad con interacción esté lleno con la opción Sí option. Si está lleno de NO, , o no aparece, comuníquese con el soporte a través del Centro de ayuda y solicite la activación; Para obtener más información sobre SMARTLIVE CON INTERACCIÓN (LIVENESS CON INTERACCIÓN), haga clic [aquí] (https://developers.unico.io/es/docs/check/visaogeralproduto).
5. En el campo Usar autenticación segura en el SDK , seleccione la opción Sí;
6. Expanda la sección Android SDK, agregue el ID del proyecto y el Package Name;
7. Finalmente, haga clic en Guardar;
8. Volver a la sección APIKey;
9. Elija la API Key configurada, en la columna Bundle, haga clic en el botón Descargar;
10. Se abre una nueva sección, selecciona la opción Android;
    NOTA

    Si la pestaña no se abre, verifique que su navegador esté bloqueando las ventanas emergentes.

11. Haga clic en Generar y se abrirá automáticamente una nueva pestaña en su navegador que contiene información del proyecto en formato JSON;
12. Guarde este JSON.

CARGANDO LAS CREDENCIALES A SU PROYECTO​

Para agregar la Clave SDK al proyecto, implemente el protocolo AcessoBioConfigDataSource en su clase.

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

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

Credenciales (clave API del cliente): 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;
    }
}

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

¿Dudas?

¿No encontró algo o aún necesita ayuda? Si ya es cliente o asociado, puede contactarnos a través del Centro de Ayuda.