Common Issues & Settings

iOS: Why does the page sometimes freeze when I start the scanner?

Before a barcode reader instance can be created, a one-time license validation needs to occur when the app initializes (or whenever the license is set before the reader instance is created). Occasionally, this process may take a second to complete and could cause the UI to appear frozen.

A common cause is calling LicenseManager.initLicense() multiple times in the same process. For example, if you call initLicense in both the AppDelegate and the ViewController, a conflict might occur.

✅ Recommendation: Call initLicense only once, ideally in the AppDelegate.

Android: How do I import settings from the Barcode Scanner X app into my own app?

In the Barcode Scanner X app:

1. Navigate to the use case scenario of interest.
2. Tap “Export Template” at the bottom-right corner.

Once you have the template file, you can use it in your app with either:

• initSettings
• initSettingsFromFile