Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
C# JavaScript Java CSS Objective-C Shell
branch: master
Failed to load latest commit information.
prototypes adds initial window8 prototype app
src bugfixing
test updated sample project
www bugfixing
.gitignore Initial commit
LICENSE Initial commit
README.md Update README.md
plugin.xml Bumped version

README.md

Background Download plugin for Apache Cordova

API provides an advanced file download functionality that persists beyond app termination, runs in the background and continues even when the user closed/suspended the application. The plugin includes progress updates and primarily designed for long-term transfer operations for resources like video, music, and large images.

Sample usage

    var fileName = "PointerEventsCordovaPlugin.wmv",
        uriString = "http://media.ch9.ms/ch9/8c03/f4fe2512-59e5-4a07-bded-124b06ac8c03/PointerEventsCordovaPlugin.wmv";

    // open target file for download
    window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, function(fileSystem) {
        fileSystem.root.getFile(fileName, { create: true }, function (targetFile) {

            var onSuccess, onError, onProgress; // plugin callbacks to track operation execution status and progress

            var downloader = new BackgroundTransfer.BackgroundDownloader();
            // Create a new download operation.
            var download = downloader.createDownload(uriString, targetFile);
            // Start the download and persist the promise to be able to cancel the download.
            app.downloadPromise = download.startAsync().then(onSuccess, onError, onProgress);
        });
    });

Supported platforms

  • Windows8
  • Windows Phone8
  • iOS 7.0 or later
  • Android

Quirks

  • Concurrent background downloads are NOT currently supported on iOS.
  • If a download operation was completed when the application was in the background, onSuccess callback is called when the application become active.
  • If a download operation was completed when the application was closed, onSuccess callback is called right after the first startAsync() is called for the same uri, as if the file has been downloaded immediatly.
  • A new download operation for the same uri resumes a pending download instead of triggering a new one. If no pending downloads found for the uri specified, a new download is started, the target file will be automatically overwritten once donwload is completed.
Something went wrong with that request. Please try again.