> 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/sdks/sdk-mobile/android-sdk/changelog.md). # Changelog Aqui você encontrará o histórico de versões e atualizações do SDK da Facephi para Android. Recomendamos manter sempre sua integração atualizada para a versão estável mais recente. ## Última versão ### **Versão: 2.11.0** *Setembro de 2026* * Selphi * Nova Versão do Widget: 6.4.0 * SelphID * Nova Versão do Widget: 1.41.4 * Novo parâmetro de entrada que ativa o modo de leitura de códigos de barras quando há dificuldade de leitura (somente ativo na versão MBSDR e com zip de recursos de uma versão > 1.41.4) ``` encodedDataFocusEnabled ``` * Novo parâmetro de saída (somente ativo na versão MBSDR e com zip de recursos de uma versão > 1.41.4) ``` encodedDataImages: List tokenEncodedDataImages: List ``` ### **Versão:** 2.10.0 *Agosto de 2026* * Geral * Nova Versão da biblioteca de design: 2.7.7 * Novo scroll completo de tela em: * Tela de dica prévia * Tela de tutorial * Tela de diagnóstico * Nova cancelação do processo do SDK * Selphi * Nova Versão do Widget: 6.3.0 * SelphID * Nova Versão do Widget: 1.40.0 * NFC * Nova Versão do Widget: 0.3.10 * Melhorias no lançamento do controlador * Captura * Nova Versão do Widget: 1.3.6 * Melhorias no lançamento do controlador FileUploader ### **Versão:** 2.9.0 *Julho de 2026* * Geral * Novas cores para a Personalização * Termos e condições de uso * Criação do novo componente * Tracking * Nova Versão do Widget: 1.4.5 * Eventos para os termos e condições de uso * Selphi * Nova Versão do Widget: 6.2.3 * SelphID * Nova Versão do Widget: 1.39.3 * Phingers * Nova Versão do Widget: 1.4.9 * Atualização de dependências internas * Voz * Inclusão do Widget KMP: 0.1.7 * NFC * Nova Versão do Widget: 0.3.8 * Melhorias na navegação * Melhorias nas telas ### **Versão:** 2.8.1 *Junho de 2026* * Geral * Versão da API: 35 * Atualização de componentes do SDK Android para a linha 2.8.1 * É forçado o uso do OkHttp como motor HTTP no Android para o SDK e Licensing, melhorando a compatibilidade com aplicações que usam dependências antigas de Ktor * Melhoria do Tratamento de erros de 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 do R8/ProGuard em dependências opcionais de Ktor, localização e Error Prone * Melhoria interna dos checks de Release para validar os testes Android no 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 de 2026* * Geral * Versão da API: 35 * Atualização de componentes do SDK Android para a linha 2.8.0 * Melhoria da limpeza de 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
* Captura * Nova Versão do Widget: 1.2.0 * Suporte ao modo somente galeria no File Uploader por meio de `onlyGalleryMode` * Novo limite `maxGalleryImageSizeKb` para rejeitar imagens de galeria muito grandes antes de processá-las * É propagado `maxScannedDocs` ao 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
* 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 legacy 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 * Saneamento dos logs de depuração para evitar rastros sensíveis ou excessivos * Melhoria de compatibilidade com o contrato de resultados e validações criptográficas expostas pelo Widget
* Phingers * Nova Versão do Widget: 1.3.1 * Suporte de novo serviço de Licença no Widget * Correção de rastros de Licença do Widget para manter logs mais consistentes * Phingers TF permite informar `licenseKey`, `product` e `operationId` ao Widget * Melhoria da propagação da configuração de diagnóstico em fluxos remotos
* Widget de vídeo * Nova Versão do Widget compartilhado: 0.0.9 * Centraliza o runtime de Video ID, VideoCall e Video Recording 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 ficam como fachadas públicas e adaptadores de configuração, resultados, erros, analytics e views personalizadas
* Video ID * Migração do runtime de vídeo para um Widget compartilhado de vídeo * Melhoria do cancelamento e da 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
* VideoCall * Migração do runtime de Videochamada para um Widget compartilhado de vídeo * Melhoria do gerenciamento de notificações internas de cancelamento e interrupção * Evita-se iniciar uma Videochamada se já houver outra Videochamada ou uma gravação ativa
* 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 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 recusada `MediaProjection`, o fluxo termina com `PERMISSION_ERROR` sem iniciar a gravação * A trilha do microfone é publicada junto às credenciais de tela quando o áudio está ativado * Ajuste da posição do carimbo de data e hora sobre o frame de gravação * Melhoria do gerenciamento de notificações internas para parar ou cancelar a gravação ### **Versão:** 2.7.0 *Março de 2026* * Geral * Versão da API: 35 * Reforço do controle de ambiente seguro na Inicialização do SDK, no início de 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 checagem 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 * O campo includeIAD é adicionado ao Tracking de selfie
* Captura * 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
* 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 documentais permitidos * Melhorias visuais e de experiência na tela de seleção * Se a aplicação for para segundo plano durante o fluxo, a saída é resolvida corretamente como cancelamento do usuário
* 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
* 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
* NFC * Atualização de dependências internas * jmrtd 0.8.5 * Melhorias na resolução do nome e do número pessoal do titular * Reforço da checagem 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 de 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 * Captura * 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 **\*** * Melhorias em design * Nova Versão do Widget: 1.1.6 * Melhorias no processo de captura * Voz * Correções de fluxo * Melhorias em acessibilidade * NFC * Novos dados criptografados na saída **\*IMPORTANTE:** É necessária uma nova Licença para usar esta versão ### **Versão:** 2.5.0 *Dezembro de 2025* * Geral * Suporte a rotação/landscape no 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 * Captura * 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 * Captura - 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 * Captura - 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 de 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 de 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 * Apagamento 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 * 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 * 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 do iOS * NFC * Melhorias na leitura ### **Versão:** 2.3.3 * 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 * 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 * 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 * Geral * Biblioteca interna Common Design * Ajustes de Proguard * Atualizado o target API 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 IDV Platform (Necessária uma nova Licença) * Fluxo * 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 * Geral * Separação completa entre a ativação da tela de dica prévia e a tela de tutorial. * Adicionado sistema de rastreamento e análise de eventos para interação e navegação. * Novo leitor de licenças. * Voz * 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 * Videochamada * Detecção do processo de gravação de vídeo ativo antes de iniciar * VideoCallScreenSharingManager não precisa do aplicativo. * 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 * SelphID * Nova versão do widget: 1.31.2 ### **Versão:** 2.2.1 * 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 * Geral * Melhorias no gerenciamento de exceções * Atualização de dependências internas * Selphi * Nova versão do widget: 5.16.1 * Adiciona-se 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 * 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 * Videochamada * Melhorias na conectividade * Video Id * Melhorias na conectividade * Video Recording * Melhorias na conectividade ### **Versão:** 2.1.1 * 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 * Captura * Melhorias na captura de documentos ### **Versão:** 2.1.0 * Geral * Melhorias e correções internas * Melhorias de segurança * Melhorias no gerenciamento de dependências internas * Fluxo * 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 * 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 * Videochamada * 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 widget * Captura * Nova captura de documentos ### **Versão:** 2.0.2 * Geral * Melhorias nos tutoriais * Melhorias em UX/UI * Kotlin atualizado de 1.9.24 para 2.0.0 com K2 compiler * Android Gradle Plugin atualizado de 8.3.2 para 8.5.0 * Atualização de dependências menores * Visualizações horizontais para tablets * SelphID * Nova versão 1.25.1 * Tracking * Adicionada conexão por APIKEY * 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 deseja extrair a imagem do rosto e a assinatura * Adiciona-se um parâmetro para alterar a visualização do tutorial e 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 * Geral * SdkConfigurationData correção de texto de "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 * Adicionado à resposta bestImageTokenized * 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 * Geral * Todas as funções de SDKController deixam de ter saída com lambda e passam a ser suspend functions, retornando 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 * Voz * Biblioteca do widget atualizada para a versão 3.13.0 * O UX/UI foi melhorado * Os resultados das verificações foram melhorados ### **Versão:** 1.5.6 * Selphi * Nova versão 5.12.3 ### **Versão:** 1.5.5 * Geral * Ajustes e melhorias de segurança * Selphi e Selphid melhoria do gerenciamento interno de imagens * NFC * Correção do campo Personal Number ### **Versão:** 1.5.4 * Geral * Ajustes e melhorias de segurança * Ajustes de design nas visualizações de tutorial com tela cheia * Selphi * Nova versão 5.12.1 * SelphID * Nova versão 1.23.1 ### **Versão:** 1.5.3 * Geral * Telas de diagnóstico com tentar novamente * Fluxo * Novas funcionalidades * Tema dinâmico * Preview controller * Serviços de cliente e preview * Melhorias * Selphi * Nova versão 5.12.0 * Tutoriais * Envio de bestImage completa para Tracking * 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 * Incidência conhecida: API 34 Android * Captura de QR * Formatos de QR ### **Versão:** 1.5.2 * 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 no tamanho da biblioteca ### **Versão:** 1.5.1 * Geral * Melhorias e correção de erros * Voz * Atualização da biblioteca interna * Ajustes de calibração * Retorno de áudios tokenizados * Phingers * Tracking WSQ * Comportamento * Atualização da biblioteca interna * Melhorias e correções ### **Versão:** 1.5.0 * Compatível com API 34 (Android 14) * Plugins Gradle do Android atualizados (8.1.1) * Versão atualizada de Kotlin utilizada (1.9.10) * Ajustes dos dados de entrada do componente de vídeo * SdkResult melhorado como classe selada * Nomenclatura dos passos de entrada NewOperation #### Versão