Skip to content

Frequently Asked Questions

psandrinelli edited this page Aug 20, 2026 · 43 revisions

What is ConsentRequiredException?

This new error is not for general use cases but only for iProov internal use. Integrators will never see it on their SPs.

How can I translate the SDK/customize the strings?

Please consult our dedicated Localization Guide.

What is the size impact of the iOS SDK?

The size impact on the downloadable (compressed) size of your app by adding the iProov iOS Biometrics SDK is approximately 1.5MB.

These calculations were performed in October 2025 using Xcode 16.4 with iProov Biometrics SDK 12.5.0.

Why does iProov require workarounds for Cocoapods?

To enable module stability for a specific framework, one must enable the "Build Libraries for Distribution" option in Xcode at compile-time. This ensures that Xcode enables the necessary settings for module stability, including generation of the .swiftinterface files.

Since iProov SDK v7.2.0, this option is enabled at compile-time on our build machines.

However, iProov's framework dependencies (i.e. SwiftProtobuf) are all built from source on your machine, this option must be enabled when compiling your app.

Unfortunately Cocoapods doesn't currently support this behaviour, therefore it must be enabled manually via workarounds.

You can track the development of this feature for Cocoapods here.

Help! My app crashes on launch with __abort_with_payload

If you are using Cocoapods, check you have applied the required workarounds to ensure that iProov's dependencies are built with the correct settings for modular stability.

If you are managing iProov's dependencies manually (not recommended), you must ensure they were built with the "Build Libraries for Distribution" option enabled.

If you continue to encounter issues, please contact iProov.

Whilst developing, can I use iProov from the iOS Simulator?

Whilst the iProov SDK is distributed with the i386 and x86_64 architectures to allow your app to continue to be built to run on the simulator, it is not possible to actually run an iProov claim in the simulator.

The simple reason for this is because the iProov SDK requires access to the camera in order to capture imagery, and the iOS Simulator has no access to the camera.

Does iProov support SwiftUI?

Yes

Help! I get an error when running my app: dyld: Symbol not found: ...

If iProov's dependencies are not built with the "Build Libraries for Distribution" option enabled, you will get dyld errors when running your app.

A typical error in this case is as follows:

dyld: Symbol not found: _$s8SocketIO0A11ClientEventO10disconnectyA2CmFWC

  Referenced from: /Users/me/Library/Developer/CoreSimulator/Devices/117048E7-4BE7-418B-AE3F-49C833078BF7/data/Containers/Bundle/Application/3BE3039D-3F9C-4249-9F17-4896DE96D7CA/MyApp.app/Frameworks/iProov.framework/iProov
  Expected in: /Users/me/Library/Developer/CoreSimulator/Devices/117048E7-4BE7-418B-AE3F-49C833078BF7/data/Containers/Bundle/Application/3BE3039D-3F9C-4249-9F17-4896DE96D7CA/MyApp.app/Frameworks/SocketIO.framework/SocketIO
 in /Users/me/Library/Developer/CoreSimulator/Devices/117048E7-4BE7-418B-AE3F-49C833078BF7/data/Containers/Bundle/Application/3BE3039D-3F9C-4249-9F17-4896DE96D7CA/MyApp.app/Frameworks/iProov.framework/iProov

The solution for this is to ensure that "Build Libraries for Distribution" is enabled when building iProov's dependencies (including SocketIO).

If you are using Cocoapods or Carthage you should make sure you have applied the module stability workarounds to your Podfile, or the carthage build command. See the installation instructions for further details.

Can I use iProov from React Native/MAUI/Cordova/Flutter/etc?

We currently support MAUI, Flutter and React Native. Follow the links to learn more.

If you wish to express an interest in iProov being made available on other platforms, we'd love to hear from you! Please contact support@iproov.com.

Does the iProov SDK support landscape orientation?

The iProov SDK will work in landscape orientation, but the user will be prompted to rotate their iPad to portrait orientation before the scan will commence.

Does the iProov SDK run on iPad?

Yes, but the user needs to be in portrait mode, and not using multitasking as iProov requires full screen. If necessary, the user will be prompted to exit multitasking and/or rotate their iPad to portrait orientation before the iProov scan will commence.

Clone this wiki locally