Instalação

AMBIENTE DE DESENVOLVIMENTO

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

• Possuir a versão 9 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.

CONFIGURAR REPOSITÓRIO MAVEN

O SDK Android é disponibilizado através de um Repositório Maven, adicione ao bloco repositories do arquivo build.gradle existente na raiz do seu projeto:

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

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

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.

NOTA

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:

app/build.gradle

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

ERRO AO COMPILAR

Ao compilar o projeto, se o erro for exibido:

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:

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

OBTENDO AS CREDENCIAIS

Para utilizar o SDK Android é necessário importar as credenciais (Client API Key) em seu projeto. Utilize o guia a seguir para gerar e importar as credenciais:

1. Acesse a sua instância com o login e senha;
2. Role a barra de menus para baixo e clique no menu Configurações, em seguida clique no menu Integração e por fim clique no menu API Key;
3. Para criar uma API Key clique em + Nova API Key ou para editar clique sob a API Key desejada;
4. Se desejar utilizar o modo câmera de selfie com prova de vida da FaceTec, verifique se o campo Utiliza liveness com interação está preenchido com a opção SIM. Se estiver preenchido com NÃO, ou não estiver aparecendo, entre em contato com o suporte através da Central de ajuda e solicite a ativação; Para mais informações sobre SMARTLIVE COM INTERAÇÃO (LIVENESS COM INTERAÇÃO), clique aqui.
5. No campo Utiliza autenticação segura na SDK selecione a opção Sim;
6. Expanda a seção SDK Android, adicione a identificação do projeto e o Package Name;
7. Por fim, clique em Salvar;
8. Volte para a seção APIKey;
9. Escolha a API Key configurada, na coluna Bundle, clique no botão de Download;
10. Uma nova seção é aberta, selecione a opção Android;
    NOTA

    Se a aba não abrir, verifique se o seu navegador está bloqueando os pop-ups.

11. Clique em Gerar e automaticamente uma nova aba é aberta em seu navegador contendo informações do projeto em formato JSON;
12. Salve esse JSON.

EMBARCANDO AS CREDENCIAIS EM SEU PROJETO

Existem duas opções para embarcar as informações contidas no JSON ao projeto:

• Implementando o protocolo AcessoBioConfigDataSource (Método recomendado);
• Embarcando o arquivo JSON (Método depreciado).

IMPLEMENTANDO O PROTOCOLO AcessoBioConfigDataSource (MÉTODO RECOMENDADO)

Implemente o protocolo AcessoBioConfigDataSource em sua classe.

Copie e cole as informações contidas no JSON em seus respectivos métodos:

Arquivo JSON

{
    "project_info":{
        "project_number":"<YOUR_PROJECT_NUMBER>",
        "project_id":"<YOUR_PROJECT_ID>"
    },
    "client_info":{
        "mobilesdk_app_id":"<YOUR_MOBILE_SDK_APP_ID>",
        "ios_client_info":{
            "bundle_identifier":"<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
        }
    },
    "host_info":{
        "host_info":"<YOUR_HOST_INFO>",
        "host_key":"<YOUR_HOST_KEY>"
    }
}

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

EMBARCANDO O ARQUIVO JSON (MÉTODO DEPRECIADO)

Adicione o arquivo salvo na pasta assets do seu projeto.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.