Changelog (iOS SDK)
To help you manage upgrades with confidence, we use Semantic Versioning for all our products, following the format:MAJOR.MINOR.PATCH
.We recommend reviewing version notes before upgrading, especially for major and minor releases. For details, refer to the page Semantic versioning.
v2.10.0
Released on Sept 3, 2025
What's new
- Introduced a new proximity detection location-based signal for mobile devices. Instead of representing a unique device, the new proximity ID corresponds to a fixed geographical zone within which the device is observed. This additional layer of context makes it possible to identify groups of devices in the same physical area or
a single device that may have changed its identity but remained in the same location. See Proximity detection for iOS devices reference for more info.
- Added
allowUseOfLocationData
property to theConfiguration
structure in order to start receiving proximity detection signal. This flag allows the Fingerprint client to access device location data when enabled and the necessary permissions are granted. Default value isfalse
. See integration details here. - Added
NSPrivacyCollectedDataTypePreciseLocation
andNSPrivacyCollectedDataTypeCoarseLocation
toNSPrivacyCollectedDataTypes
in the iOS SDK’s Privacy Manifest, indicating that the SDK may collect both precise and coarse user location data from host apps. - Added an optional
LocationPermissionHelper
utility to simplify integration of location permission handling for host apps that do not implement their own flow. This utility provides an easy way to request, observe, and respond to location permission changes using aLocationPermissionDelegate
callback. See a detailed integration example in the Handling Location Permissions section.
- Added
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.**
Minimum supported versions
v2.9.0
Released on Aug 6, 2025
What's new
- Introduced internal architecture updates and performance improvements to support upcoming capabilities.
- Added new error code:
ProxyIntegrationSecretEnvironmentMismatch
- Addressed minor issues to improve SDK reliability.
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.**
Minimum supported versions
v2.8.2
Released on Apr 30, 2025
What's new
- Introduced the ability to detect if requests from the app were subject to MitM attacks. See MitM Attack Detection to learn more.
- Added support for Open Client Response.
What's changed
- The following changes were made to the error handling API. To ensure backward compatibility, the old symbols have been preserved and annotated with the
@available(*, deprecated, renamed: "<new-name>")
attribute.- Enum
APIErrorType
has been renamed toAPIError.Code
. - Property
APIError.error
has been renamed toAPIError.errorDetails
.
- Enum
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.**
Minimum supported versions
v2.7.0
Released on Oct 24, 2024
What's new
- Introduced the ability to configure the timeout interval for the client session. To learn more, see Specifying a custom timeout.
- Added support for Sealed Client Results.
- Extended compatibility for use with projects that have enabled Swift 6 language mode.
Bug fixes
- Fixed a regression introduced in v2.5.0 in which the API errors were incorrectly parsed as
FPJSError.invalidResponseType
. The API errors are now correctly parsed and returned asFPJSError.apiError
.
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.
Minimum supported versions
v2.6.0
Released on Aug 14, 2024
What’s new
- Introduced the ability to redirect failed requests to alternate endpoints. The
Region.custom(domain:fallback:)
can be used to specify thefallback
array of one or more alternate endpoints. For a complete example, see Getting a visitorId.
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.
Minimum supported versions
v2.5.0
Released on Jul 16, 2024
What’s new
- Enhanced our Jailbroken Device Detection Smart Signal with the ability to detect rootless jailbreaks.
- Factory Reset Smart Signal is no longer reported as true for brand-new iOS devices.
- In accordance with Apple's third-party SDK requirements, the XCFramework bundle is now code signed with an Apple Distribution certificate. The dependency signature verification feature, introduced in Xcode 15, allows the XCFramework's code signing identity to be verified, thus enabling SDK consumers to protect their software supply chain integrity.
What's changed
- Dropped support for Swift 5.7 and 5.8.
Requirements
IDE
- Xcode 15.0+, Swift 5.9. See App Store submission requirements for more information.
Minimum supported versions
v2.4.0
Released on Jan 29, 2024
What's new
- Introduced a new
packageNotAuthorized
value to theAPIErrorType
enum. This error is thrown when an unauthorized app makes identification requests using a stolen API key. See Request filtering for mobile apps for more information. - Extended several public APIs (e.g.
FingerprintResponse
,IPLocation
, etc) with memberwise initializers so that they can be easily stubbed for unit tests.
Requirements
IDE
- Xcode 14.1+, Swift 5.7. See App Store submission requirements for more information.
Minimum supported versions
v2.3.2
Released on Dec 26, 2023
What's new
- Added
PrivacyInfo.xcprivacy
, the privacy manifest file. See Understanding privacy manifest files for more information.
Requirements
IDE
- Xcode 14.1+, Swift 5.7. See App Store submission requirements for more information.
Minimum supported versions
v2.3.1
Released on Oct 26, 2023
What's new
- Introduced the ability to detect Geolocation Spoofing.
What's changed
- Removed the limitation in which the Smart Signals could not be made available in the response of the very first
/events API
request.
Requirements
IDE
- Xcode 14.1+, Swift 5.7. See App Store submission requirements for more information.
Minimum supported versions
v2.3.0
Released on Oct 18, 2023
What's new
- Introduced the ability to detect if a device is using a VPN. See VPN Detection for more information.
- Introduced a new Smart Signal, Factory Reset Detection that provides the timestamp of the most recent factory reset of the device.
- Added support for Swift 5.9 and Xcode 15.
What's changed
- Dropped support for iOS 12, tvOS 12, tvOS 13, and tvOS 14.
Requirements
IDE
- Xcode 14.1+, Swift 5.7. See App Store submission requirements for more information.
Minimum supported versions
v2.2.0
Released on Jun 27, 2023
What's new
- Introduced the ability to detect
- If Frida is being used to instrument your app. See Frida Detection for more information.
- If your app is running on a jailbroken device. See Jailbroken Device Detection for more information.
- Introduced a new field,
visitorFound
inFingerprintResponse
. This field indicates if a device was already seen by your mobile app.
What's changed
- Dropped support for Swift 5.5 and Swift 5.6.
Requirements
IDE
- Xcode 14.1+, Swift 5.7. See App Store submission requirements for more information.
Minimum supported versions
Updated 12 days ago