cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ian Clelland <>
Subject Re: Plugins Release!
Date Fri, 07 Feb 2014 04:40:33 GMT
I've taken a first pass at the file plugin (I'll probably revisit it in the
morning and think it's terrible :) )

On Thu, Feb 6, 2014 at 4:44 PM, Steven Gill <> wrote:

> Okay, I have a blog post ready to review. I could use some help with adding
> more content about the file plugin release. I got most of my info for it
> from
> I have also gone through the commits and removed ones I thought were
> unimportant. If you feel more curating needs to be done, feel free to edit.

The most noticeable changes in this release are to the File plugin. It has
been revamped to use a new URL scheme
`cdvfile://localhost/<filesystemType>/<path to file>`. These URLs are
generated by all file operations, and are passed over the bridge to native
code. (This is in contrast to the previous version, which passed around
absolute paths on the device filesystem).

Most of these changes are to bring us more in line with the HTML Filesystem
standard, although they will also allow us to extend the filesystem
 to cover new kinds of storage, both internal and external to devices.

Other changes include:
  * The file plugin is now much more modular. The "Filesystem" is now an
    abstract class that developers can subclass to write their own
  * Developers can use the existing filesystem types, or new types, to
    provide new filesystem roots for their applications. (No longer limited
    just persistent and temporary, or just a single directory for storage.)
  * Filesystem URLs paths are now relative to the filesystem root, helping
    to sandbox the filesystems and keep applications from stepping on
    each others' toes.
  * Application developers can now configure the file plugin to use a more
    sensible location for storing persistent files. On iOS, this means
    files in the Library directory, rather than the Documents directory. On
    Android, it means using the application's internal storage directory
    than the SD card partition. See the README file for information on
    configuring your applications.
  * Several other bugs have been fixed, and our test coverage has increased.

[Much curating of file changes; too many commits for the number of issues
fixed ;) ]

> `org.apache.cordova.file`
> * CB-5974: Use safe 'Compatibility' mode by default
> * CB-5915: Add option for new persistent storage location for iOS

* CB-5916: Add option for new persistent storage location for Android

> * Add default FS root to new FS objects
> * CB-5899: Make DirectoryReader.readEntries return properly formatted Entry
> objects
> * Add constructor params to FileUploadResult related to CB-2421
> * Fill out filesystem attribute of entities returned from
> resolveLocalFileSystemURL
> * Android: Expose filePlugin getter so that other plugins can register
> filesystems
> * Add backwards-compatibility shim for file-transfer
> * Android: Allow third-party plugin registration
> * CB-5810 [BlackBerry10] resolve local:/// paths (application assets)
> * CB-5774: create DirectoryEntry instead of FileEntry
> * Initial fix for CB-5747: Windows 8: DirectoryEntry.getDirectory fails
> when path contains directory separator
> * Android: Allow absolute paths on Entry.getFile / Entry.getDirectory
> * CB-5008: Rename resolveLocalFileSystemURI to resolveLocalFileSystemURL
> * CB-4899 [BlackBerry10] Fix resolve directories
> * CB-5602 Windows8. Fix File Api mobile spec tests
> * Android: Better support for content urls and cross-filesystem copy/move
> ops
> * CB-5699 [BlackBerry10] Update resolveLocalFileSystemURI implementation
> * CB-5658 Update license comment formatting of doc/
> * CB-5658 Add for File plugin.
> * CB-5658 Delete stale snapshot of plugin docs
> * CB-5403: Backwards-compatibility with file:// urls where possible
> * Android: Clean up unclosed file objects
> * Log file path for File exceptions.
> * CB-5532 WP8. Add binary data support to FileWriter
> * CB-5531 WP8. File Api readAsText incorrectly handles position args
> * Added ubuntu platform support
> * Added amazon-fireos platform support
> * CB-5118 [BlackBerry10] Add check for undefined error handler
> * CB-5403: Bump File plugin major version
> * CB-5408: Add handler for filesystem urls
> * CB-5407: Update Android native code to use filesystem URLs internally
> * CB-5406: Update iOS native code to use filesystem URLs internally
> * CB-5405: Update JS code to use URLs exclusively
> * CB-4816 Fix file creation outside sandbox for BB10

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message