Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Changelog

Notas de versão do SDK Android. Acompanhe versões, mudanças incompatíveis, atualizações de dependências, alterações de provedor, correções e notas de migração para Face Liveness e Detector de Documentos.

Notas de versão

7.17.0

Data de lançamento

  • 08/03/2026

Correções

Face Liveness: Corrige um UninitializedPropertyAccessException falha no módulo Face Liveness quando o contexto (lateinit) ainda não foi inicializado

Document Detector: Corrige o caso do Document Detector em que o app retorna após a morte do processo (por exemplo, galeria/Drive ou em segundo plano) e remonta o fluxo sem contexto em memória, deixando uma interface órfã (botão Continuar inativo).

7.15.0

Data de lançamento

  • 07/20/2026

Mudança incompatível — dependência Fingerprint A common-fingerprint módulo não é mais uma dependência transitiva obrigatória para o Face Liveness. Para usar recursos de impressão digital junto com o Face Liveness, você deve adicionar explicitamente o artefato implementation("io.caf.sdk:fingerprint") às suas dependências. Se omitido, o Face Liveness continuará normalmente sem fingerprint

Atualizações

  • Atualização do SDK de Fingerprint: O SDK FingerprintJS Pro subjacente foi atualizado da versão 2.7.0 para 2.15.0.

7.14.0

Data de lançamento

  • 05/25/2026

Correções

Face Liveness: um problema de liveness que causava uma tela de carregamento infinita quando ocorria um erro de inicialização.

Smart Auth: CalledFromWrongThreadException

7.13.0

Data de lançamento

  • 05/08/2026

Atualizações

  • Provedor de liveness atualizado: PayFace para a versão 1.19.2.

Correções

Face Liveness: Resolvido um problema em que o provedor de liveness PayFace falhava na primeira tentativa, funcionando apenas na segunda.

7.12.0

Data de lançamento

  • 04/27/2026

Atualizações

  • Caf Security Module: Otimizações internas de desempenho e estabilidade aprimorada para telemetria de segurança e verificações de integridade de dados.

Correções

Face Liveness: Resolvido um problema em que a Tela de Sucesso não era renderizada após uma tentativa válida de liveness.

CafSDK v7.11.0

Data de lançamento

  • 04/13/2026

Correções

  • Tela de instruções: Corrigido um bug em que imagens remotas personalizadas (via URL) na tela de instruções tanto do Document Detector quanto do Face Liveness estavam sendo pintadas com a primaryColor, embora nenhum filtro de cor devesse ser aplicado.

CafSDK v7.10.0

Data de lançamento

  • 03/30/2026

Mudança incompatível — dependências do Face Liveness: caffaceliveness-lite, caffaceliveness-core, caffaceliveness-ui-lite, e caffaceliveness-ui-core são substituídos por caffaceliveness (base compartilhada), opcional caffaceliveness-ui (UI da Caf + hooks de personalização), e caffaceliveness-providers-*. Você deve adicionar o BoM 7.10.0+ e pelo menos um caffaceliveness-providers-* artefato—caffaceliveness e um módulo de provedor são оба necessários para o Face Liveness. Veja Passo 2 - Inclua a dependência do CafSDK e Migrando dos artefatos legados do Face Liveness.

Atualizações

  • Liveness Hub: caffaceliveness é a base compartilhada e caffaceliveness-providers-* os artefatos fornecem as integrações de fornecedores pré-construídas da CAF — você deve declarar a dependência do pelo menos um provedor. caffaceliveness-ui é opcional e adiciona a UI de Face Liveness da Caf mais hooks de personalização (substituindo o antigo caffaceliveness-ui-lite / caffaceliveness-ui-core split).

  • Provedores explícitos: Adicione os artefatos que correspondem à configuração do seu produto, por exemplo:

    • caffaceliveness-providers-iproov-lite — iProov com Protobuf JavaLite

    • caffaceliveness-providers-iproov-full — iProov com Protobuf Java

    • caffaceliveness-providers-payface — PayFace (Fortface)

    • caffaceliveness-providers-facetec — FaceTec 2D

  • Migração: Siga a tabela de mapeamento de dependências em Migrando dos artefatos legados do Face Liveness ao atualizar de 7.9.0 ou anterior.

