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 de Facephi para Android. Recomendamos manter sempre sua integração atualizada para a versão estável mais recente.

Última versão

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

  • Voice

    • 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 dos 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 do Ktor

    • Melhoria no 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 de 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 dos componentes do SDK Android para a linha 2.8.0

    • Melhoria na 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 da 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 no widget principal, mantendo a fachada pública do SDK

    • São removidas as views legadas de dica prévia e diagnóstico de erro; a personalização pública fica limitada a bottom sheets

    • Mantêm-se 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 traces 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 em primeiro plano, 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 de cancelamento e 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 videoconferência ou uma gravação ativa

  • VideoCall

    • Migração do runtime de videoconferência para um widget compartilhado de vídeo

    • Melhoria no gerenciamento de notificações internas de cancelamento e interrupção

    • Evita-se iniciar uma videoconferência se já houver outra videoconferência 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 for 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 temporal sobre o frame de gravação

    • Melhoria no 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, início de fluxos, restauração de sessão e 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 devolve 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 de documentos 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

    • Novas configurações de template e timeout para fluxos remotos

  • Video ID

    • Melhorias no cancelamento do fluxo para finalizar corretamente e evitar erros tardios

    • Ajustes em landscape e na pré-visualização da 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 número pessoal do titular

    • Reforço da checagem de segurança antes de iniciar o componente

    • Correção SOP-3866: os dados DG11 passam a ter 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

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

  • Geral

    • Suporte à rotação/landscape no SDK e widgets

    • Atualização das 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 dos 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 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

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

  • VideoRecording

    • Novo desenvolvimento para compartilhamento de 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 do 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.

  • 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

  • Videochamada

    • 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

  • Verificador de licença

    • 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 provedor de segurança

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

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

    • Android Gradle Plugin atualizado de 8.3.2 para 8.5.0

    • Atualização de dependências menores

    • Telas 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 da assinatura

    • Adiciona-se um parâmetro para alterar a tela de 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 "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

    • Adiciona-se à resposta bestImageTokenized

  • SelphID

    • Nova versão 1.24.2

  • VideoCall

    • Imagem de Timeout atualizada

  • Phingers

    • ConfigurationData simplificado

  • Tokenizer

    • Nova versão de Core 2.0.7

Versão: 2.0.0

  • Geral

    • Todas as funções de SDKController passam de ter output com lambda para serem funções suspend e devolver o resultado de maneira 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 aprimorado

    • Melhorados os resultados das verificações

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 da gestão interna de imagens

  • NFC

    • Correção do campo Personal Number

Versão: 1.5.4

  • Geral

    • Ajustes e melhorias de segurança

    • Ajustes de layout nas telas de tutorial com fullscreen

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

    • Fluxo

      • Novas funcionalidades

      • Tema dinâmico

      • Controlador de prévia

      • Serviços de cliente e prévia

      • Melhorias

  • Selphi

    • Nova versão 5.12.0

    • Tutoriais

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

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

  • Plugins Gradle de Android atualizados (8.1.1)

  • Versão atualizada do Kotlin utilizada (1.9.10)

  • Ajustes dos dados de entrada do componente de vídeo

  • SdkResult aprimorado como classe selada

  • Nomenclatura das etapas de entrada NewOperation

Versão

AnteriorConfigurações avançadasPróximoiOS SDK

Atualizado