> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile/android-sdk/changelog.md).

# Changelog

## Última versão

### **Versão:** 2.8.1

*Junho 2026*

* Geral
  * Versão da API: 35
  * Atualização dos componentes do SDK Android para a linha 2.8.1
  * O uso de OkHttp é forçado como motor HTTP no Android para o SDK e Licensing, melhorando a compatibilidade com aplicativos que usam dependências antigas do Ktor
  * Melhoria no Tratamento de erros do Licensing quando o cliente HTTP não pode ser inicializado: o fluxo retorna um erro controlado em vez de propagar uma falha interna
  * Regras de consumo atualizadas para reduzir avisos de R8/ProGuard em dependências opcionais do Ktor, localização e Error Prone
  * Melhoria interna dos checks de release para validar os testes Android em Debug e evitar regras ProGuard apenas para testes
  * Dependências base atualizadas:
    * Facephi Security: 1.2.10
    * Facephi Logger: 1.2.3
    * Facephi Tokenizer: 1.1.5
    * Facephi Licensing: 2.6.1
* Tracking
  * Nova versão do widget: 1.4.4
* Selphi
  * Nova versão do widget: 6.2.1
* SelphID
  * Nova versão do widget: 1.39.2
* Phingers
  * Nova versão do widget: 1.3.5

***

## Versões anteriores

### **Versão:** 2.8.0

*Maio 2026*

* Geral
  * Versão da API: 35
  * Atualização dos componentes do SDK Android para a linha 2.8.0
  * Melhoria na limpeza da sessão ao fechar o SDK, incluindo caches internos e callbacks registrados
  * Melhoria na resolução de cores por atributos de tema no Android
  * Dependências base atualizadas:
    * Facephi Security: 1.2.9
    * Facephi Logger: 1.2.3
    * Facephi Tokenizer: 1.1.5
* Tracking
  * Nova versão do widget: 1.4.3
  * Atualização das dependências internas do widget e alinhamento do bridge de integração<br>
* Capture
  * Nova versão do widget: 1.2.0
  * Suporte ao modo apenas galeria no File Uploader por meio de `onlyGalleryMode`
  * Novo limite `maxGalleryImageSizeKb` para rejeitar imagens de galeria grandes demais antes de processá-las
  * É propagado `maxScannedDocs` para o widget como número máximo de documentos ou capturas permitidas
  * Novo erro `IMAGE_TOO_LARGE` (`CAP_862`) quando uma imagem excede o tamanho configurado
  * Nova tela de galeria com textos, iconografia e estados de erro específicos<br>
* NFC
  * Nova versão do widget: 0.2.2
  * O componente delega a leitura NFC e a tokenização ao widget principal, mantendo a fachada pública do SDK
  * As views legadas de conselho prévio e diagnóstico de erro são removidas; a personalização pública fica limitada a bottom sheets
  * São mantidos `showDiagnostic`, `showTutorial` e `showPreviousTip` para controlar a experiência visual do fluxo
  * Correção do progresso por pontos durante a leitura NFC
  * Limpeza dos logs de depuração para evitar rastros sensíveis ou excessivos
  * Melhoria da compatibilidade com o contrato de resultados e validações criptográficas expostas pelo widget<br>
* Phingers
  * Nova versão do widget: 1.3.1
  * Suporte a novo serviço de licença no widget
  * Correção dos rastros de licença do widget para manter logs mais consistentes
  * Phingers TF permite informar `licenseKey`, `produto` e `operationId` ao widget
  * Melhoria na propagação da configuração de diagnóstico em fluxos remotos<br>
* Widget de vídeo
  * Nova versão do widget compartilhado: 0.0.9
  * Centraliza o runtime de Video ID, VideoCall e gravação de vídeo em `com.facephi.video:fphivideo`
  * No Android, o widget contém Activities, permissões, serviços foreground, sockets, streaming de vídeo, MediaProjection e recursos nativos de vídeo
  * Os componentes do SDK permanecem como fachadas públicas e adaptadores de configuração, resultados, erros, analytics e views personalizadas<br>
