Skip to main content
Este guia mostra como adicionar o LivenessIdentySDK — o pacote que embute o motor IDENTY Face AI — ao seu projeto Android.

Pré-requisitos

Antes de começar, garanta que você tem:
  • As credenciais (usuário e token) do repositório Maven da Valid e o domínio desse repositório, fornecidos pela equipe da Valid.
  • O package ID (applicationId) e o SHA1 do certificado de assinatura do seu app enviados à equipe da Valid para liberação na licença IDENTY.
  • Um projeto Android atendendo aos Requisitos mínimos abaixo.
O SDK é distribuído em duas coordenadas Maven, ambas publicadas no mesmo repositório da Valid: liveness-identy-sdk e identy-face (o IDENTY Face AI SDK republicado pela Valid). As duas resolvem com as mesmas credenciais.

Requisitos mínimos

Atualize sempre as duas coordenadas juntas: cada versão do liveness-identy-sdk é publicada com a versão de identy-face correspondente, informada nas notas de release.

Instalação

1

Configurar as credenciais do repositório

Adicione as credenciais fornecidas pela Valid ao ~/.gradle/gradle.properties da sua máquina (nunca ao repositório do projeto):
Em CI, use as variáveis de ambiente ORG_GRADLE_PROJECT_vccMobileSdksUsername e ORG_GRADLE_PROJECT_vccMobileSdksPassword.
2

Configurar repositórios

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

Configurar app/build.gradle.kts

Habilite o core library desugaring e declare as duas dependências:
A coordenada identy-face não publica Gradle Module Metadata (.module). O Gradle tenta o .module primeiro, recebe 404 e usa o .pom — esse 404 no log é esperado e inofensivo.
4

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.identy.sdk.LivenessIdentySDK.
Mantenha -dontoptimize no proguard-rules.pro do app consumidor em builds com isMinifyEnabled = true. Veja Solução de problemas — ProGuard / R8 para o detalhamento.
O liveness-identy-sdk depende de org.bouncycastle:bcprov-jdk16:1.46, versão exigida pelo IDENTY Face AI SDK. Se o seu app já usa outra variante do BouncyCastle (bcprov-jdk15to18, bcprov-jdk18on), o build falha com Duplicate class org.bouncycastle.... Nesse caso, exclua a transitiva do SDK:

Permissões

O AAR declara automaticamente as permissões abaixo via manifest merger — nenhuma declaração manual é necessária no app consumidor: A feature android.hardware.camera é declarada com required="false" para não bloquear distribuição em dispositivos sem câmera traseira. A permissão de câmera em runtime é solicitada pelo próprio SDK no início de cada verificação — seu app não precisa pedi-la antes. Veja Implementação.

Manifest merge

Além das permissões, o manifest do SDK é mesclado no seu e afeta o <application> do app:

Licença IDENTY

A licença do IDENTY Face AI é empacotada dentro do AAR e descoberta pelo SDK em runtime — você não fornece nem configura licença. Ela é vinculada ao package ID e ao SHA1 do certificado de assinatura do app, por isso envie esses dados à equipe da Valid antes de testar.
Não adicione nenhum arquivo .lic aos assets/ do seu app. O SDK espera exatamente uma licença no APK final; um arquivo a mais faz a captura falhar com LivenessIdentySDKError.Unknown (“Mais de um arquivo .lic”).

Próximos passos

Implementação

Inicialize o SDK e dispare uma verificação de vivacidade

Solução de problemas

Erros comuns ao configurar o Gradle e dicas de ProGuard