> 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/react-native/changelog.md).

# Histórico de alterações

Notas de versão do SDK React Native. Acompanhe versões, mudanças incompatíveis, atualizações de provider e notas de migração para Certta, Face Liveness e Document Detector.

## Notas de versão

### @caf.io/react-native-sdk\@5.6.0

#### **Data de lançamento**

* 10-26-2026

#### Destaques

* Certta Smart Capture: Novo `useCerttaSmartCapture` hook no Android e iOS. Depois `useCerttaSdk().configureSDK()`, abra o fluxo com `useCerttaSmartCapture().open(configuration)`.
* SDK nativo do Android atualizado para 7.29.1.
* SDK nativo do iOS atualizado para 7.10.0.

#### Mudanças que quebram compatibilidade

* `caf-modules-config.json` agora requer um `módulos` objeto. As flags de módulo de nível superior (`documentDetector`, `faceLiveness`, `documentDetectorUI`, `faceLivenessUI`) não são mais válidas.
* O Smart Capture é configurado como `modules.smartCapture` com `habilitado` e `autoCapture`.

```json
{
  "modules": {
    "documentDetector": true,
    "faceLiveness": true,
    "documentDetectorUI": true,
    "faceLivenessUI": true,
    "smartCapture": {
      "enabled": true,
      "autoCapture": true
    }
  },
  "livenessProviders": ["iproov-lite", "payface", "facetec"],
  "fingerprint": true
}
```

#### Atualizações

* Módulo Smart Capture opcional via `caf-modules-config.json` (`modules.smartCapture.enabled` e `modules.smartCapture.autoCapture`).
* `enableAutoCapture` em `CerttaSmartCaptureConfiguration`. No Android, a captura automática requer o artefato nativo opcional `document-smart-capture-autocapture`.

#### Correções

* Android: o fluxo sequencial do Caf e o Certta Document Detector (core e UI) agora entregam o resultado depois que o sistema operacional encerra o processo do app (por exemplo, enquanto a galeria está aberta durante o upload).
* Document Detector: impede uma falha ao aplicar o foco da câmera antes de a câmera estar vinculada. Herdado do CafSDK Android 7.29.0.
* Face Liveness: transações HTTP e erros de sessão são mapeados para os tipos de erro corretos. Herdado do CafSDK Android 7.29.0 e iOS 7.10.0.

### @caf.io/react-native-sdk\@5.5.0

#### **Data de lançamento**

* 10-13-2026

#### **Destaques**

* SDK nativo do Android atualizado para **7.28.0**, que inclui correções do Document Detector.
* A versão do SDK nativo do iOS permanece inalterada (**7.8.0**).

#### **Correções**

Herdado do CafSDK Android 7.28.0:

* **Document Detector:** O envio de documento não exibe mais uma tela em branco quando o usuário pressiona **voltar** na caixa de diálogo de upload.
* **Document Detector:** Fluxos de captura consecutivos não reutilizam mais o estado do fluxo anterior. Um fluxo configurado para RG não aceita mais CNH.
* **Document Detector:** O módulo agora respeita o ambiente configurado.
* **Document Detector:** O pop-up da tela de instruções não corta mais o botão de confirmação.
* **Face Liveness Lite:** A tela do iProov permanece visível até que o resultado seja entregue. O endereço do BFF é resolvido com base na região no token e é restrito a `*.caf.io`.

### @caf.io/react-native-sdk\@5.4.0

#### Data de lançamento

* 09-29-2026

#### Destaques

* **Certta DevX (primeiro lançamento híbrido):** Novo `useCerttaSdk` hook com Document Detector e Face Liveness (core e UI) no Android e iOS.
* Configure a sessão uma vez com `configureSDK(CerttaConfiguration)`, depois abra cada módulo independentemente via `useCafFaceLiveness().open()`, `useCafDocumentDetector().open()`e `useCafDocumentDetectorUI().open()`.
* O sequencial `useCafSdk` a API continua disponível no mesmo pacote.
* SDK nativo do Android atualizado para 7.26.0.
* SDK nativo do iOS atualizado para 7.8.0.

#### Atualizações

* Eventos Certta por módulo no hook `evento` estado (`CerttaLivenessEvent`, `CerttaEvent`).
* Logs da sessão coletados em `useCerttaSdk().logs`.
* Em tempo de execução `updateUserId` / `updateMobileToken` após a configuração inicial da sessão.
* `CerttaLivenessFailure` com estáveis `causa` códigos e `descrição` para texto exibido ao usuário.
* As rejeições do mapeador da bridge são rejeitadas com `CerttaPlatformException` e código `BRIDGE_EXCEPTION`.
* As atualizações da bridge estão alinhadas com os commons nativos do Certta (incluindo propagação da plataforma React Native).

Veja o [Guia de Instalação](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/installation-guide.md) e [Migração do CafSdk](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/migrating-from-cafsdk.md).

### @caf.io/react-native-sdk\@5.2.0

#### Data de lançamento

* 08-14-2026

#### Destaques

* **Compatibilidade com Android 16:** Módulo React Native atualizado para oferecer suporte ao Android 16 (`compileSdk` / `targetSdk` 36).
* SDK nativo do Android atualizado para 7.19.0.
* SDK nativo do iOS atualizado para 7.4.1.

#### Correções

* **Face Liveness:** Corrigido o fluxo do Payface que reportava sucesso em caso de falha de validação.
* **Document Detector:** Corrigidos problemas de captura e upload em tablets e dispositivos em modo paisagem.

As notas de versão mais antigas (5.1.0, 5.0.0 e anteriores) são preservadas em [Introdução legada ao SDK](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/getting-started-with-the-sdk.md#release-notes).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/changelog.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