* Video ID
  * Migração do runtime de vídeo para um widget compartilhado de vídeo
  * Melhoria no cancelamento e na limpeza quando o fluxo é interrompido
  * O identificador de assinatura é propagado ao runtime para distinguir fluxos de Video ID e assinatura
  * Evita-se iniciar Video ID se houver uma Videochamada ou uma gravação ativa<br>
* VideoCall
  * Migração do runtime de Videochamada para um widget compartilhado de vídeo
  * Melhoria no gerenciamento das notificações internas de cancelamento e interrupção
  * Evita-se iniciar uma Videochamada se já houver outra Videochamada ou uma gravação ativa<br>
* Video Recording
  * Migração do runtime de gravação para um widget compartilhado de vídeo
  * Novo parâmetro `enableAudio`, desativado por padrão, para permitir a gravação de áudio durante a gravação de tela
  * Quando `enableAudio=true`, o Android solicita `RECORD_AUDIO` antes da permissão de `MediaProjection`
  * Se o microfone for negado, a tela de permissões do design system é exibida para tentar novamente ou abrir as configurações
  * Se a tela de permissões for fechada ou for negada `MediaProjection`, o fluxo termina com `PERMISSION_ERROR` sem iniciar a gravação
  * A faixa de microfone é publicada junto com as credenciais de tela quando o áudio está ativado
  * Ajuste da posição do carimbo temporal sobre o frame de gravação
  * Melhoria no gerenciamento das notificações internas para interromper ou cancelar a gravação

### **Versão:** 2.7.0

*Março 2026*

* Geral
  * Versão da API: 35
  * Fortalecimento do controle de ambiente seguro na inicialização do SDK, no início dos fluxos, na restauração de sessão e na execução de componentes
  * O método SDKController.securityMode(...) deixa de estar disponível; o controle da verificação de segurança passa para a configuração inicial do SDK e fica reservado para ambientes de desenvolvimento ou demo
  * A propriedade orientation do SDK agora usa SdkViewOrientation, desacoplada do módulo visual
  * A restauração de sessão agora retorna um resultado explícito para facilitar o tratamento de erros
  * Novo erro de fluxo FLOW\_INTERNAL\_ERROR com token para bloqueios internos ou de segurança
  * Normalização do uso de erros internos em diferentes componentes do SDK
  * Melhorias visuais e de comportamento em landscape, rotação e ajuste de views
  * Facephi Security: 1.2.7
  * Facephi Logger: 1.2.2
  * Facephi Tokenizer: 1.1.2
* Tracking
  * Nova versão do widget: 1.4.0
  * Adiciona-se o campo includeIAD ao Tracking da selfie<br>
* Capture
  * Nova versão do widget: 1.1.8
* Selphi
  * Nova versão do widget: 6.1.0
  * Correção na identificação do flavor IAD
  * Envio correto do asset IAD ao Tracking
  * Informa-se explicitamente quando a captura inclui IAD<br>
* SelphID
  * Nova versão do widget: 1.38.0
  * Novo seletor de país e tipo de documento
  * Novos parâmetros para limitar países e tipos de documentos permitidos
  * Melhorias visuais e de experiência na tela de seleção
  * Se o aplicativo for para segundo plano durante o fluxo, a saída é resolvida corretamente como cancelamento do usuário<br>
* Phingers
  * Nova versão do widget: 1.1.7
  * Melhorias na classificação de erros internos
  * Novos ajustes de configuração para template e timeout em fluxos remotos<br>
* Video ID
  * Melhorias no cancelamento do fluxo para finalizar corretamente e evitar erros tardios
  * Ajustes em landscape e na pré-visualização de rotação
  * Correção do tamanho da máscara documental na vertical
  * Novos campos de configuração para validações OCR, qualidade documental e reintentos<br>
* NFC
  * Atualização de dependências internas
    * jmrtd 0.8.5
  * Melhorias na resolução do nome e do número pessoal do titular
  * Fortalecimento da verificação de segurança antes de iniciar o componente
  * Correção SOP-3866: os dados DG11 têm prioridade para obter as informações do titular quando estiverem disponíveis

### **Versão:** 2.6.0

*Fevereiro 2026*

* Geral
  * Versão da API: **35**
  * Melhorias em design e acessibilidade
  * Facephi Security: 1.2.3
  * Facephi Logger: 1.2.2
  * Facephi Tokenizer: 1.1.2