Migrando dos artefatos legados do Face Liveness (até v7.9.0)

Se você usou anteriormente caffaceliveness-lite, caffaceliveness-core, ou os correspondentes -ui-lite / -ui-core artefatos, atualize da seguinte forma:

Anterior (até v7.9.0)
A partir da v7.10.0
Observações

implementation(platform("io.caf.sdk:caf-sdk-bom:7.9.0"))

implementation(platform("io.caf.sdk:caf-sdk-bom:7.10.0"))

Atualize o BoM para que as versões fiquem alinhadas com os novos módulos.

caffaceliveness-lite ou caffaceliveness-core

caffaceliveness

Um único módulo base substitui ambos lite e core; a antiga separação nesta camada foi removida.

(os provedores eram implícitos dentro do artefato antigo)

caffaceliveness-providers-<provider>

Obrigatório: declare pelo menos um artefato de provedor para os fornecedores de liveness que você usa (por exemplo iproov-lite, iproov-full, payface, facetec).

caffaceliveness-ui-lite ou caffaceliveness-ui-core

caffaceliveness-ui

Opcional Módulo UI: telas da Caf + personalização; combine com a mesma configuração de provedor que seu runtime precisa.

CafSDK v7.9.1

Data de lançamento

  • 05/25/2026

Correção:

  • Smart Auth: CalledFromWrongThreadException

CafSDK v7.9.0

Data de lançamento

  • 03/02/2026

Melhorias

  • Alinhamento de versões: As bibliotecas internas do produto foram padronizadas para corresponder ao versionamento do CafSDK (v7.9.0). Isso garante melhor compatibilidade e simplifica o gerenciamento de dependências.

Correções

  • Retorno de segurança: Novos códigos de erro adicionados para a seção de segurança:

    • 500 (dispositivo bloqueado devido ao modo de depuração; a validação pode ser desativada),

    • 600 (assinaturas fraudulentas/violação),

    • 601 (dispositivos com root),

    • 602 (erro de validação),

    • 699 (erro de segurança desconhecido)

CafSDK v7.8.0

Data de lançamento

  • 02/09/2026

Versões anteriores à 7.8.0 farão com que o iProov Liveness pare de funcionar a partir de 12 de março de 2026. Para garantir o funcionamento adequado e a continuidade do serviço, use a versão 7.8.0 ou superior.

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.8.0 do CAF SDK BOM:

    • CafFaceLiveness: atualizado de 4.4.0 para 4.6.0

    • CafFaceLivenessUI: atualizado de 2.4.0 para 2.5.0

    • Atualização de dependência: versão do iProov atualizada de 10.2.0 para 11.1.0 no Android.

    • Atualização de dependência: versão do iProov atualizada de 12.2.1 para 13.1.0 no iOS.

  • Adicionado repositório Maven da Fortface: Adicionado o repositório Maven da Fortface ao projeto.

    • Nova dependência disponível: PayFace

    • Comportamento da câmera personalizável por meio de CafPayFaceConfig (timeouts, tempos de estabilização, recursos de UI)

    • Adicione o repositório Maven ao projeto:

  • Novos tipos de falha: Adicionada uma nova falha ao CafFailureType para um melhor tratamento de falhas:

    • BACKGROUND_ISSUE

    • DEVICE_ISSUE

    • EYEWEAR

    • FACE_NOT_FOUND

    • FRAMES_BLURRY

    • MOTION_ISSUE

    • LIGHTING_ISSUES

    • REJECTED

    • SYSTEM_ERROR

    • TIMEOUT

    • USER_NOT_FOUND

    • DEVICE_RESTART

    • PROCESSING_FAULT

