Instalação

Adicione o LivenessFacetecSDK a um projeto Android via Fat AAR

Este guia mostra como adicionar o LivenessFacetecSDK — o pacote que embute o motor FaceTec — ao seu projeto Android.

Pré-requisitos

Antes de começar, garanta que você tem:

• Uma chave de API válida emitida pela Plataforma ID.
• Acesso ao arquivo liveness-facetec-sdk-X.X.X.aar distribuído pela Valid.
• Um projeto Android atendendo aos Requisitos mínimos abaixo.

Requisitos mínimos

Item	Versão mínima
minSdk	23 (Android 6.0)
compileSdk	36
Java toolchain	11
Kotlin	2.3.20
Android Gradle Plugin	9.1.1

O Fat AAR já inclui o FaceTec SDK e todas as bibliotecas internas da Valid. Bibliotecas de terceiros (Koin, Retrofit, OkHttp, etc.) precisam ser declaradas explicitamente pelo app cliente — a lista completa está abaixo.

Instalação

1. Obter o Binário

   Solicite à equipe da Valid o arquivo liveness-facetec-sdk-1.3.0.aar. Ele já contém o FaceTec SDK e todos os módulos internos do LivenessFacetecSDK.

2. Adicionar o AAR ao app

   Copie o AAR para a pasta libs do módulo app:

   seu-projeto/
     app/
       libs/
         liveness-facetec-sdk-1.3.0.aar
       build.gradle.kts
   
3. Configurar repositórios

   No settings.gradle.kts do projeto, declare os repositórios necessários para resolver as dependências externas do SDK:

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           maven { url = uri("https://maven.fpregistry.io/releases") }
       }
   }
   
4. Configurar app/build.gradle.kts

   Declare o AAR junto com as dependências externas obrigatórias:

   plugins {
       alias(libs.plugins.android.application)
       alias(libs.plugins.kotlin.android)
   }
   
   android {
       namespace = "com.example.myapp"
       compileSdk = 36
   
       defaultConfig {
           applicationId = "com.example.myapp"
           minSdk = 23
           targetSdk = 36
   	multiDexEnabled = true
       }
   
       compileOptions {
           sourceCompatibility = JavaVersion.VERSION_11
           targetCompatibility = JavaVersion.VERSION_11
       }
   
       kotlin { jvmToolchain(11) }
   
       buildTypes {
           release {
               isMinifyEnabled = true
               proguardFiles(
                   getDefaultProguardFile("proguard-android-optimize.txt"),
                   "proguard-rules.pro"
               )
           }
       }
   }
   
   dependencies {
       // ── LivenessFacetecSDK (Fat AAR; FaceTec já incluído) ──────────────
       implementation(files("libs/liveness-facetec-sdk-1.3.0.aar"))
   
       // ── Dependências externas obrigatórias ─────────────────────────
       implementation("io.insert-koin:koin-core:4.2.1")
       implementation("io.insert-koin:koin-android:4.2.1")
       implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2")
       implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.11.0")
       implementation("com.squareup.retrofit2:retrofit:3.0.0")
       implementation("com.squareup.okhttp3:okhttp:5.3.2")
       implementation("com.jakewharton.retrofit:retrofit2-kotlinx-serialization-converter:1.0.0")
       implementation("io.sentry:sentry-android:8.38.0")
       implementation("com.fingerprint.android:pro:2.13.1")
   	implementation("com.squareup.okhttp3:logging-interceptor:5.3.2")
   
       // AndroidX
       implementation("androidx.core:core-ktx:1.18.0")
       implementation("androidx.appcompat:appcompat:1.7.1")
       implementation("androidx.activity:activity:1.13.0")
       implementation("com.google.android.material:material:1.13.0")
   }
   
5. Sincronizar e validar

   Sincronize o Gradle (File → Sync Project with Gradle Files no Android Studio). Após o sync, o classpath deve resolver com.vcc.vendor.facetec.sdk.LivenessFacetecSDK.

Faltar qualquer uma das dependências externas resultará em ClassNotFoundException em runtime. Verifique a lista completa antes de rodar o app.

Se o app tiver isMinifyEnabled = true, adicione ao proguard-rules.pro as regras obrigatórias para o R8 Full Mode (AGP 9.x+). Veja Solução de problemas — ProGuard / R8 para os snippets necessários.

Próximos passos

Implementação

Inicialize o SDK e colete o resultado da verificação

Solução de problemas

Erros comuns ao adicionar o AAR e configurar o Gradle