* Tracking
  * Nova versão do widget: 1.2.8
* Capture
  * Nova versão do widget: 1.1.7
* Selphi
  * Nova versão do widget: 6.0.3
* SelphID
  * Nova versão do widget: 1.37.1
* Phingers <mark style="color:laranja;">**\***</mark>
  * Melhorias em design
  * Nova versão do widget: 1.1.6
  * Melhorias no processo de captura
* Voice
  * Correções de fluxo
  * Melhorias em acessibilidade
* NFC
  * Novos dados criptografados na saída

<mark style="color:$danger;">**\*IMPORTANTE:**</mark> <mark style="color:$danger;">É necessária uma nova licença para utilizar esta versão</mark>

### **Versão:** 2.5.0

*Dezembro 2025*

* Geral
  * Suporte à rotação/landscape em SDK e widgets
  * Atualização de dependências:
    * Versão da API: **36**
    * Gradle 8.13
    * Android Gradle Plugin 8.9.3 -> 8.13.1
    * Kotlin 2.1.21 -> 2.2.21
    * Compose 1.9.5/1.9.3
    * Lifecycle 2.10.0
    * Ktor 3.3.2
    * Serialization 1.9.0
    * ZXing 3.5.4
    * Datastore 1.2.0
    * Kover 0.9.3
    * Facephi Security 1.2.0
    * Facephi Logger 1.2.0
    * Facephi Tokenizer 1.1.0
* Tracking
  * Nova versão do widget: 1.2.2
* Capture
  * Nova versão do widget: 1.1.0
* Selphi
  * Nova versão do widget: 5.20.0
* SelphID
  * Nova versão do widget: 1.36.1
* NFC
  * Nova visualização de progresso de leitura em porcentagem e estilo configurável
  * Correções de fluxo e Tratamento de erros na leitura

### **Versão:** 2.4.3

* Selphi
  * Nova versão do widget: 5.20.0

### **Versão:** 2.4.2

* SelphID
  * Nova versão do widget: 1.36.0
* Tracking
  * Nova versão do widget: 1.1.26
* Capture - File Uploader
  * Nova versão do widget: 1.0.2

### **Versão:** 2.4.1

* Geral
  * Melhorias em design
  * Nova versão de Security: 1.1.3
* SelphID
  * Nova versão do widget: 1.35.2
* Selphi
  * Nova versão do widget: 5.19.5
* Tracking
  * Nova versão do widget: 1.1.25
* Video ID
  * Nova versão do Reader: 1.9.6
* NFC
  * Atualização de dependências
  * Melhoria de dados
* Capture - File Uploader
  * Nova versão do widget: 1.0.1

### **Versão:** 2.4.0

* Geral
  * Melhorias em design
  * Nova função para desativar a segurança
  * Nova versão do Tokenizer: 1.0.8
  * Nova versão de Security: 1.1.1
  * Nova versão do Logger: 1.1.1
* SelphID
  * Nova versão do widget: 1.35.0
  * Nova personalização
* Selphi
  * Nova versão do widget: 5.19.1
  * Nova personalização
* Tracking
  * Nova versão do widget: 1.1.22
* Video ID
  * Nova versão do Reader: 1.9.5

### **Versão:** 2.3.6

* Geral
  * Melhorias em design
  * Ampliação das informações nos erros
  * Nova versão do Logger: 1.0.2
  * Nova versão de Security: 1.0.6
* SelphID
  * Nova versão do widget: 1.34.5
* Tracking
  * Nova versão do widget: 1.1.16
* Selphi
  * Nova versão do widget: 5.18.2
* Gravação de vídeo
  * Exclusão da saída
  * Resposta direta nas funções start
  * Atualização de dependências
* Video ID
  * Atualização de dependências
* VideoCall
  * Atualização de dependências
* NFC
  * Atualização de dependências
* Phingers
  * Melhorias no processo
  * Atualização de dependências

### **Versão:** 2.3.5 <a href="#id-235" id="id-235"></a>

* Geral
  * Novos códigos de erro
* SelphID
  * Nova versão do widget: 1.34.1
