Skip to main content
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

ItemVersão mínima
minSdk23 (Android 6.0)
compileSdk36
Java toolchain11
Kotlin2.3.20
Android Gradle Plugin9.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