> 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-en/sdks/sdk-mobile/android-sdk/changelog.md).

# Changelog

## Latest version

### **Version:** 2.9.0

*July 2026*

* General
  * New colors for Customization
* Terms and conditions of use
  * Creation of the new component
* Tracking
  * New Version of the Widget: 1.4.5
  * Events for the terms and conditions of use
* Selphi
  * New Version of the Widget: 6.2.3
* SelphID
  * New Version of the Widget: 1.39.3
* Phingers
  * New Version of the Widget: 1.4.9
  * Internal dependency update
* Voice
  * KMP Widget inclusion: 0.1.7
* NFC
  * New Version of the Widget: 0.3.8
  * Improvements in navigation
  * Improvements in the screens

### **Version:** 2.8.1

*June 2026*

* General
  * API Version: 35
  * Android SDK component update to line 2.8.1
  * Use of OkHttp is forced as the HTTP engine on Android for the SDK and Licensing, improving compatibility with applications that use old Ktor dependencies
  * Improved Licensing error handling when the HTTP client cannot be initialized: the flow returns a controlled error instead of propagating an internal failure
  * Updated consumption rules to reduce R8/ProGuard warnings in optional Ktor, location, and Error Prone dependencies
  * Internal improvement of 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
  * Android SDK component update 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 on 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<br>
* Capture
  * New widget version: 1.2.0
  * Support for gallery-only mode in File Uploader through `onlyGalleryMode`
  * New limit `maxGalleryImageSizeKb` to reject oversized gallery images before processing them
  * It 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 texts, iconography, and error states<br>
* 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 advice 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 to the dotted progress during NFC reading
  * Debug log sanitization to avoid sensitive or excessive traces
  * Improved compatibility with the result contract and cryptographic validations exposed by the widget<br>
* Phingers
  * New widget version: 1.3.1
  * Support for new licensing service in the widget
  * Fix of the widget's licensing traces to keep logs more consistent
  * Phingers TF allows reporting `licenseKey`, `product` and `operationId` to the widget
  * Improved propagation of diagnostic configuration in remote flows<br>