* Tracking
  * Nova versão do widget: 1.1.12
* Video ID
  * Nova versão do Reader: 1.8.0
  * Nova versão do Helper: 3.27.0

### **Versão:** 2.3.4 <a href="#id-234" id="id-234"></a>

* Geral
  * Melhorias em Acessibilidade
  * Melhorias em telas horizontais
  * Refatoração de erros
* Video ID
  * Nova versão do Reader: 1.7.1
* SelphID
  * Nova versão do widget: 1.33.6
* Design KMP
  * Melhorias nos recursos de iOS
* NFC
  * Melhorias na leitura

### **Versão:** 2.3.3 <a href="#id-233" id="id-233"></a>

* Geral
  * Melhorias em Acessibilidade
  * Melhorias em telas horizontais
  * Nova versão do widget de segurança: 1.0.1
* Video ID
  * Novos modos de lançamento
  * Nova versão do reader: 1.7.0
  * Nova versão do helper: 3.26.13
* SelphID
  * Nova versão do widget: 1.33.4
* Selphi
  * Nova versão do widget: 5.17.5
* Tracking
  * Nova versão do widget: 1.1.10

### **Versão:** 2.3.2 <a href="#id-232" id="id-232"></a>

* Geral
  * Melhorias em Acessibilidade
  * Compatível com 16Kb
* Video ID
  * Validações de OCR de entrada e saída
* Selphi
  * Nova versão do widget: 5.17.3
* SelphID
  * Nova versão do widget: 1.33.1
* VideoCall
  * Novo desenvolvimento para compartilhar tela
* VideoRecording
  * Novo desenvolvimento para compartilhar tela

### **Versão:** 2.3.1 <a href="#id-231" id="id-231"></a>

* Geral
  * Melhorias em Acessibilidade
* Selphi
  * Nova versão do widget: 5.17.2
  * Inclui Tokenizer
* Tracking
  * Nova versão do widget: 1.1.9

### **Versão:** 2.3.0 <a href="#id-230" id="id-230"></a>

* Geral
  * Biblioteca interna Common Design
  * Ajustes de ProGuard
  * API alvo atualizada para 35
  * Android Gradle Plugin 8.9.1
  * Kotlin 2.1.10
  * Melhorias em Acessibilidade
* Tracking
  * Nova versão do widget: 1.1.8
  * Compatível com a IDV Platform (É necessária uma nova licença)
* Flow
  * Ajustes e melhorias
* VideoCall
  * Melhorias de UI
* Video ID
  * Verificação de rosto presente
  * Leitura do OCR do documento apresentado
  * Novos dados de saída

### **Versão:** 2.2.3 <a href="#id-223" id="id-223"></a>

* Geral
  * Separação completa entre a ativação da tela de dicas prévias e a tela de tutorial.
  * Adicionado sistema de Tracking e análise de eventos para interação e navegação.
  * Novo leitor de licenças.
* Voice
  * Atualização de dependências internas
* Phingers
  * Atualização de dependências internas
  * Novo filtro
* Video ID
  * Novo parâmetro de entrada para a seleção de câmera
  * Novo parâmetro de entrada para ativar/desativar a captura automática de rosto
  * Detecção do processo de gravação de vídeo ativo antes de iniciar
* Chamada de vídeo
  * Detecção do processo de gravação de vídeo ativo antes de iniciar
  * VideoCallScreenSharingManager não precisa da aplicação.
  * Detecção de falhas na conexão com a internet
* Video Recording
  * Detecção de falhas na conexão com a internet
* SelphID
  * Novo parâmetro de entrada para ativar a vibração
  * Nova versão do widget: 1.32.2
* Selphi
  * Novo parâmetro de entrada para ativar a vibração
  * Novos parâmetros de entrada para as tentativas de Liveness Move
  * Nova versão do widget: 5.17.1
* License Checker
  * Nova versão do widget: 0.4.0

### **Versão:** 2.2.2 <a href="#id-222" id="id-222"></a>

* SelphID
  * Nova versão do widget: 1.31.2

### **Versão:** 2.2.1 <a href="#id-221" id="id-221"></a>

* Geral
  * Atualização de dependências internas
