With Microsoft Azure Mobile Apps you can add a scalable backend to your connected client applications in minutes. To learn more about Azure Mobile Apps, visit the Mobile Apps documentation.
The Cordova plugin is published from the Azure/azure-mobile-apps-cordova-client repository by bundling source code in this repository. Refer Azure/azure-mobile-apps-cordova-client for more details about the Cordova plugin.
- Android API 19-24 (KitKat through Nougat)
- iOS versions 8.0 and later.
- Windows Phone 8.1
- Universal Windows Platform
You can consume the SDK in one of the following ways.
- Reference the SDK bundle in HTML's script tag
- Use the SDK bundle as a CommonJS module
- Use the SDK bundle as an AMD module
- Use the SDK as an npm package
The latest SDK bundle is available at https://zumo.blob.core.windows.net/sdk/azure-mobile-apps-client.js and https://zumo.blob.core.windows.net/sdk/azure-mobile-apps-client.min.js.
To use a specific version of the SDK (recommended), use the bundle at https://zumo.blob.core.windows.net/sdk/azure-mobile-apps-client.VERSION.js or https://zumo.blob.core.windows.net/sdk/azure-mobile-apps-client.VERSION.min.js, where __VERSION__ represents a valid version.
Here are a few examples of how you can use the SDK.
<html> <head> <script src="https://zumo.blob.core.windows.net/sdk/azure-mobile-apps-client.2.0.0.js"></script> <script> // Create a reference to the Azure App Service var clientRef = new WindowsAzure.MobileServiceClient('https://YOUR-SITE-NAME.azurewebsites.net'); </script> </head> </html>
Use the SDK as an npm package
Install the SDK from npm:
npm install azure-mobile-apps-client
Install the SDK from github:
npm install azure/azure-mobile-apps-js-client
var WindowsAzure = require('azure-mobile-apps-client'); // Create a reference to the Azure App Service var clientRef = new WindowsAzure.MobileServiceClient('https://YOUR-SITE-NAME.azurewebsites.net');
Offline data sync
This page explains the offline data sync feature in detail.
Refer https://azure.github.io/azure-mobile-apps-js-client for detailed API reference.
- latest unminified and minified
- version 2.0.0 unminified and minified
- version 2.0.0-rc1 unminified and minified
- version 2.0.0-beta5 unminified and minified
- version 2.0.0-beta4 unminified and minified
To build the SDK bundle yourself, follow these steps:
git clone https://github.com/Azure/azure-mobile-apps-js-client.git cd azure-mobile-apps-js-client npm install npm run build
The built files will be copied to the
/dist directory. The bundles for use by a web app in a browser are azure-mobile-apps-client.js and azure-mobile-apps-client.min.js. The bundle for use by the azure/azure-mobile-apps-cordova-client repository is azure-mobile-apps-client-cordova.js.
Running Unit Tests
To run unit tests for the browser, run:
npm run browserut
Brief list of work planned in the future:
- ability to cancel push and pull operations
- triggering a push automatically when a pull is performed
- support for math and date/time functions while querying for records
- callback to allow changing how records are sent to the server during a push
- configurable ID column. Currently ID column has to be named 'id'.
All these will be added over a series of updates in the next few days. Stay tuned!
- Getting Started with Azure Mobile Apps
- Azure Mobile Apps Cordova plugin
- Tutorials and product overview are available at Microsoft Azure Mobile Apps Developer Center.
- Our product team actively monitors the Mobile Services Developer Forum to assist you with any troubles.
Contribute Code or Provide Feedback
If you would like to become an active contributor to this project please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.
If you encounter any bugs with the library please file an issue in the Issues section of the project.