Deprecation warning

Please note that this is outdated documentation for an older release of the Scandit Barcode Scanner SDK.

We encourage you to migrate to 6.x and take advantage of our latest / advanced features and improved performance.

You'll find the updated documentation at: Data Capture SDK Documentation for Cordova

Troubleshooting Cordova/PhoneGap

App crashes when the barcode picker is shown

An app crash when the barcode picker is shown can occur if there is a problem with our Scandit SDK and/or the way it is used in your app. Contact us at with the details of your setup (Android version, Android device name, info whether our demo app works correctly, and a description of the problem).

Note that for versions prior to 4.12, app crashes could also be the result of invalid app keys or use of the test version without internet access. This behavior has been removed in 4.12. Instead license validation or connectivity issues are now displayed in the barcode picker view.

Installing under Windows fails

Windows has a maximum file path length which means that it is not possible to create new folders after a certain depth in the file system has been reached. Since adding a plugin copies files in an already quite deep folder structure an install can fail because the maximum file path length has been reached and the system fails to copy all the files necessary. To avoid this move your project as high up in the file system as possible (to something like C:\yourProject).

You were unable to find a solution to your problem

If your specific problem does not have a solution on this page, contact us at with a description of the problem (if possible with a code snippet or project) including details about your setup (iOS version, iOS device name, info whether our demo app works correctly).