CafSDK v7.7.0

Data de lançamento

  • 02/02/2026

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.7.0 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.3.8 para 4.4.0

    • CafFaceLivenessUI atualizado de 2.3.8 para 2.4.0

    • CafDocumentDetector atualizado de 10.4.1 para 10.5.0

    • CafDocumentDetectorUI atualizado de 2.3.3 para 2.4.0

  • Novo módulo CafSecurity: Adicionado um novo módulo com validações de segurança.

    • Nova flag de configuração: enableSecurityModule em CafSdkConfiguration com valor padrão true

  • Métricas e análises: Melhorias na coleta de métricas e análises em todos os SDKs.

Correções

  • FaceLiveness

    • Erros na criação de sessões corrigidos.

    • Corrigido o tom de cor nas imagens remotas na tela de Instruções.

CafSDK v7.6.0

Data de lançamento

  • 01/28/2026

Correções

  • Conflitos de Fingerprint corrigidos: Conflitos de Fingerprint com bloqueadores de anúncios ou DNS público resolvidos.

CafSDK v7.5.9

Data de lançamento

  • 01/12/2026

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.5.9 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.3.3 para 4.3.8

    • CafFaceLivenessUI atualizado de 2.3.3 para 2.3.8

    • CafDocumentDetector atualizado de 10.4.0 para 10.4.1

    • CafDocumentDetectorUI atualizado de 2.3.2 para 2.3.3

  • Novo provedor de Face Liveness: Adicionado suporte ao provedor PayFace (Fortface) como uma solução opcional de Face Liveness.

    • Nova dependência disponível: PayFace

    • Comportamento da câmera personalizável por meio de CafPayFaceConfig (timeouts, tempos de estabilização, recursos de UI)

    • Adicione o repositório Maven ao projeto:

Observação: Entre em contato com nossa equipe de suporte para garantir que o clientId em uso esteja configurado para usar PayFace.

Correções

  • Falhas corrigidas no módulo Document Detector: Várias falhas relacionadas ao gerenciamento do ciclo de vida da activity foram resolvidas, incluindo estados de inicialização, pausa e retomada.

  • Falhas relacionadas ao ciclo de vida da câmera corrigidas: O gerenciamento de recursos da câmera e do ciclo de vida das threads foi aprimorado para evitar falhas durante o encerramento do SDK e transições de estado.

  • Falhas corrigidas em componentes de UI: Problemas de compatibilidade de tema e exceções de transações de fragmentos foram resolvidos para garantir o comportamento adequado da UI.

  • Falhas corrigidas em requisições de rede: O tratamento do corpo da resposta foi corrigido para evitar erros ao ler respostas de rede.

  • Falhas corrigidas no acesso a dados: A inicialização e a validação do cursor foram aprimoradas antes de acessar dados do banco de dados.

  • ANR corrigido no Document Controller: As verificações da instância do controlador de documentos foram otimizadas para evitar problemas de aplicativo sem resposta.

  • Melhorias e correções internas: Melhorias adicionais de estabilidade e correções de bugs.

CafSDK v7.5.2

Data de lançamento

  • 11/27/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.5.2 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.3.0 para 4.3.2

    • CafFaceLivenessUI atualizado de 2.3.0 para 2.3.2

    • DocumentDetector atualizado de 10.3.0 para 10.3.2

    • DocumentDetectorUI atualizado de 2.3.0 para 2.3.2

Correções

  • Falha corrigida ao usar vazio fluxo em CafDocumentDetectorConfig: Esse problema estava fazendo o SDK fechar imediatamente durante a abertura do fluxo de captura de documentos. Agora o SDK emitirá um novo evento de erro CafErrorType.LIBRARY_EXCEPTION com a mensagem "Empty document options".

  • Erro corrigido ao usar loadSession no módulo Document Detector: Esse problema estava fazendo o SDK fechar imediatamente durante a abertura do fluxo de captura de documentos. Agora o sdk não emitirá um erro SEQUENCE_INVALID.

