Skip to main content

Known issues

  • Shadow at end of flow after updating to 2.4.0 — flow control is delegated to the SDK caller. If a shadow appears or the screen does not close after a successful capture, implement a release inside onSuccessSelfie:
func onSuccessSelfie(_ result: SelfieResult!) {
navigationController?.popViewController(animated: true)
// your code
}
  • Bitcode error in app distribution using Xcode 16 — after the official release of Xcode 16 (Sep 17, 2024), distribution to the App Store may be blocked due to bitcode usage in two internal dependencies (DeviceProfiling and UnicoSdkLogger) when using CocoaPods. Apply the workaround below in your Podfile until a permanent fix ships:
post_install do |installer|
bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
framework_path = File.join(Dir.pwd, framework_relative_path)
command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
puts "Stripping bitcode: #{command}"
system(command)
end

framework_paths = [
"Pods/unicocheck-ios/DeviceProfiling.xcframework/ios-arm64/DeviceProfiling.framework/DeviceProfiling",
"Pods/unicocheck-ios/UnicoSdkLogger.xcframework/ios-arm64/UnicoSdkLogger.framework/UnicoSdkLogger"
]

framework_paths.each do |framework_relative_path|
strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
end
end

If post_install do |installer| is not present in the Podfile, add it before the last end. If you already strip bitcode manually, just append the paths in framework_paths.

Sources: Bitrise, Xcode 16 release notes, Stack Overflow.

  • pod install fails after updates — remove Podfile.lock and run pod install again.

  • iXGuard obfuscation breaks the SDK — use iXGuard 4.12.6 or higher. The SDK code itself must not be obfuscated. Review obfuscation rules.