Guidance for users of Xcode 13 or above
The following guidance applies to users of:
- Xcode 13.0 or above, and
- iProov iOS Biometrics SDK 9.0.1 or below
In Xcode 13, Apple have introduced a new feature which automatically manages the version numbers of iOS apps. If apps are submitted to the App Store with the new "Manage Version and Build Number" option enabled, Xcode will overwrite the version and build number of your app and also all included frameworks, such as iProov.
This feature is enabled by default in Xcode 13 and is shown when preparing your app for App Store submission. You must uncheck this box.
If your app is submitted to the App Store with this option enabled, the iProov framework version will be replaced with the version of your app instead, which means that our back-end systems are unable to determine the SDK version being used. This could result in performance limitations, as we cannot apply the optimum configuration for the provided SDK version. In addition, it hinders our ability to monitor SDK performance and provide technical support.
We have prepared answers to a few questions you may have:
No. This issue only affects Xcode 13.
No. This issue only affects iProov SDK less than 9.1.
I don't use the Xcode GUI to distribute my app, I'm using xcodebuild, fastlane or another CLI tool. What should I do?
You must set manageAppVersionandBuildNumber to false in your exportOptions.plist.
You can also pass this directly to xcodebuild with the -exportOptionsPlist option.
I plan to upgrade to Xcode 13 soon, but I don't want to upgrade to iProov SDK v9.1 yet, what should I do?
You must ensure that "Manage Version and Build Number" is unchecked for every release you make, until you upgrade to SDK v9.1. We would encourage you to upgrade to SDK v9.1 as soon as possible after it is released.
The issue is related to Xcode as it is a distribution-related issue, it is not specific to any iOS version.
We are aware of a small number of customers who have already gone live with apps built with Xcode 13. Our Customer Success team will reach out to affected customers directly with further details.
If you have an app currently in review or pending release submitted from Xcode 13, then we would kindly request you re-submit your app with the "Manage Version and Build Number" option unchecked.
Please see the Apple Developer Forums here.
You can also contact iProov technical support at [email protected].