Troubleshooting

Resolução de problemas comuns na integração do Liveness Hub SDK para Android

Erros Comuns

Erro: “Duplicate class found”

Causa e Solução

Causa: Conflito de dependências entre bibliotecas.

Solução: Verifique se não há bibliotecas duplicadas e use exclude quando necessário:

implementation("alguma-biblioteca") {
    exclude(group = "grupo.conflitante", module = "modulo")
}

Erro: “ClassNotFoundException”

Causa e Solução

Causa: Dependências externas faltando.

Solução: Verifique se todas as dependências obrigatórias foram adicionadas ao build.gradle.kts. Consulte a página de instalação para a lista completa.

Erro de Inicialização do Koin

Causa e Solução

Causa: SDK inicializado incorretamente ou contexto inválido.

Solução:

1. Certifique-se de chamar LivenessHubSDK.init() no Application.onCreate()
2. Use applicationContext (não activity ou baseContext)

// ✅ Correto
LivenessHubSDK.init(applicationContext = this, config = config)

// ❌ Incorreto
LivenessHubSDK.init(applicationContext = baseContext, config = config)

Erro: “Camera not available”

Causa e Solução

Causa: Câmera em uso por outro app ou não disponível.

Solução:

1. Verifique se outro app não está usando a câmera
2. Confirme que o dispositivo possui câmera frontal
3. Adicione <uses-feature> no manifest:

<uses-feature android:name="android.hardware.camera" android:required="true" />

Configuração de ProGuard/R8

Se estiver usando minificação, adicione as seguintes regras no arquivo proguard-rules.pro:

# Liveness Hub SDK
-keep class com.valid.entry.** { *; }
-keep class com.valid.entry.models.** { *; }
-keep class com.valid.entry.localization.** { *; }

# Koin
-keep class org.koin.** { *; }
-dontwarn org.koin.**

# Retrofit
-keepattributes Signature
-keepattributes *Annotation*
-keep class retrofit2.** { *; }
-dontwarn retrofit2.**

# OkHttp
-keep class okhttp3.** { *; }
-dontwarn okhttp3.**
-dontwarn okio.**

# ML Kit
-keep class com.google.mlkit.** { *; }
-dontwarn com.google.mlkit.**

Checklist de Verificação

Antes de reportar um problema, verifique os itens abaixo:

1. Versão do SDK

   Confirme que está usando a versão mais recente do SDK

2. Dependências

   Todas as dependências obrigatórias estão incluídas no build.gradle.kts

3. Repositórios

   Os repositórios Maven adicionais estão configurados no settings.gradle.kts

4. Inicialização

   O SDK foi inicializado na classe Application.onCreate()

5. Permissões

   As permissões de câmera estão declaradas no AndroidManifest.xml

6. Credenciais

   As credenciais de API estão corretas e válidas

Logs de Debug

Para habilitar logs detalhados durante o desenvolvimento, você pode verificar o Logcat com a tag do SDK:

// Filtrar logs no Logcat
adb logcat | grep "LivenessHub"

Desabilite logs detalhados em builds de produção para evitar exposição de informações sensíveis.

Referências

Instalação

Revise os requisitos e configurações

Implementação

Veja exemplos de código corretos