Troubleshooting

You will find here answers to common problems:

Expired license

In case of an expired license, the various SDK methods will raise GSKError with the code GSKLicenseError. You can catch it and handle it as desired. For instance, you can prompt users to update to the latest version of your app.

‘image not found’ error at launch.

Ensure you included the frameworks GSSDKCore.xcframework (and optionally GSSDKScanFlow.xcframework, GSSDKOCR.xcframework) in the Embedded Binaries section of your project.

Undefined symbols

ld: warning: ld: warning: ignoring file GSSDKOCR.framework/GSSDKOCR, building for iOS Simulator-arm64 but attempting to link with file built for iOS Simulator-x86_64 ignoring file GSSDKCore.framework/GSSDKCore, building for iOS Simulator-arm64 but attempting to link with file built for iOS Simulator-x86_64 …

The Genius Scan SDK doesn’t support ARM Mac at this time. This means that you cannot build it for the ARM simulator targets.

This issue generally doesn’t arise, as Mac ARM machines are not yet available. However, Xcode 12 beta 5 and up have a problem with SwiftUI Previews which seem to compile the preview for Mac ARM even though the preview runs on an x86 machine. To fix the problem, you need to exclude the arm64 architecture for simulator builds as shown below:

The ScanFlow UI is not localized

The ScanFlow UI supports around 20 languages and the device’s locale determines the language used for all strings: user guidance, menus, dialogs…

The framework will always use the localization of the main app, but if localization is not properly enabled for the app, then it will fall back to English.

Applications must be localized in XCode by adding each language to the project. Also, there must be at least one file localized in the XCode project for the language to be properly picked up.

The status bar appearance is broken in the scan flow

The Genius Scan SDK only supports the modern, view controller-based, status bar appearance introduced with iOS 7. In particular, the camera screen is designed to work the status bar hidden. As a consequence, you must remove UIViewControllerBasedStatusBarAppearance=NO from your app’s Info.plist, or set it to YES.