Common Issues with Cordova

Cordova plugins don’t always install correctly, leading to an undefined plugin, or other errors which are hard if not impossible to debug and understand. Here are a few steps you can take to overcome these common pitfalls:

Only develop on your phone

Cordova plugins do not work while developing in your browser, because each plugin accesses a specific API (such as camera, microphone, accelerometer) which is not available in your browser. Additionally, some plugins don’t work in the emulator, such as the Camera plugin, so development on your physical device is required.

Wrap Plugin calls with the deviceready event

Before each plugin you must check if your device has fully loaded, and if the plugins are available using a native cordova event called deviceready. Implement it like so:

document.addEventListener("deviceready", function () {
  $cordovaPlugin.someFunction().then(success, error);
}, false);

// OR with IONIC

$ionicPlatform.ready(function() {
  $cordovaPlugin.someFunction().then(success, error);

Make sure you are using the latest version of the Cordova CLI:

$ npm install -g cordova

Refresh the ios.json / android.json file (inside the /plugin folder):

$ cordova platform rm [ios/android]
$ cordova platform add [ios/android]

Update your project to the latest version of Cordova:

This command updates the cordova.js and other Cordova-dependent files to the latest version of Cordova.

$ cordova platform update [ios/android]