* Selphi
  * Novo parâmetro de entrada para a seleção de câmera
  * Nova versão do widget: 5.16.2
* Tracking
  * Nova versão 1.1.7
* SelphID
  * Nova versão do widget: 1.31.0

### **Versão:** 2.2.0 <a href="#id-220" id="id-220"></a>

* Geral
  * Melhorias no gerenciamento de exceções
  * Atualização de dependências internas
* Selphi
  * Nova versão do widget: 5.16.1
  * Adiciona-se um parâmetro para a duração da extração
  * Adiciona-se o gerenciamento da orientação
* SelphID
  * Nova versão do widget: 1.30.1

### **Versão:** 2.1.2 <a href="#id-212" id="id-212"></a>

* Geral
  * Melhorias de UX
  * Melhorias na acessibilidade
* SelphID
  * Nova versão do widget: 1.29.0
* Selphi
  * Nova versão do widget: 5.15.5
* Chamada de vídeo
  * Melhorias na conectividade
* Video Id
  * Melhorias na conectividade
* Video Recording
  * Melhorias na conectividade

### **Versão:** 2.1.1 <a href="#id-211" id="id-211"></a>

* Geral
  * Melhorias de UX
* SelphID
  * Nova versão do widget: 1.28.1
* Selphi
  * Nova versão do widget: 5.14.2
* Tracking
  * Nova versão do widget: 1.1.5
* Capture
  * Melhorias na captura de documentos

### **Versão:** 2.1.0 <a href="#id-210" id="id-210"></a>

* Geral
  * Melhorias e correções internas
  * Melhorias de segurança
  * Melhorias no gerenciamento de dependências internas
* Flow
  * Melhorias e correções internas
* Tracking
  * Tracking avançado
  * Melhorias e correções internas
* SelphID
  * Nova versão 1.27.0
* Selphi
  * Nova versão 5.14.1

### **Versão:** 2.0.3 <a href="#id-203" id="id-203"></a>

* Geral
  * Melhorias de acessibilidade
  * Melhorias nas corrotinas dos controladores
  * UI para tablets
  * Criação de telas personalizáveis
* NFC
  * Correção do Security provider
  * Correção de datas
  * Captura de exceções
* Chamada de vídeo
  * Adicionar timeout
* Video ID
  * Controle de erro de rede
  * Adicionar timeouts
  * Detecção de rosto ao iniciar
* SelphID
  * Nova versão 1.26.0.
  * Adicionar tutorial
* Selphi
  * Nova versão 5.13.4
  * Novo campo cropImageDebug
* Tracking
  * Adicionar Tracking ao widget
* Capture
  * Nova captura de documentos

### **Versão:** 2.0.2 <a href="#id-202" id="id-202"></a>

* Geral
  * Melhorias nos tutoriais
  * Melhorias em UX/UI
  * Kotlin atualizado de 1.9.24 para 2.0.0 com o compilador K2
  * Android Gradle Plugin atualizado de 8.3.2 para 8.5.0
  * Atualização de dependências menores
  * Views horizontais para tablets
* SelphID
  * Nova versão 1.25.1
* Tracking
  * Conexão por APIKEY adicionada
  * Versão 2 nos eventos
  * Ajustes de stepSucceed antes dos assets
  * Melhorias na lógica de perdas de conexão
* NFC
  * Melhorias e correções
  * Corrigido "Tag lost error"
  * Melhorias na reconexão
  * Agora é possível escolher se a imagem do rosto e a assinatura devem ser extraídas
  * Adiciona-se um parâmetro para alterar a tela de tutorial e fazê-la mostrar os diferentes documentos
* VideoRecording
  * Ajustes e melhorias na parada do Serviço
* VideoCall
  * Ajustes e melhorias na parada do Serviço
* Selphi
  * Nova versão 5.13.1
  * Adiciona-se à saída o parâmetro livenessDiagnostic

### **Versão:** 2.0.1 <a href="#id-201" id="id-201"></a>

* Geral
  * SdkConfigurationData correção do texto "iaModels" para "aiModels"
  * Melhorias internas de PreviousTips
  * Dependências importantes atualizadas:
    * composeCompilerVersion = 1.5.12
    * androidGradlePlugin = 8.3.2
    * kotlinAndroidGradlePlugin = 1.9.23
