Skip to content

Latest commit

 

History

History
30 lines (23 loc) · 1.44 KB

README.md

File metadata and controls

30 lines (23 loc) · 1.44 KB
Raw

cordova-background-plugin

This plugin supports two iOS 7 APIs for updating your app’s UI and content in the background. The first, Background Fetch, allows you to fetch new content from the network at regular intervals. The second, Remote Notifications, is a feature leveraging Push Notifications to notify an app when an event has occurred. Both of these new mechanisms help you to keep your app’s interface up to date.

Here is how you use it:

backgroundFetch.register(
     function() {
         console.log('fetching stuff in background');
         //... actual fetching
         // if depening if there was new data or not...
         backgroundFetch.setContentAvailable(backgroundFetch.BackgroundFetchResult.NewData);
     });
 );

The function exectuted when the os will poll your application to see if ther is content available. When the call is done you'll have to let the os know if there was content or not so it can schedule the next call.

    backgroundFetch.setContentAvailable(backgroundFetch.BackgroundFetchResult.NewData);

With backgroundFetch.setContentAvailable we tell iOS if there was new data or not backgroundFetch.BackgroundFetchResult contains all the options that we can set:

  • NewData: 0
  • NoData: 1
  • Failed: 2

You can also trigger the background fetch by sending a push notification with content-available flag set. The console will log the deviceId nessary to send the notification.