CafSDK v7.5.0

Data de lançamento

  • 11/17/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.5.0 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.2.0 para 4.3.0

    • CafFaceLivenessUI atualizado de 2.2.0 para 2.3.0

    • DocumentDetector atualizado de 10.2.0 para 10.3.0

    • DocumentDetectorUI atualizado de 2.2.0 para 2.3.0

Novos Recursos

Document Detector / Document Detector UI

  • Modo de captura manual como padrão: O modo de captura manual desde o início agora está definido como padrão, devido a dificuldades na captura usando o modo automático.

  • Logs de análise: Adicionados logs detalhados de análise para monitorar a captura de documentos e os detalhes de upload. Esses logs registram mensagens, modos de captura, tempo de fallback e sensores.

CafFaceLiveness / CafFaceLivenessUI

  • Melhoria no tempo de abertura: O tempo de abertura do SDK Face Liveness foi melhorado por meio do pré-carregamento da sessão do usuário, usando um novo método loadSession(), que pode ser usado pelos clientes para obter uma inicialização mais rápida do SDK e da câmera.

Correções

Document Detector / Document Detector UI

  • Falha corrigida "Image is already closed": Esse problema estava fazendo o SDK fechar imediatamente durante a captura de documentos.

  • Falha corrigida ao usar vazio fluxo em CafDocumentDetectorConfig: Esse problema estava fazendo o SDK fechar imediatamente durante a abertura do fluxo de captura de documentos. Agora o SDK emitirá um novo evento de erro CafErrorType.LIBRARY_EXCEPTION com a mensagem "Empty document options".

  • Melhoria na mensagem de erro: A mensagem de erro para detecção incorreta do tipo de documento foi aprimorada para fornecer um feedback mais preciso durante a validação do documento.

  • Fallback no modo de captura: O gerenciamento de estado para transições do modo de captura foi aprimorado para garantir um comportamento consistente e confiável quando os modos de captura manual e automático interagem.

  • Layout: A legibilidade foi aprimorada com maior espaçamento entre linhas e margens atualizadas para um layout e equilíbrio visual mais consistentes.

  • Melhorias na UI: O estouro de texto no detector de documentos foi evitado habilitando truncamento para títulos longos e nomes de etapas e ajustando o espaçamento.

  • Desativação do sensor de luz: O sensor de luz foi desativado durante o fluxo de captura. Antes, o SDK usava o sensor de luz do dispositivo para exibir a mensagem "Ambiente muito escuro", bloqueando a captura até que o sensor detectasse uma boa iluminação.

  • Desativação de mensagens durante a captura manual: As mensagens durante a captura manual foram desativadas para evitar atrito durante o fluxo de captura.

CafSDK v7.4.0

Data de lançamento

  • 11/05/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.4.0 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.1.0 para 4.2.0

    • CafFaceLivenessUI atualizado de 2.1.0 para 2.2.0

Novos Recursos

  • ** Novo CafErrorType enum: FACE_AUTHENTICATION para lidar com erros de autenticação facial.

CafSDK v7.3.0

Data de lançamento

  • 10/27/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.3.0 do CAF SDK BOM:

    • DocumentDetector atualizado de 10.1.0 para 10.2.0

    • DocumentDetectorUI atualizado de 2.1.0 para 2.2.0

Correções

  • DocumentDetector: Corrigido um problema em que a tela congelava ao capturar documentos de passaporte, melhorando a experiência do usuário e a confiabilidade da captura.

  • Comportamento inconsistente na captura manual: Inconsistências no fluxo de captura manual de documentos foram resolvidas, garantindo um comportamento de captura mais previsível e confiável.

  • Inconsistências na mensagem de feedback: Mensagens de feedback inconsistentes foram corrigidas para casos envolvendo arquivos que excedem o limite de tamanho permitido.

  • Comportamento de fechamento de popup: O comportamento de fechamento de popup foi aprimorado para lidar corretamente com pressionamentos do botão Voltar do Android e cliques fora da área, garantindo padrões consistentes de interação com a UI.

