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

Changelog

Here you will find the version history and updates of the Facephi SDK for Android. We recommend always keeping your integration updated to the latest stable version.

Latest version

Version: 2.10.0

August 2026

  • General

    • New design library version: 2.7.7

    • New full-screen scroll in:

      • Previous tip screen

      • Tutorial screen

      • Diagnostic screen

    • New cancellation of the SDK process

  • Selphi

    • New Widget version: 6.3.0

  • SelphID

    • New Widget version: 1.40.0

  • NFC

    • New Widget version: 0.3.10

    • Improvements in the controller launch

  • Capture

    • New Widget version: 1.3.6

    • Improvements in the FileUploader controller launch

Version: 2.9.0

July 2026

  • General

    • New colors for Customization

  • Terms and conditions of use

    • Creation of the new component

  • Tracking

    • New Widget version: 1.4.5

    • Events for the terms and conditions of use

  • Selphi

    • New Widget version: 6.2.3

  • SelphID

    • New Widget version: 1.39.3

  • Phingers

    • New Widget version: 1.4.9

    • Internal dependencies updated

  • Voice

    • Inclusion of the KMP Widget: 0.1.7

  • NFC

    • New Widget version: 0.3.8

    • Navigation improvements

    • Improvements to the screens

Version: 2.8.1

June 2026

  • General

    • API Version: 35

    • Update of Android SDK components to line 2.8.1

    • The use of OkHttp is enforced as the HTTP engine on Android for the SDK and Licensing, improving compatibility with applications that use old Ktor dependencies

    • Improved Error handling in Licensing when the HTTP client cannot be initialized: the Flow returns a controlled error instead of propagating an internal failure

    • Consumption rules updated to reduce R8/ProGuard warnings in optional Ktor, location, and Error Prone dependencies

    • Internal improvement to Release checks to validate Android tests in Debug and avoid ProGuard rules for tests only

    • Base dependencies updated:

      • Facephi Security: 1.2.10

      • Facephi Logger: 1.2.3

      • Facephi Tokenizer: 1.1.5

      • Facephi Licensing: 2.6.1

  • Tracking

    • New widget Version: 1.4.4

  • Selphi

    • New widget Version: 6.2.1

  • SelphID

    • New widget Version: 1.39.2

  • Phingers

    • New widget Version: 1.3.5

Previous versions

Version: 2.8.0

May 2026

  • General

    • API Version: 35

    • Update of Android SDK components to line 2.8.0

    • Improvement of session cleanup when closing the SDK, including internal caches and registered callbacks

    • Improved color resolution by theme attributes in Android

    • Base dependencies updated:

      • Facephi Security: 1.2.9

      • Facephi Logger: 1.2.3

      • Facephi Tokenizer: 1.1.5

  • Tracking

    • New widget Version: 1.4.3

    • Update of the widget's internal dependencies and alignment of the integration bridge

  • Capture

    • New widget Version: 1.2.0

    • Support for gallery-only mode in File Uploader through onlyGalleryMode

    • New limit maxGalleryImageSizeKb to reject overly large gallery images before processing them

    • Is propagated maxScannedDocs to the widget as the maximum number of allowed documents or captures

    • New error IMAGE_TOO_LARGE (CAP_862) when an image exceeds the configured size

    • New gallery screen with specific text, iconography, and error states

  • NFC

    • New widget Version: 0.2.2

    • The component delegates NFC reading and tokenization to the main widget, keeping the SDK's public facade

    • Legacy previous tip and error diagnosis views are removed; public Customization is limited to bottom sheets

    • They are kept showDiagnostic, showTutorial and showPreviousTip to control the visual experience of the Flow

    • Fix for dotted progress during NFC reading

    • Sanitization of debug logs to avoid sensitive or excessive traces

    • Improved compatibility with the results contract and cryptographic validations exposed by the widget

  • Phingers

    • New widget Version: 1.3.1

    • Support for the new License service in the widget

    • Fix for widget License traces to keep logs more consistent

    • Phingers TF allows reporting licenseKey, product and operationId to the widget

    • Improved diagnostic configuration propagation in remote Flows

  • Video Widget

    • New shared widget Version: 0.0.9

    • Centralizes the runtime of Video ID, VideoCall and Video Recording in com.facephi.video:fphivideo

    • On Android the widget contains Activities, permissions, foreground services, sockets, video streaming, MediaProjection and native video resources

    • The SDK components remain as public facades and configuration, results, errors, analytics, and custom view adapters

  • Video ID

    • Migration of the video runtime to a shared video widget

    • Improved cancellation and cleanup when the Flow is interrupted

    • The signature identifier is propagated to the runtime to distinguish Video ID and signature Flows

    • Video ID is prevented from starting if there is a video call or an active recording

  • VideoCall

    • Migration of the video call runtime to a shared video widget

    • Improved management of internal cancellation and interruption notifications

    • A video call is prevented from starting if there is already another video call or an active recording

  • Video Recording

    • Migration of the recording runtime to a shared video widget

    • New parameter enableAudio, disabled by default, to allow audio recording during screen recording

    • When enableAudio=true, Android requests RECORD_AUDIO before the MediaProjection

    • If the microphone is denied, the design system permissions screen is shown to retry or open settings

    • If the permissions screen is closed or rejected MediaProjection, the Flow ends with PERMISSION_ERROR without starting the recording

    • The microphone track is published together with the screen credentials when audio is enabled

    • Adjustment of the timestamp position over the recording frame

    • Improved management of internal notifications to stop or cancel the recording

