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 the Configuration 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 is false. See integration details here.
    • Added NSPrivacyCollectedDataTypePreciseLocation and NSPrivacyCollectedDataTypeCoarseLocation to NSPrivacyCollectedDataTypes 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 a LocationPermissionDelegate callback. See a detailed integration example in the Handling Location Permissions section.

Requirements

IDE

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

Minimum supported versions


v2.8.2

Released on Apr 30, 2025

What's new

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 to APIError.Code.
    • Property APIError.error has been renamed to APIError.errorDetails.

Requirements

IDE

Minimum supported versions


v2.7.0

Released on Oct 24, 2024

What's new

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 as FPJSError.apiError.

Requirements

IDE

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 the fallback array of one or more alternate endpoints. For a complete example, see Getting a visitorId.

Requirements

IDE

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

Minimum supported versions


v2.4.0

Released on Jan 29, 2024

What's new

  • Introduced a new packageNotAuthorized value to the APIErrorType 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

Minimum supported versions


v2.3.2

Released on Dec 26, 2023

What's new

Requirements

IDE

Minimum supported versions


v2.3.1

Released on Oct 26, 2023

What's new

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

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

Minimum supported versions


v2.2.0

Released on Jun 27, 2023

What's new

  • Introduced the ability to detect
  • Introduced a new field, visitorFound in FingerprintResponse. 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

Minimum supported versions