CafSDK v7.2.0

Data de lançamento

  • 10/20/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.2.0 do CAF SDK BOM:

    • CafFaceLivenessIproovVersion atualizado de 5.0.0 para 5.0.1

Correções

  • Melhora CafFaceLivenessIproovVersion: Exceções de compatibilidade resolvidas ao usar Smart Auth junto com a biblioteca Face Liveness iProov.

CafSDK v7.1.0

Data de lançamento

  • 10/15/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 7.1.0 do CAF SDK BOM:

    • CafFaceLiveness atualizado de 4.0.0 para 4.1.0

    • CafFaceLivenessUI atualizado de 2.0.0 para 2.1.0

    • DocumentDetector atualizado de 9.15.5 para 10.1.0

    • DocumentDetectorUI atualizado de 2.0.0 para 2.1.0

Correções

  • Melhora CafSdkEvent: Relatórios de erro aprimorados em todos os fluxos de verificação de vivacidade facial: distinções mais claras entre rede/servidor, tratamento preciso de permissões da câmera.

  • DocumentDetector: interrompida a ativação automática da pré-visualização de documentos quando não configurada explicitamente.

CafSDK v6.5.10

Data de lançamento

  • 10/01/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 6.5.10 do CAF SDK BOM:

    • DocumentDetectorUI atualizado de 1.8.3 para 1.8.4

Correções

  • DocumentDetectorUI: Corrigido o fluxo de documentos ao usar documentos RGFront ou CNHFront.

CafSDK v6.5.9

Data de lançamento

  • 09/26/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 6.5.9 do CAF SDK BOM:

    • DocumentDetectorUI atualizado de 1.8.2 para 1.8.3

Correções

  • DocumentDetectorUI: Corrigida a falha ao usar documentos RGFull ou CNHFull.

CafSDK v6.5.8

Data de lançamento

  • 09/25/2025

Atualizações

  • Atualizações de dependência: Versões dos componentes atualizadas para manter a consistência com a versão 6.5.8 do CAF SDK BOM:

    • cafFaceLivenessIproovVersion atualizado de 4.4.3 para 4.4.4

    • cafFaceAuthenticatorVersion atualizado de 5.3.2 para 5.3.3

    • Detector de Documentos atualizado de 9.15.4 para 9.15.5

Correções

  • Correção de crash crítico: Corrigido NullPointerException em View.post()

    • Este erro fazia com que o SDK encerrasse inesperadamente ao alternar entre os fluxos de upload e câmera.

  • Estabilidade do SDK: Evitado encerramento inesperado do SDK ao alternar entre diferentes fluxos de captura

    • Gerenciamento de fluxo aprimorado para garantir transições suaves entre os modos de upload e câmera.

  • Módulo do Detector de Documentos: Atualizada a biblioteca LiteRT da versão 1.0.1 para 1.4.0

    • Corrigido erro UNALIGNED (212) em x86_64/emuladores relacionado ao suporte ao tamanho de página de 16 KB

CafSDK v6.5.7

Correções

  • CafFaceLiveness: Melhorado o relatório de erros de permissão de câmera com classificação distinta de erros para facilitar a depuração

  • Tratamento de Erros: Clareza aprimorada da mensagem de erro do servidor ao extrair e expor payloads brutos de erro

  • Compatibilidade com Android 14+: Atualizado o comportamento de fechamento da tela de carregamento para garantir o funcionamento adequado no Android 14 e versões posteriores

CafSDK v6.5.6

Novos Recursos

  • Novo CafDocumentDetectorDocumentSelectionScreen propriedade:

    • groupLabels para permitir a personalização dos títulos e descrições dos tipos de documento.

    Exemplo de Código

