Create the AngularJS ToDoList sample app

In this tutorial, you’ll learn how to create a task list sample app using AngularJS (AngularJSToDo). This app allows users to create new todo list items, check them off, and remove them. The app also stores tasks using HTML5 Web Storage on the device. (The complete sample uses Microsoft Azure Mobile Services to store data, and also uses Bing Maps to provide valid addresses.) This sample uses JavaScript code, but you can also write your Cordova app in TypeScript.

Note: For an overview of tasks required to build a Cordova app, see Create Your First App Using Visual Studio Tools for Apache Cordova.

The complete todo list sample app can be downloaded here:

Pre-requisites

Before you can create a new project, make sure that you’ve met all system requirements and installed the Visual Studio Tools for Apache Cordova (and optional component in Visual Studio). For more information, see Install Visual Studio Tools for Apache Cordova.

Get the complete sample and run it

If want to skip right to the complete sample and run it, get it by downloading the Cordova samples here. Get the samples by choosing the Clone or download button on this page.

A few things to know before you run the app:

  • By default, the sample will use HTML5 Web storage (local storage) for todo list items.

  • To store todo list items on Azure (optional), you need to set up a SQL database using the Azure portal. When you have set up the Azure database, update the AngularJS ToDo List app:

    1. In azureStorage.js, include the Azure Mobile Apps URL where instructed by code comments.
    2. In index.html, update the following URL in the Content-Security-Policy <meta> element to match your Mobile Apps URL: http://youraddress.azurewebsites.net
  • To use Bing maps (optional), get a Bing Maps key and include it where instructed in maps.js.

