Install

Get the Source File

You can use bower to install ngCordova like so or download the zip file here, and locate the .js file in the dist folder:

$ bower install ngCordova

Include ng-cordova.js or ng-cordova.min.js in your index.html file before cordova.js and after your AngularJS / Ionic file (since ngCordova depends on AngularJS).

<script src="lib/ngCordova/dist/ng-cordova.js"></script>
<script src="cordova.js"></script>

Inject as an Angular dependency

Then, include ngCordova as a dependency in your angular module:

angular.module('myApp', ['ngCordova'])

Wrap each plugin call with the deviceready event - important !

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);
});

Add the plugin to your project using the Cordova CLI

Now you can add plugins to your cordova project, and use the ngCordova API detailed below:

cordova plugin add ...