Troubleshooting

Titanium Studio complains about "unlicensed module error"

We recommend downloading the Scandit Barcode Scanner Titanium Module from the download page of your Scandit account (as opposed to downloading it from the Ti Marketplace) to circumvent this problem. The above error seems to occur occasionally with the community edition that is available from the Ti Marketplace where the Ti license verification server checks the license, generates an error message and prevents the use of the module. We have not been able to identify the underlying cause of this issue when we reached out to the Ti team.

Crashes or other oddities are happening in the success callback

Starting with version 4.10 the successCallback is called in the engine thread instead of the main thread. Because of this you have to switch to the main thread for any UI specific operations like removing the scanner from the view hierarchy etc. The easiest way of doing this is by using setTimeout:

picker.setSuccessCallback(function(e) {
picker.stopScanning();
setTimeout(function() {
// Code that manipulates the UI.
}, 1);
});

Some barcode formats are not scanned with the Scandit SDK

There are two possible causes:

  • If you downloaded the Scandit Barcode Scanner Titanium Module from the Ti Marketplace, you are using the free community edition of the Scandit Barcode Scanner SDK that only supports retail barcode formats such EAN13, UPC12 and QR codes. To decode other barcode formats such as Code39, Code128 or PDF417, you will need to sign up for a (free) trial version at scandit.com and download the TI module from your Scandit account.
  • Not all barcode formats are enabled by default. Use the Scandit Barcode Scanner API to enable the barcode symbologies used in your app.

Additional troubleshooting information

More troubleshooting information is available in the respective troubleshooting sections for iOS and Android: