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 Em CI, use as variáveis de ambiente
~/.gradle/gradle.properties da sua máquina (nunca ao repositório do projeto):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.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.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