Atualizações

  • Dependências atualizadas:

    • Melhorias e correções internas.

CafSDK v6.5.4

Atualizações

  • Dependências atualizadas:

    • Melhorias e correções internas.

CafSDK v6.5.3

Atualizações

  • Dependências atualizadas:

    • Melhorias e correções internas.

CafSDK v6.5.2

Atualizações

  • Dependências atualizadas:

    • Adicionado suporte a tamanhos de página de 16 KB.

    • Migração para LiteRT: Atualizado do TensorFlow Lite para o LiteRT (Lite Runtime) do Google, seguindo a iniciativa AI Edge do Google. As APIs permanecem as mesmas, garantindo compatibilidade perfeita enquanto se beneficia de melhor desempenho e suporte contínuo ao desenvolvimento.

CafSDK v6.5.1

Atualizações

  • Dependências atualizadas:

    • Inicialização de analytics aprimorada.

    • Melhorias e correções internas.

CafSDK v6.4.2

Atualizações

  • Dependências atualizadas:

    • Aumentada a versão compileSdk/targetSdk para o nível de API 35 (Android 15).

    • Inicialização de analytics aprimorada.

    • Melhorias e correções internas.

CafSDK v6.4.0

Novos Recursos

  • Novo CafSdkConfiguration propriedade:

    • enableTransitionScreens para ativar ou desativar as telas de transição entre os módulos.

  • Melhorias para suporte híbrido (React Native).

CafSDK v6.3.0

Novos Recursos

  • Lógica Aprimorada do Fluxo de Documentos: Quando documentos digitais (RG Digital ou CNH Digital) estão presentes no fluxo, o SDK agora automaticamente:

    • Força a ativação do modo de upload.

    • Pula a tela de seleção da fonte da foto.

    • Vai diretamente para o fluxo de upload para uma experiência de usuário mais fluida.