Version: 2.7.0

March 2026

  • General

    • API Version: 35

    • Strengthening of secure environment checks in SDK Initialization, Flow start, session restoration and component execution

    • The SDKController.securityMode(...) method is no longer available; security check control moves to the SDK initial configuration and is reserved for development or demo environments

    • The SDK's orientation property now uses SdkViewOrientation, decoupled from the visual module

    • Session restoration now returns an explicit result to ease Error handling

    • New FLOW_INTERNAL_ERROR Flow error with token for internal or security blocks

    • Normalization of the use of internal errors in different SDK components

    • Visual and behavior improvements in landscape, rotation and view fitting

    • Facephi Security: 1.2.7

    • Facephi Logger: 1.2.2

    • Facephi Tokenizer: 1.1.2

  • Tracking

    • New widget Version: 1.4.0

    • The includeIAD field is added to selfie Tracking

  • Capture

    • New widget Version: 1.1.8

  • Selphi

    • New widget Version: 6.1.0

    • Fix in the identification of the IAD flavor

    • Correct sending of the IAD asset to Tracking

    • It is explicitly reported when the capture includes IAD

  • SelphID

    • New widget Version: 1.38.0

    • New country and document type selector

    • New parameters to limit allowed countries and document types

    • Visual and experience improvements on the selection screen

    • If the application goes to the background during the Flow, the exit is correctly resolved as user cancellation

  • Phingers

    • New widget Version: 1.1.7

    • Improvements in the classification of internal errors

    • New configuration settings for template and timeout in remote Flows

  • Video ID

    • Improvements in Flow cancellation to end correctly and avoid late errors

    • Adjustments in landscape and rotation preview

    • Fix of the document mask size in portrait

    • New configuration fields for OCR validations, document quality and retries

  • NFC

    • Internal dependencies updated

      • jmrtd 0.8.5

    • Improvements in resolving the holder's name and personal number

    • Security check reinforced before starting the component

    • SOP-3866 fix: DG11 data is prioritized to obtain the holder's information when available

Version: 2.6.0

February 2026

  • General

    • API Version: 35

    • Design and accessibility improvements

    • Facephi Security: 1.2.3

    • Facephi Logger: 1.2.2

    • Facephi Tokenizer: 1.1.2

  • Tracking

    • New widget Version: 1.2.8

  • Capture

    • New widget Version: 1.1.7

  • Selphi

    • New widget Version: 6.0.3

  • SelphID

    • New widget Version: 1.37.1

  • Phingers *

    • Design improvements

    • New widget Version: 1.1.6

    • Improvements in the capture process

  • Voice

    • Flow fixes

    • Accessibility improvements

  • NFC

    • New encrypted output data

