Known issues
-
Release build fails but debug works — likely an obfuscation issue on the Android side. The native SDKs cannot be obfuscated. Review ProGuard/DexGuard rules.
-
pod installfails after updating the plugin — removeios/Podfile.lockand runpod installagain from theios/directory. -
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 (
DeviceProfilingandUnicoSdkLogger) when using CocoaPods. Apply the workaround below in yourios/Podfileuntil 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, add it before the last end.
Sources: Bitrise, Xcode 16 release notes, Stack Overflow.
-
Camera opens and closes without any callback on Android — when the camera permission has not been granted, the plugin requests it and closes the camera screen without calling any listener method, so the journey seems to do nothing. Request the camera permission in your app (for example, with the
permission_handlerpackage) and open the native SDK only after it is granted. -
Errors via platform channel — typically indicate incomplete configuration of the underlying platform. Review Specific setup.
-
Attempt to use bridges instead of the official plugin — not supported. Migrate to the official plugin.