Atualizações

  • Padrão das Configurações de Upload Alterado: CafDocumentDetectorConfig.instructionsEnabled agora tem como padrão true em vez de false

  • Lógica de Seleção de Documentos: Lógica aprimorada para seleção de documentos RG e CNH:

    • Quando documentos de frente/verso e completos estão disponíveis, o SDK seleciona inteligentemente os documentos de frente e verso na ordem correta.

    • As opções de documentos digitais têm prioridade e são exibidas primeiro nas telas de seleção.

  • Personalização Aprimorada de Diálogos: Adicionadas novas propriedades de configuração de cor para personalizar a aparência de diálogos e pop-ups:

    • dialogBackgroundColor: Personalize a cor de fundo de diálogos e pop-ups (o padrão é uma cor dinâmica com base no estilo da interface: #1C1C1E no modo escuro, #FFFFFF no modo claro)

    • dialogBorderColor: Personalize a cor da borda de diálogos e pop-ups (o padrão é #E5E5E7)

Exemplo de Código

Correções

  • Ordem dos Documentos: Corrigida a captura de documento, que estava solicitando a captura do documento aberto após a captura da frente e do verso do documento.

  • Captura Manual: Corrigida a sinalização de captura manual em todos os cenários.

CafSDK v6.2.1

Atualizações

  • Dependências atualizadas:

    • Versão 9.12.1 do Detector de Documentos

    • Melhorias e correções internas.

Correção

  • Corrigido crash no fluxo de upload do Detector de Documentos.

CafSDK v6.2.0

Atualizações

  • Dependências atualizadas:

    • Versão 9.12.0 do Detector de Documentos

    • Melhorias nas mensagens de retry no construtor.

    • Remoção de limites desnecessários para retries.

Correção

  • Corrigida a personalização de upload no Detector de Documentos.

  • Ajustados os atrasos entre as mensagens de retry.

CafSDK v6.1.2

Atualizações

  • Dependências atualizadas:

    • Versão 9.10.0 do Detector de Documentos

    • Melhorias e correções internas.

Recursos

  • Personalização das mensagens de upload, incluindo textos e cores ajustáveis.

CafSDK v6.0.2

Atualizações

  • Melhorias e correções internas.

CafSDK v6.0.1

Atualizações

  • Melhorias e correções internas.

CafSDK v6.0.0

Novos Recursos

  • Novo maxRetryAttempts método para CafFaceLivenessConfig para definir o número máximo de tentativas de retry para a validação de vivacidade facial.

  • Tratamento do Evento de Falha: Adicionada uma Falha detalhada ao CafUnifiedEvent com resposta do servidor, tipo de falha e descrição.

  • Tratamento do Evento de Erro: Adicionada uma Erro detalhada ao CafUnifiedEvent com resposta do servidor, tipo de erro e descrição.

Atualizações

  • Melhor diferenciação no tratamento de erros:

    • Use CafFailureType tipo enum para falhas operacionais específicas dos módulos do SDK.

    • Use CafErrorType tipo enum para erros gerais de execução.

Mudanças Incompatíveis

  1. CafUnifiedEvent Adicionada uma falha detalhada ao CafUnifiedEvent com resposta do servidor, tipo de falha e descrição.

Guia de Migração

  1. Atualize para v6.0.0.

  2. Atualização CafUnifiedEvent.Error evento

  1. Atualização CafUnifiedEvent.Failure evento

CafSDK v5.0.0

Novos Recursos

  1. Atualização CafFaceLivenessConfig:

    • Novo executeFaceAuth parâmetro adicionado para definir se a autenticação facial deve ser realizada.

    • Novo CafReverseProxyConfig parâmetro para configurar o proxy reverso.

Mudanças Incompatíveis

  1. CafFaceLivenessConfig Alterações:

    • Removido authBaseUrl, livenessBaseUrl, certificates propriedade. Use dentro de CafReverseProxyConfig em vez disso.

  2. CafUnifiedEvent Adicionada uma falha detalhada ao CafUnifiedEvent com resposta do servidor, tipo de falha e descrição.

CafSDK v4.1.0

Novos Recursos

  1. Melhorias para suporte híbrido (React Native)

CafSDK v4.0.1

Novos Recursos

  1. Atualização CafDocumentDetectorConfig:

    • Se você estava usando MessageSettings, crie um CafMessageCustomization objeto, defina suas propriedades e adicione-o ao ddCustomizations array.

Guia de Migração

  1. Atualize para v4.0.1.

  2. Atualização CafDocumentDetectorConfig:

    • Se você estava usando messageSettings, crie um CafMessageCustomization objeto, defina suas propriedades e adicione-o ao ddCustomizations array.

CafSDK v4.0.0

Novos Recursos

  • Analytics Aprimorado

  • Personalização da UI do Detector de Documentos:

    • Introduzido CafDDCustomization contrato e tipos concretos (CafPreviewCustomization, CafDDUploadCustomization, MessageSettings) para permitir substituir textos e imagens padrão em telas específicas do Detector de Documentos (por exemplo, pré-visualização, pop-up de upload, mensagens no fluxo). Isso é configurado por meio da nova ddCustomizations propriedade em CafDocumentDetectorConfig.

    • CafDocument agora inclui customMessage e customOkButtonTitle propriedades para personalizar o pop-up de instruções para cada etapa.

  • Atualização de Tema:

    • as propriedades de cor específicas do Detector de Documentos herdam o tema global de CafColorConfiguration definido em CafSDKConfiguration, garantindo uma aparência e sensação mais consistentes.

Mudanças Incompatíveis

  1. CafDocumentDetectorConfig Alterações:

    • Removido messageSettings propriedade. Use dentro de ddCustomizations em vez disso.

    • Removido previewTitle, previewSubtitle, etc., Use CafPreviewCustomization dentro de ddCustomizations propriedade em vez disso

Guia de Migração

  1. Atualize para v4.0.0+.

  2. Atualização CafDocumentDetectorConfig:

    • Se você estava usando previewTitle, previewSubtitle, etc., crie um CafPreviewCustomization objeto, defina suas propriedades e adicione-o ao ddCustomizations array em CafDocumentDetectorConfig.

    • Se você estava usando messageSettings, adicione-o ao ddCustomizations array.

  3. Atualização CafDocument:

    • Se você precisar personalizar a mensagem do pop-up de instruções ou o texto do botão OK para uma etapa específica, use as novas propriedades criadas.

  4. Revisão do Tema:

    • Garanta que seu CafColorConfiguration (em CafSDKConfiguration) esteja configurado como desejado, pois os elementos da UI do Detector de Documentos agora usarão principalmente essas cores.

CafSDK v3.0.0

Mudanças Principais

  • API de Resposta Unificada: CafUnifiedResponse agora expõe apenas signedResponse: String (sem mais Map<String, Any> result).

  • Mudanças Incompatíveis:

    1. CafUnifiedResponse a assinatura do inicializador mudou: sem parâmetro result .

    2. Propriedade result removida; substitua todos os usos por signedResponse.

  • Retry atualizado no upload de documentos: em conexões mais lentas ou uploads interrompidos, o fluxo documentDetector integrou uma opção de retry para o upload de documentos

Guia de Migração

  1. Atualize para v3.0.0+.

  2. Manipulador de mudanças:

  3. Remova response.result

    • Todas as referências ao mapa Map<String: Any> result devem usar response.signedResponse em vez disso.

  4. Fluxos do Detector de Documentos

    • Se você dependia do antigo mapa result, migre para fazer o parsing do seu JWT a partir de signedResponse.

CafSDK v2.0.0

Novos Recursos

  • Sinalizador de Resultados em Lote: CafSDKConfiguration(waitForAllServices = true) agora agrega todas as respostas dos módulos em um único Success(response: List<CafUnifiedResponse>).

  • Unificado CafUnifiedEvent.Success Atualização: CafUnifiedEvent.Success agora sempre carrega um array de respostas.

  • Melhorias nas telas da UI.

  • Adicionado suporte para upload de documentos com o módulo de UI DocumentDetector.

Mudanças Incompatíveis

  • Assinatura de CafUnifiedEvent.Success alterada para Success(response: List<CafUnifiedResponse>).

Guia de Migração

  1. Atualize para v2.0.0+.

  2. Altere o manipulador para esperar um array:

CafSDK v1.4.0

Novos Recursos

  • Apresentando CafSDKProvider: Um ponto de entrada unificado para integrar os módulos de Vivacidade Facial e Detector de Documentos com uma única configuração.

  • Padrão Builder: Inicialização simplificada usando CafSDKProvider.Builder para configuração modular e com tipagem segura.

  • Configuração Unificada: Configure ambos os módulos usando CafSDKConfiguration, incluindo a ordem de execução (presentationOrder) e o tema da UI (CafColorConfiguration).

  • Consistência Entre Módulos: Autenticação, ambiente e logging compartilhados entre os módulos.

Atualizações da Documentação

  • Guias revisados para integração.

  • Adicionados exemplos detalhados para CafFaceLivenessConfig e CafDocumentDetectorConfig.

Melhorias de Configuração

Vivacidade Facial

  • Personalizar instruções (CafInstructionsConfiguration).

  • Configurar endpoints de proxy reverso (authBaseUrl, livenessBaseUrl).

Detector de Documentos

  • Definir fluxos de captura em várias etapas (CafDocumentDetectorStep).

  • personalização da UI (CafDocumentDetectorLayout, CafMessageSettings).

  • suporte a proxy (CafProxySettings).

Mudanças Incompatíveis

  • Novo Módulo de integração: CafSDK

Guia de Migração

  1. Substitua os inicializadores de módulos independentes por CafSDKProvider

  2. Use CafDocumentDetectorStep(stepType:) em vez de construtores legados.

Atualizado