*IMPORTANT: A new License is needed to use this Version

Version: 2.5.0

December 2025

  • General

    • Rotation/landscape support in SDK and widgets

    • Dependencies update:

      • API Version: 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

    • New widget Version: 1.2.2

  • Capture

    • New widget Version: 1.1.0

  • Selphi

    • New widget Version: 5.20.0

  • SelphID

    • New widget Version: 1.36.1

  • NFC

    • New reading progress view in percentage with configurable style

    • Flow fixes and Error handling in reading

Version: 2.4.3

  • Selphi

    • New widget Version: 5.20.0

Version: 2.4.2

  • SelphID

    • New widget Version: 1.36.0

  • Tracking

    • New widget Version: 1.1.26

  • Capture - File Uploader

    • New widget Version: 1.0.2

Version: 2.4.1

  • General

    • Design improvements

    • New Security Version: 1.1.3

  • SelphID

    • New widget Version: 1.35.2

  • Selphi

    • New widget Version: 5.19.5

  • Tracking

    • New widget version: 1.1.25

  • Video ID

    • New Reader Version: 1.9.6

  • NFC

    • Dependencies update

    • Data improvement

  • Capture - File Uploader

    • New widget Version: 1.0.1

Version: 2.4.0

  • General

    • Design improvements

    • New function to disable security

    • New Tokenizer Version: 1.0.8

    • New Security Version: 1.1.1

    • New Logger Version: 1.1.1

  • SelphID

    • New widget Version: 1.35.0

    • New Customization

  • Selphi

    • New widget Version: 5.19.1

    • New Customization

  • Tracking

    • New widget Version: 1.1.22

  • Video ID

    • New Reader Version: 1.9.5

Version: 2.3.6

  • General

    • Design improvements

    • Expanded information in errors

    • New Logger Version: 1.0.2

    • New Security Version: 1.0.6

  • SelphID

    • New widget Version: 1.34.5

  • Tracking

    • New widget Version: 1.1.16

  • Selphi

    • New widget Version: 5.18.2

  • Video recording

    • Output deletion

    • Direct response in the start functions

    • Dependencies update

  • Video ID

    • Dependencies update

  • VideoCall

    • Dependencies update

  • NFC

    • Dependencies update

  • Phingers

    • Process improvements

    • Dependencies update

Version: 2.3.5

  • General

    • New error codes

  • SelphID

    • New widget Version: 1.34.1

  • Tracking

    • New widget Version: 1.1.12

  • Video ID

    • New Reader Version: 1.8.0

    • New Helper Version: 3.27.0

Version: 2.3.4

  • General

    • Accessibility improvements

    • Improvements on horizontal screens

    • Error refactoring

  • Video ID

    • New Reader Version: 1.7.1

  • SelphID

    • New widget Version: 1.33.6

  • Design KMP

    • Improvements in iOS resources

  • NFC

    • Improvements in reading

Version: 2.3.3

  • General

    • Accessibility improvements

    • Improvements on horizontal screens

    • New security widget Version: 1.0.1

  • Video ID

    • New launch modes

    • New reader Version: 1.7.0

    • New helper Version: 3.26.13

  • SelphID

    • New widget Version: 1.33.4

  • Selphi

    • New widget Version: 5.17.5

  • Tracking

    • New widget Version: 1.1.10

Version: 2.3.2

  • General

    • Accessibility improvements

    • Compatible with 16Kb

  • Video ID

    • Input and output OCR validations

  • Selphi

    • New widget Version: 5.17.3

  • SelphID

    • New widget Version: 1.33.1

  • VideoCall

    • New screen sharing development

  • VideoRecording

    • New screen sharing development

Version: 2.3.1

  • General

    • Accessibility improvements

  • Selphi

    • New widget Version: 5.17.2

    • Includes Tokenizer

  • Tracking

    • New widget Version: 1.1.9

