isabella232 / cordova-plugin-chrome-apps-system-storage

chrome.system.storage Plugin

This plugin provides the ability to query storage device information and be notified when a removable storage device is attached and detached.

In general, storage on mobile devices is handled differently than on desktop. The plugin is designed to provide consistent behaviour with desktop usage, but there are notable differences.

A summary of the similarities and differences:

• Each mobile device has built-in storage (on both Android and iOS). This is reported as storage unit, similar to the physical hard drive in a desktop

• Neither Android nor iOS officially support external storage attached via cable, like USB devices for desktops. Instead, both platforms expect only special-purpose accessories to be attached by cable (see Android and iOS)

• Many Android devices will support an SD card for external storage. As of Android 4.4, the SDK has also added support for multiple SD cards. If found, the plugin will report any SD card(s) as storage units, similar to USB storage devices on desktop

Status

The implementation of various functionality, across platforms, is summarized in the table below.

Method / Event	Android	iOS
getInfo	Yes	Yes1
ejectDevice	Yes2	Yes
getAvailableCapacity	Yes	Yes
onAttached	Yes3	No-op4
onDetached	Yes3	No-op4

1. As iOS does not support generic storages devices, nor SD cards, this method will only ever return a single storage unit (representing built-in storage).

2. On Android, this method will always return "in use" for any removable storage - it is not currently supported to eject/unmount an SD card programmatically.

3. On Android, these events will start the app, even if it is not already running.

4. As above, no iOS devices support removable storage. Thus, these events are implemented as a no-op (listeners can be attached, but will never be fired).

Reference

The API reference is here.

Release Notes

1.2.2 (April 30, 2015)

• Renamed plugin to pubilsh to NPM

1.2.1 (Mar 17, 2015)

• Remove version constraint on backgroundapp dependency due to plugman bug CB-8696

1.2.0 (Mar 17, 2015)

• Use org.chromium.backgroundapp to handle background events

1.1.2 (Nov 26, 2014)

• Make Java 1.6 compatible

1.1.1 (November 17, 2014)

• Add Android support for ejectDevice, getAvailableCapacity, onAttached/onDetached
• Add iOS support for all methods/events

1.0.1 (October 21, 2014)

• Documentation updates.

1.0.0

• Initial release