To run the complete sample:

  1. If you downloaded the .zip file (instead of cloning), make sure you unzip the files.

  2. Open the project file (.sln file) in Visual Studio.

  3. At the top of Visual Studio, select a platform like Android and a target device like Ripple - Nexus (Galaxy).

    Selecting the Ripple emulator

    Note: iOS and some target devices and emulators have different system or configuration requirements. See topics like Run your app on Android and the iOS Setup Guide for more info.

    If you are not running on a VM and your machine supports Hyper-V, we recommend targeting Android and selecting the VS Emulator (it's faster than the Google Android Emulator). GenyMotion also provides a good emulator but set up and configuration takes time.

    If you are running on a Windows 10 machine, we also recommend targeting Windows-x64 or Windows-x86 as a platform, and selecting Local Machine as your target.

  4. Press F5 to start the app.

Troubleshooting? Let's fix it

If you see any unexpected errors when trying to run the app, see these troubleshooting tips before continuing.

Create the AngularJS ToDoList app from scratch with a new project

Create a new Cordova project in Visual Studio by choosing File, New, and then Project in Visual Studio. In the New Project dialog box, choose Installed, Templates, JavaScript, Apache Cordova Apps, and then choose the Blank App template.

Create the UI

The main UI in the todo list sample app consists of the following elements:

  • An element for new list items.

  • An AngularJS template that will display each task in the todo list. The element looks like this:

    <input id="new-todo" placeholder="What needs to be done?"
         td-text-change="toDoCtrl.addToDo()" ng-model="toDoCtrl.newToDoText" autofocus>
    

When you first run the app, some of the attributes in the preceding code won’t do anything. For example, the AngularJS ng-model directive enables two-way data binding, and allows you to save the entered task when the addToDo() function runs. For the todo list, we define a template using some nested elements that wrap several other elements. For example, the nested element shown here is used to display each task string.

<div class="templateWrapper" ng-repeat="toDoItem in toDoCtrl.todos">
  <div class="templateContainer">
    <input class="templateTitle" ng-class="{crossedOut: toDoItem.done}"
      type="text" td-text-change="toDoCtrl.changeToDoText(toDoItem)"
      ng-model="toDoItem.text" />
    <h3 class="templateAddress">{{toDoItem.address}}</h3>
    <button class="templateLeft templateToggle"
      ng-class="{'checked': toDoItem.done, 'unchecked': !toDoItem.done}"
      ng-mousedown="toDoCtrl.toggleToDoDone(toDoItem)"></button>
    <button class="templateLeft templateRemove"
      ng-click="toDoCtrl.removeToDo(toDoItem, $index)"></button>
  </div>
  <div class="templateBorder"></div>
</div>

In the preceding code, the AngularJS attribute, ng-repeat, allows you to define the top element as a template to display todo list items. Later, when you attach actual data and run the app, ng-repeat will add the child element (templateContainer) and its child elements to the DOM for each stored todo list item.

Note: Because Cordova is not dependent on any particular JavaScript framework, we are not trying to provide in-depth information about AngularJS programming in these steps. Instead, we are showing a good example of one way to create a cross-platform app using Visual Studio Tools for Apache Cordova.

Now, we will add the complete markup for index.html.

Add markup for the list

  • Open index.html, and replace the <head> and <body> element with the following code.
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width,
    initial-scale=1.0, maximum-scale=1.0, user-scalable=0" />
  <meta http-equiv="Content-Security-Policy" content="default-src 'self' data:
    gap: http://offlinedata-cordova.azurewebsites.net http://dev.virtualearth.net https://ssl.gstatic.com
    'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *">
    <title>CordovaToDoApp_AngularJS</title>

    <link href="css/index.css" rel="stylesheet" />
</head>
<body ng-app="xPlat">
    <section id="todoapp" ng-controller="ToDoCtrl as toDoCtrl">
        <header id="header">
            <div id="headerBand"></div>
            <input id="new-todo" placeholder="What needs to be done?"
        td-text-change="toDoCtrl.addToDo()" ng-model="toDoCtrl.newToDoText" autofocus>
        </header>
        <section id="main">
            <div id="todo-list">
                <div class="templateWrapper" ng-repeat="toDoItem in toDoCtrl.todos">
                    <div class="templateContainer">
                        <input class="templateTitle" ng-class="{crossedOut: toDoItem.done}"
              type="text" td-text-change="toDoCtrl.changeToDoText(toDoItem)" ng-model="toDoItem.text" />
                        <h3 class="templateAddress">{{toDoItem.address}}</h3>
                        <button class="templateLeft templateToggle"
              ng-class="{'checked': toDoItem.done, 'unchecked': !toDoItem.done}"
              ng-mousedown="toDoCtrl.toggleToDoDone(toDoItem)"></button>
                        <button class="templateLeft templateRemove"
              ng-click="toDoCtrl.removeToDo(toDoItem, $index)"></button>
                    </div>
                    <div class="templateBorder"></div>
                </div>
            </div>
        </section>
    </section>

    <!-- Cordova reference, this is added to your app when it's built. -->
    <script src="cordova.js"></script>
    <script src="scripts/platformOverrides.js"></script>

  <!--azure mobile services script-->
  <script src='scripts/MobileServices.Web.js'></script>

    <!-- Initialize all the modules -->
    <script src="scripts/index.js"></script>

</body>

When you add the AngularJS framework (in later steps), other AngularJS attributes specified in index.html will become meaningful, but for now they won’t have any effect when you run the app. Here are the other AngularJS attributes included in index.html:

  • ng-app directive to specify the root node of an AngularJS app.

  • ng-controller to specify the AngularJS controller to support MVC.

Add CSS style information

  • In the css folder, open index.css, and add CSS style information for HTML elements and templates. It is a long section of code, so get the current CSS code from the complete sample and paste it into index.css.

You can take a look at the empty todo list in one of the emulators to verify that everything looks correct. In this step, you’ll run the AngularJSToDo list app on either Windows or on the Apache Ripple simulator, which have minimal setup requirements (although Ripple requires Chrome). If you prefer to test your app on another target, see the following topics: Run your app on Android, iOS Setup Guide, and Run your app on Windows Phone.

To build and run the app

  1. Open fetch.json and add the following entry if it's missing (you might need to add a comma before this code to get valid JSON).

    "cordova-plugin-compat": {
      "source": {
      "type": "registry",
      "id": "cordova-plugin-compat"
    },
      "is_top_level": false,
      "variables": {}
    }
    
  2. Choose Windows-x64, Windows-x86, or Android from the Solution Platforms list.

  3. If you chose the Android platform, choose one of the Ripple simulators, as shown here.

    Selecting the Ripple emulator

    If you chose a Windows platform, you can run the app on the default deployment target, Local Machine.

  4. Press F5 to start debugging, or Shift+F5 to start without debugging.

    The following illustration shows an example of what the AngularJSToDo list app looks like in one of the Ripple simulators (with no actual data yet attached, and with some files missing at this stage).

    Cordova_ToDo_List_App_Empty

Troubleshooting? Let's fix it

If you see any unexpected errors, try running the complete sample first. If that doesn't resolve the issues, see these troubleshooting tips before continuing.

Add the AngularJS framework to your project

Now that you’ve verified your setup, you can create the AngularJSToDo app. The app uses AngularJS to separate the view model (MVC), to provide data binding, and to support native UI for different platforms.

To add AngularJS to your project

  1. From the AngularJS website, choose Download. In the Download AngularJS dialog box, make sure that the minified 1.2.x version of AngularJS is selected (more recent versions should work, but this is the current version we tested), and then choose Download to save the angular.min.js script to your computer.

  2. In the Download AngularJS dialog box, choose Browse additional modules, and download angular-resource.min.js.

  3. In the Visual Studio Solution Explorer, add a new folder under the scripts folder of the project and name it frameworks.

    Note: You cannot add this folder while the app is running. Press Shift + F5 to stop the debugger.

  4. Open the shortcut menu for the frameworks folder, and then choose Add, Existing Item. Add the two AngularJS files from steps 1 and 2 to the project.

Update the script references

  1. In index.html, add the following AngularJS references in the element, after the Cordova and platformOverrides script references.

    <!-- Angular JS -->
    <script src="scripts/frameworks/angular.min.js"></script>
    <script src="scripts/frameworks/angular-resource.min.js"></script>
    

    Your script references in the element should now look like this.

    <!-- Cordova reference, this is added to your app when it's built. -->
    <script src="cordova.js"></script>
    <script src="scripts/platformOverrides.js"></script>
    
    <!-- Angular JS -->
    <script src="scripts/frameworks/angular.min.js"></script>
    <script src="scripts/frameworks/angular-resource.min.js"></script>
    
    <!-- Initialize all the modules -->
    <script src="scripts/index.js"></script>
    

    Note: cordova.js needs to load before the AngularJS framework files.

  2. Add script references for your AngularJS modules at the end of the element, after the AngularJS references. Those additional references should look like this.

    <!-- Initialize all the modules -->
    <script src="scripts/index.js"></script>
    
    <!-- Services -->
    <script src="scripts/services/azureStorage.js"></script>
    <script src="scripts/services/localStorage.js"></script>
    <script src="scripts/services/storage.js"></script>
    <script src="scripts/services/guidGenerator.js"></script>
    <script src="scripts/services/maps.js"></script>
    <script src="scripts/services/cordova.js"></script>
    
    <!-- Directives -->
    <script src="scripts/directives/textChange.js"></script>
    
    <!-- Controllers -->
    <script src="scripts/controllers/toDoCtrl.js"></script>
    

Register app modules

In this section, you’ll register AngularJS app modules to help separate application concerns. Modules in this app include the data model (xPlat.services), the AngularJS controller (xPlat.controller), and AngularJS directives (xPlat.directives) to support data binding. To register the modules, use the angular.module function.

To register angular modules

  1. In Solution Explorer, open the shortcut menu for the scripts folder, and then choose Add, New Folder. Use this command to add three folders under the scripts folder:

    • controllers

    • directives

    • services

  2. In Solution Explorer, open the shortcut menu for the controllers folder, and then choose Add, New Item.

  3. In the Add New Item dialog box, choose JavaScript File, and name it toDoCtrl.js.

  4. Repeat the preceding step to add additional JavaScript files to the directives and services folders, respectively:

    • textChange.js (add it to the directives folder).

    • cordova.js, guidGenerator.js, localStorage.js, maps.js, and storage.js (add them to the services folder)

  5. Open index.js, and replace the default code with the following code.

    (function () {
      'use strict';
    
      angular.module('xPlat', ['xPlat.services', 'xPlat.controllers', 'xPlat.directives']);
      angular.module('xPlat.directives', []);
      angular.module('xPlat.controllers', []);
      angular.module('xPlat.services', ['ngResource']);
    })();
    

Add the data model

The data model is represented by the xPlat.services module, which you’ll implement in the files in the services folder. This code includes a service that provides local storage of todo list items using HTML5 Web Storage (localStorage.js). In this initial implementation, the app also provides placeholder code for Bing Maps services, which can be implemented fully later on. The complete sample app also uses Azure to store data.

To add code for the data model

  1. In the services folder, open storage.js and add the following code. In this code, we provide a generic way to add storage service. In the initial implementation, we add the localStorage service. Later, we will add an Azure service using this code.

    (function () {
        'use strict';
    
        angular.module('xPlat.services').factory('storage', ['$injector', storage]);
    
        /**
         * Storage service to abstract specific implementations.
         *
         * @params {!angular.Service} $injector
         */
        function storage($injector) {
            // If Azure storage is available, use it. Otherwise, use local storage.
            // var azureService = $injector.get('azureStorage');
            // return azureService.isAvailable ? azureService : $injector.get('localStorage');
        return $injector.get('localStorage');
        }
    })();
    
  2. In the services folder, open localStorage.js and add the following code. One thing to note here is the inclusion of the q service component in the service provider function. This object enables asynchronous programming, so that you can create a promise object using q.when. Using the promise object, you can resolve the asynchronous operation when it has completed.

    (function () {
        'use strict';
    
        angular.module('xPlat.services').service('localStorage', ['$q', '$window', 'guidGenerator', LocalStorage]);
    
        /**
         * Local storage service.
         * @param {angular.Service} $q
         * @param {angular.Service} $window
         * @param {angular.Service} guidGenerator
         * @constructor
         */
        function LocalStorage($q, $window, guidGenerator) {
            this.$q = $q;
            this.$window = $window;
            this.guidGenerator = guidGenerator;
        }
    
        /**
         * Key for storing todo items locally.
         * @type {string}
         * @const
         */
        LocalStorage.prototype.LOCAL_STORAGE_KEY = 'toDoItems';
    
        /**
         * Load JSON data from the local storage.
         * @return {Object} Todo items.
         */
        LocalStorage.prototype.loadFromStorage = function () {
            return angular.fromJson(this.$window.localStorage.getItem(this.LOCAL_STORAGE_KEY)) || [];
        };
    
        /**
         * Save JSON data in the local storage.
         * @params {Object} items Todo items.
         */
        LocalStorage.prototype.saveToStorage = function (items) {
            this.$window.localStorage.setItem(this.LOCAL_STORAGE_KEY, angular.toJson(items));
        }
    
        /**
         * Retrieve all data from local storage.
         */
        LocalStorage.prototype.getAll = function () {
    
            var items;
            var _this = this;
            items = _this.loadFromStorage();
            return _this.$q.when(items);
        };
    
        /**
         * Create a new todo to local storage.
         * @param {string} text Text of the todo item.
         * @param {string} address Address of the todo item.
         */
        LocalStorage.prototype.create = function (text, address) {
            var item = {
                id: this.guidGenerator.get(),
                text: text,
                address: address,
                done: false
            }
            var items = this.loadFromStorage();
            items.push(item);
    
            this.saveToStorage(items);
            return this.$q.when(item);
        };
    
        /**
         * Update an existing todo in local storage.
         * @param {Object} item Todo item to modify.
         */
        LocalStorage.prototype.update = function (item) {
            var items = this.loadFromStorage();
            for (var i = 0; i < items.length; i++) {
                if (items[i].id === item.id) {
                    items[i] = item;
                    break;
                }
            }
    
            this.saveToStorage(items);
            return this.$q.when(item);
        };
    
        /**
         * Remove a todo from local storage.
         * @param {Object} item Todo item to remove from local storage.
         */
        LocalStorage.prototype.del = function (item) {
            var items = this.loadFromStorage();
            for (var i = 0; i < items.length; i++) {
                if (items[i].id === item.id) {
                    items.splice(i, 1);
                    break;
                }
            }
    
            this.saveToStorage(items);
            return this.$q.when(item);
        };
    })();
    

Add the app’s view logic and implement data binding

In this section, you’ll implement the AngularJS controller module (xPlat.controllers) to handle view logic and manipulate the data model. The code implements declarative functions in the HTML such as addToDo, which adds a new task item to the list. In this section, you’ll also add an AngularJS directive to help implement two-way data binding.

To add the controller

  • In the controllers folder, open toDoCtrl.js and add the following code. The controller name, ToDoCtrl, is also referenced by the AngularJS ng-controller directive in index.html.

    (function () {
        'use strict';
    
        angular.module("xPlat.controllers").controller('ToDoCtrl', ['maps', 'storage', '$scope', ToDoCtrl]);
    
        /**
         * Controller for the todo list.
         *
         * @param {!angular.Service} maps
         * @param {!angular.Service} storage
         * @constructor
         * @export
         */
        function ToDoCtrl(maps, storage, $scope) {
    
            this.maps = maps;
            this.storage = storage;
            var that = this;
    
            storage.getAll().then(function (items) {
                that.todos = items;
                // Refresh on another thread.
                setTimeout(function () {
                    $scope.$apply();
                }, 0);
            });
    
            this.updateAddress = function (toDoItem) {
                var _this = this;
    
                return this.maps.getCurrentPosition()
                    .then(_this.maps.getAddressFromPosition.bind(_this.maps), function (error) { return error.message; })
                    .then(function (address) {
                        toDoItem.address = address;
                        return _this.storage.update(toDoItem);
                    }, function (errorMessage) {
                        toDoItem.address = errorMessage;
                        return _this.storage.update(toDoItem);
                    });
            }
    
            this.refresh = function () {
                setTimeout(function () {
                    $scope.$apply();
                }, 0);
            }
    
        }
    
        /**
         * Update the item location with an address.
         * @param toDoItem
         */
    
        /**
         * Add a todo item to the list.
         */
        ToDoCtrl.prototype.addToDo = function () {
            var _this = this;
    
            var text = this.newToDoText;
            if (!text) {
                return;
            };
    
            this.newToDoText = '';
            this.storage.create(text, 'Getting location...')
                .then(function (todo) {
                    _this.todos.push(todo);
                    return todo;
                }).then(this.updateAddress.bind(this));
        };
    
        /**
         * Update the text of a todo item.
         */
        ToDoCtrl.prototype.changeToDoText = function (toDoItem) {
            this.storage.update(toDoItem)
                .then(this.updateAddress.bind(this))
        };
    
        /**
         * Check/uncheck a todo item.
         */
        ToDoCtrl.prototype.toggleToDoDone = function (toDoItem) {
            toDoItem.done = !toDoItem.done;
            this.storage.update(toDoItem);
        };
    
        /**
         * Remove a todo item from the list.
         */
        ToDoCtrl.prototype.removeToDo = function (toDoItem, $index) {
            var _this = this;
            this.storage.del(toDoItem).then(function (todo) {
                // var index = _this.todos.indexOf(todo);
                _this.todos.splice($index, 1);
                _this.refresh();
            });
        };
    })();
    

    Next, you’ll implement the directives module. In this code, you’ll create a custom directive to specify behavior for the onchange DOM event. At runtime, this code associates the correct event handler (declared in HTML markup in index.html) with the element, either the addToDoText or changeToDoText functions. These are implemented in toDoCtrl.js.

To add a directive for data binding

  • In the directives folder, open textChange.js and add the following code.

    (function () {
        'use strict';
    
        angular.module('xPlat.directives').directive('tdTextChange', tdTextChange);
    
        /**
         * Factory function for the directive for ng-text-change.
         *
         * @return {Object} td-text-change
         */
        function tdTextChange() {
            return {
                restrict: 'A',
                link: function (scope, element, attr) {
                    element.on('change', function () {
                        scope.$apply(function () {
                            scope.$eval(attr.tdTextChange);
                        });
                    });
                }
            };
        }
    })();
    

Add additional services

In this section, you’ll add additional service modules to support features such as GUID generation.

To add other app services

  1. In the services folder, open guidGenerator.js and add the following code. This code generates a unique ID to associate with each todo list item.

    (function () {
        angular.module('xPlat.services').service('guidGenerator', GuidGenerator);
    
        /**
         * Generates a GUID to use as an ID for the todos
         * @constructor
         */
        function GuidGenerator() {
            // Generates a small part of a GUID
            this.generatePart = function () {
                var guidPartNumber = (Math.random() * 0x10000) | 0;
                return (guidPartNumber + 0x10000).toString(16).substring(1).toUpperCase();
            };
        }
    
        /**
         * Returns a new GUID.
         * @return {string} generated GUID.
         */
        GuidGenerator.prototype.get = function () {
            return this.generatePart()
                + '-'
                + this.generatePart()
                + '-'
                + this.generatePart()
                + '-'
                + this.generatePart()
                + '-'
                + this.generatePart()
                + this.generatePart()
                + this.generatePart();
        };
    })();
    
  2. In the services folder, open maps.js and add the following code. We will use this code later to enable Bing Maps geolocation services. For now, it is used to associate the current location, if available, or a default location with the current todo list item.

    (function () {
        'use strict';
    
        angular.module('xPlat.services').service('maps', ['$rootScope', '$q', '$window', '$resource', 'cordova', Maps]);
    
        // Bing maps to retreive addresses from locations.
        function Maps($rootScope, $q, $window, $resource, cordova) {
            var BING_MAPS_API_KEY = 'API-KEY-GOES-HERE'; // TODO: Add your Bing Maps API key
            if (BING_MAPS_API_KEY === 'API-KEY-GOES-HERE') {
                console.warn("A Bing Maps API key was not provided, skipping the API call. Get an API key at https://msdn.microsoft.com/library/ff428642.aspx");
            }
            this.url = 'http://dev.virtualearth.net/REST/v1/Locations/:latitude,:longitude?key=' + BING_MAPS_API_KEY;
    
            this.$rootScope = $rootScope;
            this.$q = $q;
            this.$window = $window;
            this.$resource = $resource;
            this.cordova = cordova;
        }
    
        Maps.prototype.getCurrentPosition = function () {
            var _this = this;
            return this.cordova.ready.then(function () {
                var deferred = _this.$q.defer();
                _this.$window.navigator.geolocation.getCurrentPosition(function (successValue) {
                    _this.$rootScope.$apply(function () {
                        deferred.resolve(successValue);
                    }.bind(_this));
                }, function (errorValue) {
                    _this.$rootScope.$apply(function () {
                        deferred.reject(errorValue);
                    }.bind(_this));
                });
    
                return deferred.promise;
            });
        };
    
        /**
         * Gets an address from a position.
         * @params position
         */
        Maps.prototype.getAddressFromPosition = function (position) {
            var _this = this;
            return this.$resource(_this.url, {})
                .get({ latitude: position.coords.latitude, longitude: position.coords.longitude })
                .$promise.then(function (response) {
                    return response.resourceSets[0].resources[0].address.formattedAddress;
                }, function (error) {
                    return position.coords.latitude + ',' + position.coords.longitude
                });
        };
    })();
    
  3. In the services folder, open cordova.js and add the following code. This code adds a handler for the Cordova deviceready event to help make sure that the event fires before the app runs plugin code.

    (function () {
        'use strict';
    
        angular.module('xPlat.services').factory('cordova', ['$q', '$window', '$timeout', cordova]);
    
        /**
         * Service that allows access to Cordova when it is ready.
         *
         * @param {!angular.Service} $q
         * @param {!angular.Service} $window
         * @param {!angular.Service} $timeout
         */
        function cordova($q, $window, $timeout) {
            var deferred = $q.defer();
            var resolved = false;
    
            // Listen to the 'deviceready' event to resolve Cordova.
            // This is when Cordova plugins can be used.
            document.addEventListener('deviceready', function () {
                resolved = true;
                deferred.resolve($window.cordova);
                console.log('deviceready fired');
            }, false);
    
            // If the 'deviceready' event didn't fire after a delay, continue.
            $timeout(function () {
                if (!resolved && $window.cordova) {
                    deferred.resolve($window.cordova);
                }
            }, 1000);
    
            return { ready: deferred.promise };
        }
    })();
    

Build and run your app

In this step, you’ll run the AngularJSToDo list app on either Windows or on the Apache Ripple simulator.

To build and run the app

  • Press F5 to run the app on the same target you specified previously.

    Windows and the Ripple simulator have minimal setup requirements, so we recommend initially targeting one of these two platforms. The following illustration shows an example of what the AngularJSToDo list app looks like in one of the Ripple simulators.

    Running the ToDo List app on Ripple Emulator

Now, you can add new todo list items by typing text and pressing Enter (Ripple) or tapping outside of the input box (Windows). At this point, HTML 5 Web Storage stores the todo list items locally.

Add Bing Maps services (optional)

The complete sample includes a Bing Maps service to associate your current address with each todo list item.

Tip: If you are more interested in setting up Azure Mobile Apps, you can skip these steps and go to the next section.

To add Bing Maps support to the app:

  1. Add the Cordova Geolocation plugin to the app by double-clicking config.xml in Solution Explorer, choosing the Plugins tab, and then choosing Geolocation.

    For more information, see Manage Plugins for Apps Built with Visual Studio Tools for Apache Cordova.

  2. Choose Add to add the plugin.

  3. Press F5 to start the app.

    Now, Bing Maps will provide an address for your current location.

Add Azure Mobile Apps (optional)

The complete sample includes additional code to store and retrieve todo list items using Azure Mobile Apps. This code is implemented as an additional service (named azureStorage) in azureStorage.js. You can obtain this code from the complete sample app, or you can follow the instructions here to add the service.

To add Azure Mobile Apps

  1. If you don’t already have one, create a Microsoft Azure account.

  2. On the Azure portal, set up a SQL database using a free trial version of Azure.

  3. Add required plugins to the project using the configuration designer. To do this, take these steps.

    • Open config.xml in Solution Explorer (the configuration designer opens).

    • Choose the Plugins tab.

    • Add the Azure Mobile Apps and InAppBrowser plugins.

  4. Copy MobileServices.Web.js from the plugins/cordova-plugin-ms-azure-mobile-apps/www folder to the www/scripts folder (same location as index.js).

    By manually including the Azure service code in your app, you can run this code early (before the Cordova deviceReady event handler gets called).

  5. Use the configuration designer to remove the Azure plugin.

  6. Copy the Azure Mobile App application URL from into Notepad. The default code that you need to replace is shown here. Use a valid URL, in the format shown in the comment, for the URL.

    //var AZURE_MOBILE_APPS_ADDRESS = 'http://youraddress.azurewebsites.net';
    var AZURE_MOBILE_APPS_ADDRESS = '';
    
  7. In index.html, update the following URL in the Content-Security-Policy <meta> element to match your Mobile Apps URL: http://youraddress.azurewebsites.net

  8. Update the Cordova references in index.html to include a reference to MobileServices.Web.js. Put the script reference after the cordova.js reference, like this.

    <!-- Cordova reference, this is added to your app when it's built. -->
    <script src="cordova.js"></script>
    <script src="scripts/platformOverrides.js"></script>
    
    <!--azure mobile services script-->
    <script src='scripts/MobileServices.Web.js'></script>
    
    <!-- Initialize all the modules -->
    <script src="scripts/index.js"></script>
    
  9. In storage.js, uncomment the following lines of code to allow use of Azure as the storage service.

    // var azureService = $injector.get('azureStorage');
    // return azureService.isAvailable ? azureService : $injector.get('localStorage');
    

    And remove the next line of code:

    return $injector.get('localStorage');
    

    After uncommenting the code and removing the specified code, the storage function in storage.js will look like this.

    function storage($injector) {
      // If Azure storage is available, use it. Otherwise, use local storage.
      var azureService = $injector.get('azureStorage');
      return azureService.isAvailable ? azureService : $injector.get('localStorage');
    }
    
  10. In azureStorage.js, add the following code for the Azure service. Where indicated in the code, add Azure Mobile App URL that you obtained when you added the Azure service.

    (function () {
        'use strict';
    
        angular.module('xPlat.services').service('azureStorage', ['$resource', 'guidGenerator', AzureStorage]);
    
        /**
         * Azure Mobile Apps Application URL.
         * TODO: Add your Azure Mobile Service Application URL.
         *
         * @type {string}
         * @const
         */
        var AZURE_MOBILE_APPS_ADDRESS = 'http://offlinedata-cordova.azurewebsites.net';
        //var AZURE_MOBILE_APPS_ADDRESS = '';
        var client;
    
        if (AZURE_MOBILE_APPS_ADDRESS) {
            client = new WindowsAzure.MobileServiceClient(AZURE_MOBILE_APPS_ADDRESS);
        }
    
    
    
    /**
     * Use the Azure Mobile Service to store todo items in the cloud.
     *
     * @param {angular.Service} $resource
     * @param {angular.Service} guidGenerator
     * @constructor
     */
    function AzureStorage($resource, guidGenerator) {
        this.isAvailable = AZURE_MOBILE_APPS_ADDRESS;

        if (!AZURE_MOBILE_APPS_ADDRESS) {
            console.warn("The Azure Mobile Apps URL is not set up properly. Items will not be stored on Azure.");
        }
        else {
            this.todoItem = client.getTable('todoitem');
            // default todo item
            // this.todos = [ { text: "testing", address: 67777 } ];
        }
    }

    AzureStorage.prototype.getAll = function () {

        return this.todoItem.read()
            .then(function (items) {
                console.log("items:");
                console.log(items);
                return items;
            }, handleError);
    };

    function refreshList(thisArg) {

        return thisArg.todoItem.read()
            .then(function (items) {
                console.log("refresh items:");
                console.log(items);
                return items;
            }, handleError);
    }

    function createTodoItemList(items) {
        return items;
    }

    /**
     * Create a new todo to Azure storage.
     *
     * @param {string} text Text of the todo item.
     * @param {string} address Address of the todo item.
     */
    AzureStorage.prototype.create = function (itemText, itemAddress) {

        console.log("creating..." + itemText);
        return this.todoItem.insert({
            text: itemText,
            address: itemAddress,
            complete: false
        }).then(success, handleError);
    };

    /**
     * Update an existing todo in Azure storage.
     *
     * @param {Object} item Todo item to modify.
     */
    AzureStorage.prototype.update = function (item) {

        return this.todoItem.update({
            id: item.id,
            complete: item.complete
        }).then(success, handleError);
    };

    /**
     * Remove a todo from Azure storage.
     *
     * @param {Object} item Todo item to remove from local storage.
     */
    AzureStorage.prototype.del = function (item) {

        return this.todoItem.del({
            id: item.id
        }).then(success, handleError)
    };

    function handleError(error) {
        var text = error + (error.request ? ' - ' + error.request.status : '');
        console.error(text);
        console.log('error', error.request.status);
        if (error.request.status == '0' || error.request.status == '404') {
            alert({
                title: 'Connection Failure',
                template: 'Connection with backend can not be established.'
            });
        }
    }

    function success(retVal) {
        console.log("successful operation");
        return retVal;
    }

})();
```
  1. Press F5 to re-run the app. Now, todo list items will be stored in Azure.

Download the tools Get the Visual Studio Tools for Apache Cordova or learn more