Version: 2.3.0

  • General

    • Common Design internal library

    • Proguard adjustments

    • Updated the API target to 35

    • Android Gradle Plugin 8.9.1

    • Kotlin 2.1.10

    • Accessibility improvements

  • Tracking

    • New widget Version: 1.1.8

    • Compatible with IDV Platform (A new License is required)

  • Flow

    • Adjustments and improvements

  • VideoCall

    • UI improvements

  • Video ID

    • Face present verification

    • Reading the OCR of the presented document

    • New output data

Version: 2.2.3

  • General

    • Complete separation between the tip screen activation and the tutorial screen.

    • Tracking and event analysis system added for interaction and navigation.

    • New License reader.

  • Voice

    • Internal dependencies updated

  • Phingers

    • Internal dependencies updated

    • New filter

  • Video ID

    • New input parameter for camera selection

    • New input parameter to enable/disable automatic face capture

    • Detection of the active video recording process before starting

  • Video Call

    • Detection of the active video recording process before starting

    • VideoCallScreenSharingManager does not need the application.

    • Detection of internet connection failures

  • Video Recording

    • Detection of internet connection failures

  • SelphID

    • New input parameter to activate vibration

    • New widget Version: 1.32.2

  • Selphi

    • New input parameter to activate vibration

    • New input parameters for Liveness Move attempts

    • New widget Version: 5.17.1

  • License Checker

    • New widget Version: 0.4.0

Version: 2.2.2

  • SelphID

    • New widget Version: 1.31.2

Version: 2.2.1

  • General

    • Internal dependencies updated

  • Selphi

    • New input parameter for camera selection

    • New widget Version: 5.16.2

  • Tracking

    • New Version 1.1.7

  • SelphID

    • New widget Version: 1.31.0

Version: 2.2.0

  • General

    • Improvements in exception handling

    • Internal dependencies updated

  • Selphi

    • New widget Version: 5.16.1

    • Parameter added for extraction duration

    • Orientation management is added

  • SelphID

    • New widget Version: 1.30.1

Version: 2.1.2

  • General

    • UX improvements

    • Accessibility improvements

  • SelphID

    • New widget Version: 1.29.0

  • Selphi

    • New widget Version: 5.15.5

  • Video Call

    • Improvements in connectivity

  • Video Id

    • Improvements in connectivity

  • Video Recording

    • Improvements in connectivity

Version: 2.1.1

  • General

    • UX improvements

  • SelphID

    • New widget Version: 1.28.1

  • Selphi

    • New widget Version: 5.14.2

  • Tracking

    • New widget Version: 1.1.5

  • Capture

    • Improvements in document capture

Version: 2.1.0

  • General

    • Internal improvements and fixes

    • Security improvements

    • Improvements in the management of internal dependencies

  • Flow

    • Internal improvements and fixes

  • Tracking

    • Advanced Tracking

    • Internal improvements and fixes

  • SelphID

    • New Version 1.27.0

  • Selphi

    • New Version 5.14.1

Version: 2.0.3

  • General

    • Accessibility improvements

    • Improvements in controller coroutines

    • UI for tablets

    • Creation of customizable screens

  • NFC

    • Security provider fix

    • Date fix

    • Exception capture

  • Video Call

    • Add timeout

  • Video ID

    • Network error control

    • Add timeouts

    • Face detection on start

  • SelphID

    • New Version 1.26.0.

    • Add tutorial

  • Selphi

    • New Version 5.13.4

    • New cropImageDebug field

  • Tracking

    • Add widget tracking

  • Capture

    • New document capture

