> 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). # Notas de versão Notas de versão do SDK para Android. Acompanhe versões, mudanças incompatíveis, atualizações de dependências, mudanças de provedor, correções e notas de migração para Face Liveness e Document Detector. ## Notas de versão {% hint style="danger" %} Devido a um erro de ofuscação da Payface, as versões **7.22.0** e **7.24.0** foram descontinuadas e não devem mais ser usadas. Para mais informações, entre em contato com nossa equipe de suporte. {% endhint %} ## 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 interface e na acessibilidade nas telas do Document Detector e do Face Liveness. * Melhorias de navegação no Document Detector (tratamento do gesto de voltar). ### Correções **Face Liveness:** Corrigido um problema no fluxo da Payface em que uma validação facial com falha ainda podia ser reportada como sucesso. O SDK agora trata corretamente as falhas de validação e mostra a mensagem apropriada ao usuário. **Document Detector:** Corrigidos problemas de captura e upload em tablets e dispositivos no modo paisagem, incluindo um breve flash de orientação incorreta da imagem na prévia, falhas de captura automática com fotos finais desalinhadas e pequenos ajustes na 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` crash 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 {% hint style="warning" %} **Mudança incompatível — dependência de Fingerprint** O `common-fingerprint` 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 artefato `implementation("io.caf.sdk:fingerprint")` à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 da PayFace falhava na primeira tentativa, funcionando apenas na segunda. ## 7.12.0 ### Data de lançamento * 04/27/2026 ### Atualizações * Módulo de Segurança da Caf: 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 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 o 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 + ganchos 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 ambos necessários** para o Face Liveness. Veja [Etapa 2 - Inclua a dependência do CafSDK](#step-2-include-the-cafsdk-dependency) e [Migrando dos 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 fornecedores pré-criadas da CAF — você deve declarar **pelo menos um** a dependência do provedor. **`caffaceliveness-ui`** é **opcional** e adiciona **a UI de Face Liveness da Caf** mais **personalização** ganchos (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](#migrating-from-legacy-face-liveness-artifacts-up-to-v790) ao atualizar a partir 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 o correspondente `-ui-lite` / `-ui-core` artefatos, atualize da seguinte forma: | Anterior (até v7.9.0) | A partir da v7.10.0 | Notas | | ----------------------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 provedores eram implícitos dentro do 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 que o 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 de depuração; a validação pode ser desativada), * 600 (assinaturas fraudulentas/manipulaçã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 fique inoperante 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 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 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 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: ```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 a CafFailureType para um tratamento de falhas melhor: * `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 analytics**: Melhorias na coleta de métricas e analytics 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 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: ```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 * **Corrigidos travamentos no módulo Document Detector**: Resolvidos vários travamentos relacionados ao gerenciamento do ciclo de vida da activity, incluindo os estados de inicialização, pausa e retomada. * **Corrigidos travamentos relacionados ao ciclo de vida da câmera**: Melhorado o gerenciamento de recursos da câmera e do ciclo de vida das threads para evitar travamentos durante o encerramento do SDK e transições de estado. * **Corrigidos travamentos em componentes de UI**: Resolvidos problemas de compatibilidade de tema e exceções de transação de fragments para garantir o comportamento adequado da UI. * **Corrigidos travamentos em requisições de rede**: Corrigido o tratamento do corpo da resposta para evitar erros ao ler respostas de rede. * **Corrigidos travamentos no acesso a dados**: Melhorada a inicialização e 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 documentos para evitar problemas de aplicativo não respondendo. * **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 * **Corrigido crash ao usar vazio `fluxo` em `CafDocumentDetectorConfig`**: Este problema fazia com que o SDK fechasse 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 "Opções de documento vazias". * **Corrigido erro ao usar `loadSession` no módulo Document Detector**: Este problema fazia com que o SDK fechasse 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 analytics**: Adicionados logs detalhados de analytics para monitorar 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 * **Corrigido crash "Image is already closed"**: Este problema fazia com que o SDK fechasse imediatamente durante a captura de documentos. * **Corrigido crash ao usar vazio `fluxo` em `CafDocumentDetectorConfig`**: Este problema fazia com que o SDK fechasse 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 "Opções de documento vazias". * **Mensagens de erro aprimoradas**: Mensagens de erro aprimoradas para detecção incorreta do tipo de documento, para fornecer feedback mais preciso durante a validação do documento. * **Fallback no modo de captura**: Melhorado o gerenciamento de estado nas transições do modo de captura para garantir um comportamento consistente e confiável quando os modos de captura manual e automático interagem. * **Layout**: Legibilidade aprimorada com espaçamento entre linhas aumentado e margens atualizadas para um layout mais consistente e equilíbrio visual. * **Melhorias na UI**: Evitado overflow de texto no detector de documentos ao habilitar truncamento para 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 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 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 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 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 excediam o limite de tamanho permitido. * **Comportamento de fechamento do popup**: Melhorado o comportamento de fechamento do popup para tratar corretamente pressionamentos do botão voltar do Android e cliques fora, garantindo padrões consistentes de interação na 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`**: Resolvidas exceções de compatibilidade 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`**: Melhorada a comunicação de erros em todos os fluxos de liveness facial: distinções mais claras entre rede/servidor, tratamento preciso de permissão de câmera. * **DocumentDetector**: deixou de ativar automaticamente a prévia do documento quando não configurado 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 BOM 6.5.9 do CAF SDK: * `DocumentDetectorUI` atualizado de 1.8.2 para 1.8.3 ### Correções * **DocumentDetectorUI**: Corrigido o crash 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 BOM 6.5.8 do CAF SDK: * `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 * **Resolução de crash crítico**: Corrigido NullPointerException em View\.post() * Esse erro fazia o SDK encerrar inesperadamente ao alternar entre os fluxos de upload e câmera. * **Estabilidade do SDK**: Impedida a interrupçã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 Detector de Documentos**: Biblioteca LiteRT atualizada da versão 1.0.1 para 1.4.0 * Corrigido erro UNALIGNED (212) em x86\_64/emuladores relacionado ao suporte a tamanho de página de 16 KB ## CafSDK v6.5.7 ### Correções * **CafFaceLiveness**: Relato de erro de permissão da câmera aprimorado, com classificação distinta de erros para melhor depuração * **Tratamento de erros**: Maior clareza na mensagem de erro do servidor por meio da extração e exposição dos payloads brutos de erro * **Compatibilidade com Android 14+**: Comportamento de fechamento da tela de carregamento atualizado 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 documentos. **Exemplo de código** ```kotlin val documentSelectionScreen = CafDocumentDetectorDocumentSelectionScreen( documents = listOf( CafDocument.RGFull() ), groupLabels = CafDocumentGroupLabels( rg = CafDocumentLabel("Custom RG Title", "Custom RG Description") ), title = "CAF SDK - Title", description = "CAF SDK - Description" ) ``` ### 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 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: * A versão do compileSdk/targetSdk foi elevada 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 de 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 fonte da foto. * Vai diretamente para o fluxo de upload para uma experiência do usuário simplificada. ### 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 os documentos de frente/verso e completo estão disponíveis, o SDK seleciona de forma inteligente 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 cores para personalizar a aparência de diálogos e pop-ups: * `dialogBackgroundColor`: Personalize a cor de fundo dos 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 dos 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 documentos, que solicitava a captura do documento aberto após capturar a frente e o verso do documento. * **Captura manual**: Corrigida a flag 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 as novas tentativas. ### Correção * Personalização de upload corrigida 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. ### 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` definir o número máximo de tentativas para validação de face liveness. * **Tratamento do evento de falha:** Adicionado `detalhado` caso de `CafUnifiedEvent` com resposta do servidor, tipo de falha e descrição. * **Tratamento do evento de erro:** Adicionado `Erro` caso de `CafUnifiedEvent` com resposta do servidor, tipo de erro e descrição. ### Atualizações * Diferenciação aprimorada no tratamento de erros: * Use `CafFailureType` tipo de enumeração para falhas operacionais específicas de módulos do SDK. * Use `CafErrorType` tipo de enumeração para erros gerais de execução. ### Mudanças que quebram compatibilidade 1. **CafUnifiedEvent** Adicionado caso de falha detalhado 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`, `certificates` propriedade. Use dentro de `CafReverseProxyConfig` em vez disso. 2. **CafUnifiedEvent** Adicionado caso de falha detalhado 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 aprimoradas** * **Personalização da interface do Document Detector:** * Introduzido `CafDDCustomization` contrato e tipos concretos (`CafPreviewCustomization`, `CafDDUploadCustomization`, `MessageSettings`) para permitir a substituição de textos e imagens padrão em telas específicas do Document Detector (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 Document Detector herdam seu tema da CafColorConfiguration global `CafColorConfiguration` definida em `CafSDKConfiguration`, garantindo uma aparência e sensação 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` 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 sua `CafColorConfiguration` (em `CafSDKConfiguration`) esteja configurada como desejado, pois os elementos de interface do Document Detector agora usarão principalmente essas cores. ### CafSDK v3.0.0 **Mudanças principais** * **API de resposta unificada:** `CafUnifiedResponse` agora expõe apenas `signedResponse: String` (não há mais `Map` resultado). * **Mudanças que quebram compatibilidade:** 1. `CafUnifiedResponse` a assinatura do inicializador foi alterada: sem `resultado` parâmetro. 2. Propriedade `resultado` 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 nova tentativa para o upload de documentos ### Guia de migração 1. Atualize para v3.0.0+. 2. Manipulador de alterações: ``` é CafUnifiedEvent.Success -> { event.response.forEach { log("[SUCCESS] moduleName: ${it.moduleName}") log("[SUCCESS] signedResponse: ${it.signedResponse}") } } ``` 3. **Remova** `response.result` * Todas as referências ao mapa `Map` de resultado devem usar response.`signedResponse` em vez disso. 4. Fluxos do Detector de Documentos * Se você dependia do antigo mapa de resultado, migre para analisar seu JWT de `signedResponse`. ## CafSDK v2.0.0 ### Novos recursos * **Flag de resultados em lote:** `CafSDKConfiguration(waitForAllServices = true)` agora agrega todas as respostas dos módulos em um único `Success(response: List)`. * **Unificado `CafUnifiedEvent.Success` Atualização:** `CafUnifiedEvent.Success` agora sempre carrega um array de respostas. * Melhorias nas telas da interface do usuário. * Adicionado suporte para upload de documentos com o módulo de interface 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 configuração modular e segura em relação a 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 * Personalize as instruções (`CafInstructionsConfiguration`). * Configure endpoints de proxy reverso (`authBaseUrl`, `livenessBaseUrl`). #### Detector de Documentos * Defina 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.