Primeiros passos

Essa página apresenta os primeiros passos para usar nossos SDKs Android. Um código de exemplo pode ser encontrado em nosso Github.

Políticas de privacidade e termos e condições de uso

Ao utilizar nossos SDKs, certifique-se que você concorda com nossas Políticas de privacidade e nossos Termos e condições de uso.

Versões atuais

Estáveis

SDK	Dependência
DocumentDetector	com.combateafraude.sdk:document-detector:6.37.6
PassiveFaceLiveness	com.combateafraude.sdk:passive-face-liveness:5.25.12
FaceAuthenticator	com.combateafraude.sdk:face-authenticator:5.8.13
AddressCheck	com.combateafraude.sdk:address-check:4.0.0

Release Candidates

SDK	Dependência
PassiveFaceLiveness	com.combateafraude.sdk:passive-face-liveness:6.0.0-rc01
FaceAuthenticator	com.combateafraude.sdk:face-authenticator:5.8.5-rc01

Pré requisitos

Configuração	Versão mínima	Motivo(s)
minSdkVersion	21	- 94% de alcance dos dispositivos mundiais, segundo o Google - A versão mínima do CameraX também é a API 21 - Algoritmo de detecção do documento possui API 21 como versão mínima
compileSdkVersion	32	A versão mínima do CameraX também é a API 32
Java version	8	Funções lambda

Configurações do projeto

Adicione essas configurações em seu build.gradle a nível de app:

android {
    ...
    // Habilite o Data Binding, conforme a versão do com.android.tools.build:gradle
    // Se com.android.tools.build:gradle >= 4
    buildFeatures {
        dataBinding = true
    }
    // Se com.android.tools.build:gradle < 4
    dataBinding.enabled = true

    // Compatibilidade com o Java 1.8, permitindo funções lambda
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }

    // Necessário apenas para o DocumentDetector
    aaptOptions {
        noCompress "tflite"
    }
}

Como nossos SDKs utilizam Data Binding em suas activities, é necessário que você ative essa configuração em seu app. A configuração compileOptions é necessária para as funções lambdas internas ao SDK, cujo lançamento ocorreu no Java 8. A configuração de noCompress indica para o compilador não comprimir os arquivos com extensão .tflite, usados no DocumentDetector.

Importando os SDKs

Remotamente

Para importar nossos SDKs, adicione nosso repositório maven em seu build.gradle a nível de projeto:

buildscript {
    ...
}

allprojects {
    repositories {
        ...
        maven { url 'https://repo.combateafraude.com/android/release' }
    }
}

Se estiver utilizando a versão Gradle 7+, adicione o nosso repositório maven no arquivo settings.gradle, ao invés do build.gradle, dentro do método dependencyResolutionManagement:

dependencyResolutionManagement {
    repositories {
        ...
        maven { url 'https://repo.combateafraude.com/android/release' }
    }
}

Após isso, adicione nossas dependências que deseja usar em seu build.gradle a nível de app:

dependencies {
    ...
    implementation 'com.combateafraude.sdk:{sdkName}:{sdkVersion}'
}

Localmente

1. Baixe o arquivo .aar correspondente em nosso repositório e o arquivo .pom correspondente para adicionar as dependências transitivas do SDK diretamente ao seu projeto. Isso é necessário pois o arquivo .aar não carrega junto as dependências transitivas. Para realizar o download, acesse a url, substituindo {sdkName} e {sdkVersion} em https://repo.combateafraude.com/android/release/com/combateafraude/sdk/{sdkName}/{sdkVersion}/{sdkName}-{sdkVersion}.aar

2. Adicione o arquivo .aar no caminho <project_folder>/app/libs.

3. No seu build.gradle a nível de app, adicione a pasta libs como repositório de dependências, adicione o arquivo .aar e todas as dependências transitivas identificadas no passo 1 como dependências de seu app:

android {
    ...
}

dependencies {
    ...
    implementation '{packageName}:{fileName}@aar'
    // implemente as outras dependências transitivas do SDK
}

repositories {
    flatDir {
       dirs 'libs'
    }
}