* Selphi
  * Nova versão 5.12.3
  * bestImageTokenized é adicionado à resposta
* SelphID
  * Nova versão 1.24.2
* VideoCall
  * Imagem de Timeout atualizada
* Phingers
  * ConfigurationData simplificado
* Tokenizer
  * Nova versão do core 2.0.7

### **Versão:** 2.0.0 <a href="#id-200" id="id-200"></a>

* Geral
  * Todas as funções de SDKController passam de ter output com lambda a serem suspend functions e devolver o resultado de forma síncrona. Para consumi-lo agora será necessário usar uma Coroutine. Se for chamado a partir de um ViewModel, pode-se usar viewModelScore.launch, caso contrário CoroutineScope(Dispatchers.IO).launch
  * A inicialização do SDK agora tem um SDKConfigurationData com os dados que devem ser preenchidos
  * No SDKConfigurationData, você poderá escolher entre LicensingOnline ou LicensingOffline
  * Todos os ConfigurationData com imagens em seu interior foram modificados para alterar o nome dos parâmetros (Image)
* Tracking
  * Ajustes e melhorias
* Voice
  * Biblioteca do Widget atualizada para a versão 3.13.0
  * UX/UI aprimorados
  * Resultados das verificações aprimorados

### **Versão:** 1.5.6 <a href="#id-156" id="id-156"></a>

* Selphi
  * Nova versão 5.12.3

### **Versão:** 1.5.5 <a href="#id-155" id="id-155"></a>

* Geral
  * Ajustes e melhorias de segurança
  * Selphi e SelphID melhoram a gestão interna de imagens
* NFC
  * Correção do campo Número pessoal

### **Versão:** 1.5.4 <a href="#id-154" id="id-154"></a>

* Geral
  * Ajustes e melhorias de segurança
  * Ajustes de layout nas telas de tutorial em tela cheia
* Selphi
  * Nova versão 5.12.1
* SelphID
  * Nova versão 1.23.1

### **Versão:** 1.5.3 <a href="#id-153" id="id-153"></a>

* Geral
  * Telas de diagnóstico com opção de tentar novamente
  * Flow
    * Novas funcionalidades
    * Tema dinâmico
    * Controlador de preview
    * Serviços de cliente e preview
    * Melhorias
* Selphi
  * Nova versão 5.12.0
  * Tutoriais
  * Envio da bestImage completa para rastreamento
* SelphID
  * Nova versão 1.22.3
* Phingers
  * Foi adicionada retroalimentação háptica com vibração
  * Melhorias no tutorial
* NFC
  * Melhorias
* VideoId
  * Melhorias na conexão
  * Ajustes de UX
* VideoCall
  * ScreenSharing
  * Novos estados
  * Melhorias na conexão
* VideoRecording
  * Novos estados
  * Melhorias na conexão
  * Problema conhecido: API 34 Android
* Capturar QR
  * Formatos QR

### **Versão:** 1.5.2 <a href="#id-152" id="id-152"></a>

* Geral
  * Melhorias em telas pequenas
  * Novo SelphiSignController
  * Novo VideoIdSignController
  * Novas classes SDKImage e SDKApplication
* NFC
  * Melhorias
* SelphID
  * 1.21.1
* Selphi
  * 5.11.2
* Voz
  * Melhoria do tamanho da biblioteca

### **Versão:** 1.5.1 <a href="#id-151" id="id-151"></a>

* Geral
  * Melhorias e correção de erros
* Voz
  * Atualização da biblioteca interna
  * Ajustes de calibração
  * Retorno de áudios tokenizados
* Phingers
  * Rastreamento WSQ
* Comportamento
  * Atualização da biblioteca interna
  * Melhorias e correções

### **Versão:** 1.5.0 <a href="#id-150" id="id-150"></a>

* Compatível com API 34 (Android 14)
* Atualizados os plugins Gradle de Android (8.1.1)
* Versão atualizada do Kotlin utilizada (1.9.10)
* Ajustes nos dados de entrada do componente de vídeo
* SdkResult aprimorado como classe selada
* Nomenclatura dos passos de entrada NewOperation

#### Versão