Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

    • 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 *

    • 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

*IMPORTANTE: É necessária uma nova licença para utilizar esta versão

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

  • 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 de 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

    • 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

  • 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

  • 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 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • Selphi

    • Nova versão 5.12.3

Versão: 1.5.5

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

AnteriorGravação de vídeo
PróximoiOS SDK

Atualizado