> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/android/changelog.md). # Registro de alterações ## Notas de versão ## 7.19.0 ### Data de lançamento * 08/14/2026 ### Atualizações * Atualizado `compileSdk` e `targetSdk` para o nível de API 36 (Android 16). * Melhorias no layout da UI e na acessibilidade nas telas do Document Detector e do Face Liveness. * Melhorias na navegação no Document Detector (tratamento do gesto de voltar). ### Correções **Face Liveness:** Corrigido um problema no fluxo do Payface em que uma validação facial com falha ainda podia ser reportada como sucesso. Agora o SDK trata corretamente falhas de validação e exibe a mensagem apropriada ao usuário. **Detector de documentos:** Corrigidos problemas de captura e envio em tablets e dispositivos no modo paisagem, incluindo um breve flash incorreto da orientação da imagem na prévia, falhas de captura automática com fotos finais desalinhadas e pequenos ajustes de interface nas margens do layout e no botão de fechar. ## 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 **Detector de documentos:** 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 UI órfã (botão Continuar inativo). ## 7.15.0 ### Data de lançamento * 07/20/2026 {% hint style="warning" %} **Mudança incompatível — dependência de Fingerprint** A `common-fingerprint` o módulo não é mais uma dependência transitiva obrigatória para o Face Liveness. Para usar recursos de fingerprint junto com o Face Liveness, você deve adicionar explicitamente o `implementation("io.caf.sdk:fingerprint")` artefato às suas dependências. Se omitido, o Face Liveness continuará normalmente sem fingerprint {% endhint %} ### Atualizações * **Atualização do SDK de Fingerprint**: O SDK subjacente FingerprintJS Pro 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 * Módulo Caf Security: otimizações internas de desempenho e maior estabilidade 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 falhava ao renderizar 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 primaryColor, embora nenhum filtro de cor devesse ser aplicado. ## CafSDK v7.10.0 ### Data de lançamento * 03/30/2026 {% hint style="warning" %} **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 customizaçã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 provider são ambos necessários** para o Face Liveness. Veja [Etapa 2 - Inclua a dependência do CafSDK](#step-2-include-the-cafsdk-dependency) e [Migração a partir de artefatos legados do Face Liveness](#migrating-from-legacy-face-liveness-artifacts-up-to-v790). {% endhint %} ### Atualizações * **Liveness Hub:** **`caffaceliveness`** é a base compartilhada e **`caffaceliveness-providers-*`** os artefatos fornecem as integrações de fornecedor pré-construídas da CAF — você deve declarar **pelo menos um** dependência do provider. **`caffaceliveness-ui`** é **opcional** e adiciona **UI de Face Liveness da Caf** além de **customização** hooks (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 [Migração a partir de artefatos legados do Face Liveness](#migrating-from-legacy-face-liveness-artifacts-up-to-v790) ao atualizar de **7.9.0** ou anterior. #### Migração a partir de artefatos legados do Face Liveness (até v7.9.0) Se você usou anteriormente `caffaceliveness-lite`, `caffaceliveness-core`, ou o correspondente `-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 divisão nessa camada foi removida. | | *(os providers eram implícitos no artefato antigo)* | `caffaceliveness-providers-` | **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 de UI: telas da Caf + personalização; combine com a mesma configuração de provedor de 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ão:** 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 debug; a validação pode ser desativada), * 600 (assinaturas fraudulentas/adulteraçã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 {% hint style="warning" %} Versões anteriores à 7.8.0 farão com que o iProov Liveness deixe de funcionar a partir de 12 de março de 2026. Para garantir o funcionamento correto e a continuidade do serviço, use a versão 7.8.0 ou posterior. {% endhint %} ### 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 BOM do CAF SDK: * 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. * **Repositório Maven da Fortface adicionado**: Repositório Maven da Fortface adicionado ao projeto. * Nova dependência disponível: `PayFace` * Comportamento de câmera personalizável por meio de `CafPayFaceConfig` (timeouts, tempos de estabilização, recursos de UI) * Adicione o repositório Maven ao projeto: ```kotlin maven { url = uri("https://cdn-fortface-sdk.fortface.com.br") credentials(HttpHeaderCredentials::class) { name = "X-Sdk" value = "CAF" } authentication { create("header") } } ``` * **Novos tipos de falha**: Adicionada nova falha ao CafFailureType para 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 BOM do CAF SDK: * `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. * Novo sinalizador 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** * Corrigidos erros na criação de sessões. * Corrigido o tom de cor em imagens remotas na tela de instruções. ## CafSDK v7.6.0 ### Data de lançamento * 01/28/2026 ### Correções * **Corrigidos conflitos de Fingerprint**: Resolvidos conflitos de Fingerprint com bloqueadores de anúncios ou DNS público. ## 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 BOM do CAF SDK: * `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 de câmera personalizável por meio de `CafPayFaceConfig` (timeouts, tempos de estabilização, recursos de UI) * Adicione o repositório Maven ao projeto: ```kotlin maven { url = uri("https://cdn-fortface-sdk.fortface.com.br") credentials(HttpHeaderCredentials::class) { name = "X-Sdk" value = "CAF" } authentication { create("header") } } ``` > **Observação:** Entre em contato com nossa equipe de suporte para garantir que o clientId em uso esteja configurado para usar PayFace. ### Correções * **Corrigidas falhas no módulo Document Detector**: Resolvidos múltiplos crashes relacionados ao gerenciamento do ciclo de vida da atividade, incluindo estados de inicialização, pausa e retomada. * **Corrigidas falhas relacionadas ao ciclo de vida da câmera**: Melhorado o gerenciamento de recursos da câmera e o ciclo de vida das threads para evitar crashes durante o encerramento do SDK e as transições de estado. * **Corrigidas falhas em componentes de UI**: Resolvidos problemas de compatibilidade de tema e exceções de transações de fragmentos para garantir o comportamento adequado da UI. * **Corrigidas falhas em requisições de rede**: Corrigido o tratamento do corpo da resposta para evitar erros ao ler respostas de rede. * **Corrigidas falhas no acesso a dados**: Melhorada a inicialização e a validação do cursor antes de acessar dados do banco de dados. * **Corrigido ANR no Document Controller**: Otimizadas as verificações de instância do controlador de documento para evitar problemas de aplicação 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 BOM do CAF SDK: * `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 * **Corrigida falha ao usar vazio `fluxo` em `CafDocumentDetectorConfig`**: Esse problema fazia com que o SDK fosse fechado imediatamente durante a abertura do fluxo de captura de documento. Agora, o SDK emitirá um novo evento de erro `CafErrorType.LIBRARY_EXCEPTION` com a mensagem "Empty document options". * **Corrigido erro ao usar `loadSession` no módulo Document Detector**: Esse problema fazia com que o SDK fosse fechado imediatamente durante a abertura do fluxo de captura de documento. 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 BOM do CAF SDK: * `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 às dificuldades de captura usando o modo automático. * **Logs de analytics**: Adicionados logs detalhados de analytics para monitorar os detalhes de captura e upload de documentos. Esses logs registram mensagens, modos de captura, tempo de fallback e sensores. #### CafFaceLiveness / CafFaceLivenessUI * **Melhoria no tempo de abertura**: Melhorado o tempo de abertura do SDK Face Liveness por meio do pré-carregamento da sessão do usuário, usando um novo método [loadSession()](#session-pre-loading-optional), 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 * **Corrigida falha "Image is already closed"**: Esse problema fazia com que o SDK fosse fechado imediatamente durante a captura de documento. * **Corrigida falha ao usar vazio `fluxo` em `CafDocumentDetectorConfig`**: Esse problema fazia com que o SDK fosse fechado imediatamente durante a abertura do fluxo de captura de documento. Agora, o SDK emitirá um novo evento de erro `CafErrorType.LIBRARY_EXCEPTION` com a mensagem "Empty document options". * **Melhoria nas mensagens de erro**: Melhoradas as mensagens de erro para detecção incorreta do tipo de documento, a fim de fornecer um feedback mais preciso durante a validação do documento. * **Fallback no modo de captura**: Melhorado o gerenciamento de estado para transições de modo de captura, garantindo um comportamento consistente e confiável quando os modos de captura manual e automático interagem. * **Layout**: Melhorada a legibilidade com aumento do espaçamento entre linhas e margens atualizadas para um layout e equilíbrio visual mais consistentes. * **Melhorias na UI**: Evitado o estouro de texto no Document Detector ao habilitar a truncagem de títulos longos e nomes de etapas e ajustar o espaçamento. * **Desativação do sensor de luz**: O sensor de luz foi desativado durante o fluxo de captura. Anteriormente, o SDK usava o sensor de luz do dispositivo para exibir a mensagem "Ambiente muito escuro", bloqueando a captura até que o sensor detectasse boa iluminação. * **Desativação de mensagens durante a captura manual**: As mensagens durante a captura manual foram desativadas para evitar atritos no 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 BOM do CAF SDK: * `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 tratar 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 BOM do CAF SDK: * `DocumentDetector` atualizado de 10.1.0 para 10.2.0 * `DocumentDetectorUI` atualizado de 2.1.0 para 2.2.0 ### Correções * **DocumentDetector**: Corrigido 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**: Resolvidas inconsistências no fluxo de captura manual de documentos, garantindo um comportamento de captura mais previsível e confiável. * **Inconsistências nas mensagens de feedback**: Corrigidas mensagens de feedback inconsistentes para casos envolvendo arquivos que excedem o limite de tamanho permitido. * **Comportamento de fechamento de pop-up**: Melhorado o comportamento de fechamento de pop-up para lidar corretamente com pressionamentos do botão Voltar do Android e cliques fora da janela, 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 BOM do CAF SDK: * `CafFaceLivenessIproovVersion` atualizado de 5.0.0 para 5.0.1 ### Correções * **Melhorias `CafFaceLivenessIproovVersion`**: Resolvidas exceções de compatibilidade ao usar Smart Auth juntamente 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 BOM do CAF SDK: * `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 * **Melhorias `CafSdkEvent`**: Melhorado o relatório de erros em todos os fluxos de liveness facial: distinções mais claras entre rede/servidor, tratamento preciso das permissões da câmera. * **DocumentDetector**: interrompeu a ativação automática da pré-visualização do documento 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 BOM do CAF SDK: * `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 BOM do CAF SDK: * `DocumentDetectorUI` atualizado de 1.8.2 para 1.8.3 ### Correções * **DocumentDetectorUI**: Corrigida 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 BOM do CAF SDK: * `cafFaceLivenessIproovVersion` atualizado de 4.4.3 para 4.4.4 * `cafFaceAuthenticatorVersion` atualizado de 5.3.2 para 5.3.3 * `Document Detector` atualizado de 9.15.4 para 9.15.5 ### Correções * **Correção crítica de falha**: Corrigido NullPointerException em View\.post() * Esse erro fazia com que o SDK fosse encerrado inesperadamente ao alternar entre os fluxos de upload e câmera. * **Estabilidade do SDK**: Impedida a terminação inesperada 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 Document Detector**: 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**: Maior clareza na mensagem de erro do servidor ao extrair e expor cargas brutas de erro * **Compatibilidade com Android 14+**: Atualizado o comportamento de fechamento da tela de carregamento para garantir o funcionamento correto 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** ```kotlin val documentSelectionScreen = CafDocumentDetectorDocumentSelectionScreen( documents = listOf( CafDocument.RGFull() ), groupLabels = CafDocumentGroupLabels( rg = CafDocumentLabel("Título RG personalizado", "Descrição RG personalizada") ), title = "CAF SDK - Título", description = "CAF SDK - Descrição" ) ``` ### 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 para tamanhos de página de 16 KB. * **Migração para LiteRT**: Atualizado de TensorFlow Lite para o LiteRT (Lite Runtime) do Google, seguindo a iniciativa AI Edge do Google. As APIs permanecem as mesmas, garantindo compatibilidade transparente enquanto se beneficia de desempenho melhor 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 habilitar ou desabilitar 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. * Ignora a tela de seleção da origem 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 frontal/traseiro e completos estão disponíveis, o SDK seleciona de forma inteligente os documentos frontal e traseiro na ordem correta. * As opções de documentos digitais têm prioridade e são exibidas primeiro nas telas de seleção. * **Customização aprimorada de diálogos:** Adicionadas novas propriedades de configuração de cores 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` para o modo escuro, `#FFFFFF` para o modo claro) * `dialogBorderColor`: Personalize a cor da borda de diálogos e pop-ups (o padrão é `#E5E5E7`) ### Exemplo de código ```kotlin const colorConfig = CafColorConfiguration( primaryColor: "#FF0000", secondaryColor: "#FFFFFF", contentColor: "#000000", backgroundColor: "#FFFFFF", mediumColor: "#CCCCCC", dialogBackgroundColor: "#FFFFFF", // Novo dialogBorderColor: "#E5E5E7" // Novo ) ``` ### Correções * **Ordenação de documentos**: Corrigida a captura de documento, que estava solicitando a captura do documento aberto após capturar a frente e o verso do documento. * **Captura manual**: Corrigido o sinalizador de captura manual em todos os cenários. ## CafSDK v6.2.1 ### Atualizações * Dependências atualizadas: * Versão 9.12.1 do Document Detector * Melhorias e correções internas. ### Correção * Corrigido crash no fluxo de upload do Document Detector. ## CafSDK v6.2.0 ### Atualizações * Dependências atualizadas: * Versão 9.12.0 do Document Detector * Melhorias nas mensagens de nova tentativa no construtor. * Remoção de limites desnecessários para tentativas. ### Correção * Corrigida a personalização do upload no Document Detector. * Ajustados os atrasos entre as mensagens de nova tentativa. ## CafSDK v6.1.2 ### Atualizações * Dependências atualizadas: * Versão 9.10.0 do Document Detector * Melhorias e correções internas. ### Funcionalidades * 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` definir o número máximo de tentativas para validação de face liveness. * **Tratamento do evento de falha:** Adicionado detalhamento de `Falha` ao caso em `CafUnifiedEvent` com resposta do servidor, tipo de falha e descrição. * **Tratamento do evento de erro:** Adicionado detalhamento de `Erro` ao caso em `CafUnifiedEvent` com resposta do servidor, tipo de erro e descrição. ### Atualizações * Melhorada a diferenciação no tratamento de erros: * Use `CafFailureType` tipo de enum para falhas operacionais específicas de módulos do SDK. * Use `CafErrorType` tipo de enum para erros gerais de execução. ### Mudanças que Quebram Compatibilidade 1. **CafUnifiedEvent** Adicionado caso detalhado de falha 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 ```kotlin Error(response: String, type: CafErrorType, description: String) // Substitui o antigo erro baseado em String ``` 3. Atualização `CafUnifiedEvent.Failure` evento ```kotlin Failure(response: String, type: CafFailureType, description: String) ``` ## 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 que Quebram Compatibilidade 1. **`CafFaceLivenessConfig` Alterações:** * Removido `authBaseUrl`, `livenessBaseUrl`, `certificados` propriedade. Use dentro de `CafReverseProxyConfig` em vez disso. 2. **CafUnifiedEvent** Adicionado caso detalhado de falha 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 * **Análises aprimoradas** * **Personalização da interface do Document Detector:** * Introduzido `CafDDCustomization` contrato e tipos concretos (`CafPreviewCustomization`, `CafDDUploadCustomization`, `MessageSettings`) para permitir sobrescrever textos e imagens padrão em telas específicas do Document Detector (por exemplo, pré-visualização, pop-up de upload, mensagens durante o 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 Document Detector herdam seu tema do global `CafColorConfiguration` definido em `CafSDKConfiguration`, garantindo uma aparência e experiência mais consistentes. ### Mudanças que Quebram Compatibilidade 1. **`CafDocumentDetectorConfig` Alterações:** * Removido `messageSettings` propriedade. Use dentro de `ddCustomizations` em vez disso. * Removido `previewTitle`, `previewSubtitle`, etc., use `CafPreviewCustomization` dentro de `ddCustomizations` da 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 propriedades recém-criadas. 4. **Revise o tema:** * Certifique-se de que seu global `CafColorConfiguration` (em `CafSDKConfiguration`) esteja configurado como desejado, pois os elementos da interface do Document Detector agora usarão principalmente essas cores. ### CafSDK v3.0.0 **Principais mudanças** * **API de resposta unificada:** `CafUnifiedResponse` agora expõe apenas `signedResponse: String` (não mais `Map` resultado). * **Mudanças incompatíveis:** 1. `CafUnifiedResponse` a assinatura do inicializador mudou: sem `result` parâmetro. 2. Propriedade `result` removida; substitua todos os usos por `signedResponse`. * **Atualizado o retry no upload de documento:** em conexões mais lentas ou uploads interrompidos, o fluxo documentDetector passou a integrar uma opção de retry para upload de documento ### Guia de migração 1. Atualize para v3.0.0+. 2. Altere o handler: ``` é CafUnifiedEvent.Success -> { event.response.forEach { log("[SUCCESS] moduleName: ${it.moduleName}") log("[SUCCESS] signedResponse: ${it.signedResponse}") } } ``` 3. **Remova** `response.result` * Todas as referências ao `Map` mapa de resultados devem usar response.`signedResponse` em vez disso. 4. Fluxos do Document Detector * Se você dependia do antigo Map de resultado, migre para analisar 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 uma única `Success(response: List)`. * **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 do DocumentDetector. ### Mudanças que Quebram Compatibilidade * A assinatura de `CafUnifiedEvent.Success` foi alterada para `Success(response: List)`. ### Guia de migração 1. Atualize para v2.0.0+. 2. Altere o handler para esperar um array: ``` é CafUnifiedEvent.Success -> { event.response.forEach { log("[SUCCESS] moduleName: ${it.moduleName}") log("[SUCCESS] result: ${it.result}") } } ``` ## CafSDK v1.4.0 ### Novos recursos * **Apresentando `CafSDKProvider`:** Um ponto de entrada unificado para integrar os módulos Face Liveness e Document Detector com uma única configuração. * **Padrão Builder:** Inicialização simplificada usando `CafSDKProvider.Builder` para uma configuração modular e com segurança de tipos. * **Configuração unificada:** Configure ambos os módulos usando `CafSDKConfiguration`, incluindo a ordem de execução (`presentationOrder`) e o tema da interface (`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 na configuração #### Face Liveness * Personalizar instruções (`CafInstructionsConfiguration`). * Configurar endpoints de proxy reverso (`authBaseUrl`, `livenessBaseUrl`). #### Document Detector * Definir fluxos de captura em várias etapas (`CafDocumentDetectorStep`). * Personalização da interface (`CafDocumentDetectorLayout`, `CafMessageSettings`). * Suporte a proxy (`CafProxySettings`). ### Mudanças que Quebram Compatibilidade * **Novo módulo de integração:** `CafSDK` ### Guia de migração 1. Substitua os inicializadores independentes do módulo por `CafSDKProvider` 2. Use `CafDocumentDetectorStep(stepType:)` em vez dos construtores legados. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/android/changelog.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.