* 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 adapters for configuration, results, errors, analytics, and custom views<br>
* 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<br>
* 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<br>
* 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 denied `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 temporal stamp 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 control 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's 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 across different SDK components
  * Visual and behavioral 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<br>
* Capture
  * New widget version: 1.1.8
* Selphi
  * New widget version: 6.1.0
  * Fix in IAD flavor identification
  * Correct sending of the IAD asset to tracking
  * It is explicitly reported when the capture includes IAD<br>
* SelphID
  * New widget version: 1.38.0
  * New country and document type selector
  * New parameters to limit allowed countries and document types
  * Visual and user experience improvements on the selection screen
  * If the application goes to the background during the flow, the exit is correctly resolved as user cancellation<br>
* Phingers
  * New widget version: 1.1.7
  * Improvements in the classification of internal errors
  * New configuration settings for template and timeout in remote flows<br>
* Video ID
  * Improvements in flow cancellation to end correctly and avoid late errors
  * Adjustments in landscape and rotation preview
  * Fix to the document mask size in portrait
  * New configuration fields for OCR validations, document quality, and retries<br>
* NFC
  * Internal dependency update
    * jmrtd 0.8.5
  * Improvements in resolving the holder's personal name and number
  * Strengthening of the security check 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**
  * Improvements in design and accessibility
  * 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 <mark style="color:orange;">**\***</mark>
  * Design improvements
  * New widget version: 1.1.6
  * Improvements in the capture process
* Voice
  * Flow fixes
  * Accessibility improvements
* NFC
  * New encrypted data at output

<mark style="color:$danger;">**\*IMPORTANT:**</mark> <mark style="color:$danger;">A new license is required to use this version</mark>

### **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 percentage-based reading progress view and 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
  * Dependency update
  * Data improvement
* Capture - File Uploader
  * New widget version: 1.0.1

### **Version:** 2.4.0

* General
  * Design improvements
  * New feature 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
  * More information added to 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
  * Dependency update
* Video ID
  * Dependency update
* VideoCall
  * Dependency update
* NFC
  * Dependency update
* Phingers
  * Improvements in the process
  * Dependency update

### **Version:** 2.3.5 <a href="#id-235" id="id-235"></a>

* 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 <a href="#id-234" id="id-234"></a>

* 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 <a href="#id-233" id="id-233"></a>

* 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 <a href="#id-232" id="id-232"></a>

* 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 <a href="#id-231" id="id-231"></a>

* General
  * Accessibility improvements
* Selphi
  * New widget version: 5.17.2
  * Includes Tokenizer
* Tracking
  * New widget version: 1.1.9

### **Version:** 2.3.0 <a href="#id-230" id="id-230"></a>

* General
  * Common Design internal library
  * ProGuard settings
  * API target updated 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 presence verification
  * Reading the OCR of the presented document
  * New output data

### **Version:** 2.2.3 <a href="#id-223" id="id-223"></a>

* General
  * Complete separation between the activation of the tip preview screen and the tutorial screen.
  * Tracking and event analytics system added for interaction and navigation.
  * New license reader.
* Voice
  * Internal dependency update
* Phingers
  * Internal dependency update
  * 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 enable vibration
  * New widget version: 1.32.2
* Selphi
  * New input parameter to enable 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 <a href="#id-222" id="id-222"></a>

* SelphID
  * New widget version: 1.31.2

### **Version:** 2.2.1 <a href="#id-221" id="id-221"></a>

* General
  * Internal dependency update
* 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 <a href="#id-220" id="id-220"></a>

* General
  * Improvements in exception handling
  * Internal dependency update
* Selphi
  * New widget version: 5.16.1
  * Parameter added for extraction duration
  * Orientation handling added
* SelphID
  * New widget version: 1.30.1

### **Version:** 2.1.2 <a href="#id-212" id="id-212"></a>

* General
  * UX improvements
  * Accessibility improvements
* SelphID
  * New widget version: 1.29.0
* Selphi
  * New widget version: 5.15.5
* Video Call
  * Connectivity improvements
* Video ID
  * Connectivity improvements
* Video Recording
  * Connectivity improvements

### **Version:** 2.1.1 <a href="#id-211" id="id-211"></a>

* 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 <a href="#id-210" id="id-210"></a>

* General
  * Internal improvements and fixes
  * Security improvements
  * Improvements in internal dependency management
* 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 <a href="#id-203" id="id-203"></a>

* General
  * Accessibility improvements
  * Improvements in controller coroutines
  * UI for tablets
  * Creation of customizable screens
* NFC
  * Security provider fix
  * Date correction
  * Exception capture
* Video Call
  * Add timeout
* Video ID
  * Network error handling
  * Add timeouts
  * Face detection at startup
* 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 <a href="#id-202" id="id-202"></a>

* 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
  * stepSucceed adjustments before the 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 the 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 <a href="#id-201" id="id-201"></a>

* General
  * SdkConfigurationData text correction from "iaModels" to "aiModels"
  * Internal improvements to 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 <a href="#id-200" id="id-200"></a>

* General
  * All SDKController functions have gone from having lambda output to being suspend functions and returning the result synchronously. To consume it now, it will be necessary to use a Coroutine. If called from a ViewModel, viewModelScore.launch can be used; otherwise CoroutineScope(Dispatchers.IO).launch
  * SDK initialization now has a 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
  * UX/UI improved
  * Verification results improved

### **Version:** 1.5.6 <a href="#id-156" id="id-156"></a>

* Selphi
  * New version 5.12.3

### **Version:** 1.5.5 <a href="#id-155" id="id-155"></a>

* General
  * Security tweaks and improvements
  * Improved internal image management in Selphi and Selphid
* NFC
  * Fix for the Personal Number field

### **Version:** 1.5.4 <a href="#id-154" id="id-154"></a>

* General
  * Security tweaks and improvements
  * Layout adjustments in fullscreen tutorial views
* Selphi
  * New version 5.12.1
* SelphID
  * New version 1.23.1

### **Version:** 1.5.3 <a href="#id-153" id="id-153"></a>

* General
  * Diagnostic screens with retry
  * Flow
    * New features
    * Dynamic theme
    * Preview controller
    * Client and preview services
    * Improvements
* Selphi
  * New version 5.12.0
  * Tutorials
  * Sending full bestImage to Tracking
* SelphID
  * New version 1.22.3
* Phingers
  * Haptic feedback with vibration has been added
  * Tutorial improvements
* NFC
  * Improvements
* VideoId
  * Connection improvements
  * UX adjustments
* VideoCall
  * ScreenSharing
  * New states
  * Connection improvements
* VideoRecording
  * New states
  * Connection improvements
  * Known issue: Android API 34
* QR Capture
  * QR formats

### **Version:** 1.5.2 <a href="#id-152" id="id-152"></a>

* General
  * Improvements for small screens
  * New SelphiSignController
  * New VideoIdSignController
  * New SDKImage and SDKApplication classes
* NFC
  * Improvements
* SelphID
  * 1.21.1
* Selphi
  * 5.11.2
* Voice
  * Library size improvement

### **Version:** 1.5.1 <a href="#id-151" id="id-151"></a>

* General
  * Improvements and bug fixes
* Voice
  * Internal library update
  * Calibration adjustments
  * Return of tokenized audio
* Phingers
  * WSQ Tracking
* Behavior
  * Internal library update
  * Improvements and fixes

### **Version:** 1.5.0 <a href="#id-150" id="id-150"></a>

* Compatible with API 34 (Android 14)
* Android Gradle plugins updated (8.1.1)
* Updated Kotlin version used (1.9.10)
* Adjustments to the video component input data
* SdkResult improved as a sealed class
* Naming of the NewOperation input steps

#### Version