Version: 2.0.2

  • General

    • Improvements in tutorials

    • Improvements in UX/UI

    • Kotlin updated from 1.9.24 to 2.0.0 with K2 compiler

    • Android Gradle Plugin updated from 8.3.2 to 8.5.0

    • Minor dependency update

    • Horizontal views for tablets

  • SelphID

    • New Version 1.25.1

  • Tracking

    • APIKEY connection added

    • Version 2 in events

    • Previous stepSucceed adjustments before assets

    • Improvements in connection loss logic

  • NFC

    • Improvements and fixes

    • Fixed "Tag lost error"

    • Improvements in reconnection

    • You can now choose whether to extract the face image and signature

    • A parameter is added to change the tutorial view and show the different documents

  • VideoRecording

    • Adjustments and improvements in Service shutdown

  • VideoCall

    • Adjustments and improvements in Service shutdown

  • Selphi

    • New Version 5.13.1

    • The livenessDiagnostic parameter is added to the output

Version: 2.0.1

  • General

    • SdkConfigurationData text fix "iaModels" to "aiModels"

    • Internal improvements of PreviousTips

    • Important dependencies updated:

      • composeCompilerVersion = 1.5.12

      • androidGradlePlugin = 8.3.2

      • kotlinAndroidGradlePlugin = 1.9.23

  • Selphi

    • New version 5.12.3

    • bestImageTokenized is added to the response

  • SelphID

    • New version 1.24.2

  • VideoCall

    • Updated Timeout image

  • Phingers

    • Simplified ConfigurationData

  • Tokenizer

    • New Core version 2.0.7

Version: 2.0.0

  • General

    • All the functions of SDKController have gone from having output with a lambda to being suspend functions and returning the result synchronously. To use it now, it will be necessary to use a Coroutine. If it is called from a ViewModel, viewModelScore.launch can be used; otherwise, CoroutineScope(Dispatchers.IO).launch

    • The Initialization of the SDK now has an SDKConfigurationData with the data to be filled in

    • In SDKConfigurationData you can choose between LicensingOnline or LicensingOffline

    • All ConfigurationData with images inside have been modified to change the parameter names (Image)

  • Tracking

    • Adjustments and improvements

  • Voice

    • Widget library updated to version 3.13.0

    • Improved UX/UI

    • Improved verification results

Version: 1.5.6

  • Selphi

    • New version 5.12.3

Version: 1.5.5

  • General

    • Security adjustments and improvements

    • Selphi and SelphID improvement in internal image management

  • NFC

    • Correction of the Personal Number field

Version: 1.5.4

  • General

    • Security adjustments and improvements

    • Design adjustments in the tutorial views with fullscreen

  • Selphi

    • New version 5.12.1

  • SelphID

    • New version 1.23.1

Version: 1.5.3

  • General

    • Diagnostic screens with retry

    • Flow

      • New features

      • Dynamic theme

      • Preview controller

      • Client services and preview

      • Improvements

  • Selphi

    • New version 5.12.0

    • Tutorials

    • Sending complete bestImage to tracking

  • SelphID

    • New version 1.22.3

  • Phingers

    • Haptic feedback with vibration has been added

    • Improvements in tutorial

  • NFC

    • Improvements

  • VideoId

    • Improvements in connection

    • UX adjustments

  • VideoCall

    • ScreenSharing

    • New states

    • Improvements in connection

  • VideoRecording

    • New states

    • Improvements in connection

    • Known issue: Android API 34

  • Capture QR

    • QR formats

Version: 1.5.2

  • General

    • Improvements on small screens

    • New SelphiSignController

    • New VideoIdSignController

    • New SDKImage and SDKApplication classes

  • NFC

    • Improvements

  • SelphID

    • 1.21.1

  • Selphi

    • 5.11.2

  • Voice

    • Improvement of library size

Version: 1.5.1

  • General

    • Improvements and bug fixes

  • Voice

    • Internal library update

    • Calibration adjustments

    • Return of tokenized audios

  • Phingers

    • WSQ tracking

  • Behavior

    • Internal library update

    • Improvements and fixes

Version: 1.5.0

  • Compatible with API 34 (Android 14)

  • Updated Android Gradle plugins (8.1.1)

  • Updated Kotlin version used (1.9.10)

  • Input data adjustments for the video component

  • Improved SdkResult as a sealed class

  • Naming of the NewOperation input steps

Version

PreviousAdvanced settingsNextiOS SDK

Last updated