Release Notes

4.3.2 (Feb 28, 2017)

CB-12353 Corrected merges usage in plugin.xml
CB-12369 Add plugin typings from DefinitelyTyped
CB-12363 Added build badges for iOS 9.3 and iOS 10.0
CB-12230 Removed Windows 8.1 build badges

4.3.1 (Dec 07, 2016)

CB-12224 Updated version and RELEASENOTES.md for release 4.3.1
CB-12112 windows: Make available to move folder trees
fix ENCODING_ERR for applicationDirectory
CB-11848 windows: Remove duplicate slash after file system path
CB-11917 - Remove pull request template checklist item: “iCLA has been submitted…”
CB-11947 fixed typo that occurs when adding file-transfer plugin
CB-11832 Incremented plugin version.

4.3.0 (Sep 08, 2016)

CB-11795 Add ‘protective’ entry to cordovaDependencies
Add handling for SecurityException
CB-11368 android: Resolve content URLs produced by contacts plugin
Plugin uses Android Log class and not Cordova LOG class
CB-11693 ios: Run copy and move operations in the background thread
CB-11699 Read files as Data URLs properly
CB-11305 Enable cdvfile: assets fs root for DOM requests
CB-11385 android: Import java.nio.charset.Charset in LocalFileSystem class
Add badges for paramedic builds on Jenkins
CB-11407 ios: added extern keyword to constants to fix phonegap-webview-ios template issue.
CB-11385 android: Does not pass sonarqube scan
Add pull request template.
Minor edits to the README.md
CB-11142 Fix the NeedPermission code for the case when external media is not mounted in Android
CB-11003 Adding samples to Readme.
CB-10996 Adding front matter to README.md
CB-11115 android: Removing dependency on FileDescriptor toString in content provider tests

4.2.0 (Apr 15, 2016)

CB-10960 Uncaught #<FileError> in write() when readyState != WRITING ?
Replace PermissionHelper.java with cordova-plugin-compat
CB-10977 Android Removing global state used for permission requests
CB-10798, CB-10384 Fixing permissions for Marshmallow.
Fix test failure on WP 8.1
CB-10577 Windows resolveLocalFileSystemURL should omit trailing slash for file
CB-7862 FileReader reads large files in chunks with progress.
CB-10577 Android resolveLocalFileSystemURL should detect directory vs file.
CB-9753 index out of bounds on requestFileSystem.
Remove warning emoji, as it doesn't correctly display in the docs website: cordova.apache.org/docs/en/dev/cordova-plugin-file/index.html. This closes #166
CB-10636 Add JSHint for plugins
CB-10411 Error in file.spec.129 of cordova-plugin-file

4.1.1 (Feb 09, 2016)

Edit package.json license to match SPDX id
CB-10419 cordova-plugin-file 4.0.0 error with browserify workflow

4.1.0 (Jan 15, 2016)

added .ratignore file
CB-10319 android Adding reflective helper methods for permission requests
CB-10023 Fix proxy not found error on Chrome.
CB-8863 ios Fix block usage of self

4.0.0 (Nov 18, 2015)

CB-10035 Updated RELEASENOTES to be newest to oldest
CB-8497 Fix handling of file paths with # character
Do not inject default AndroidPersistentFileLocation into config.xml
CB-9891: Fix permission errors due to URI encoding inconsistency on Android
Fixed NullPointer Exception in Android 5 and above due to invalid column name on cursor
Fix default persistent file location
fix applicationDirectory to use ms-appx:///
Add Windows paths to cordova.file object
CB-9851 Document cdvfile protocol quirk - using cdvfile:// in the DOM is not supported on Windows
CB-9752 getDirectory fails on valid directory with assets filesystem
CB-7253 requestFileSystem fails when no external storage is present
Adding permissions for Marshmallow. Now supports Anrdoid 6.0
Fixing contribute link.
always use setters to fix memory issues without ARC for iOS
CB-9331 getFreeDiskSpace iOS.
override resolveLocalFileSystemURL by webkitResolveLocalFileSystemURL for browser platform add .project into git ignore list
Fail with FileError.ENCODING_ERR on encoding exception.
CB-9544 Add file plugin for OSX
CB-9539 Fixed test failure on Android emulator
Added docs on CSP rules needed for using cdvfile in DOM src. This closes #120
Added cdvfile protocol purpose description and examples

3.0.0 (Aug 18, 2015)

Make Android default persistent file location internal
Fixed issue with file paths not existing when using browserify
CB-9251: Changed from Intents to Preferences object as per the issue
CB-9215 Add cordova-plugin-file manual test for windows platform

2.1.0 (Jun 17, 2015)

added missing license header
CB-9128 cordova-plugin-file documentation translation: cordova-plugin-file
fix npm md
CB-8844 Increased timeout for asset tests
Updated resolveFileSystem.js so it can be parsed by uglifyJS
CB-8860 cordova-plugin-file documentation translation: cordova-plugin-file
CB-8792 Fixes reading of json files using readAsText

2.0.0 (Apr 15, 2015)

CB-8849 Fixed ReadAsArrayBuffer to return ArrayBuffer and not Array on WP8
CB-8819 Fixed FileReader's readAsBinaryString on wp8
CB-8746 gave plugin major version bump
CB-8683 android: Fix broken unit tests from plugin rename
CB-8683 changed plugin-id to pacakge-name
CB-8653 properly updated translated docs to use new id
CB-8653 updated translated docs to use new id
Use TRAVIS_BUILD_DIR, install paramedic by npm
docs: added Windows to supported platforms
CB-8699 CB-6428 Fix uncompressed assets being copied as zero length files
CB-6428 android: Fix assets FileEntry having size of -1
android: Move URLforFullPath into base class (and rename to localUrlforFullPath)
CB-6428 Mention build-extras.gradle in README
CB-7109 android: Parse arguments off of the main thread (close #97)
CB-8695 ios: Fix blob.slice() for asset-library URLs (close #105)
Tweak build-extras.gradle to just read/write to main assets/ instead of build/
CB-8689 Fix NPE in makeEntryForNativeUri (was affecting file-transfer)
CB-8675 Revert “CB-8351 ios: Use base64EncodedStringWithOptions instead of CordovaLib's class extension”
CB-8653 Updated Readme
CB-8659: ios: 4.0.x Compatibility: Remove use of initWebView method
Add a cache to speed up AssetFilesystem directory listings
CB-8663 android: Don't notify MediaScanner of private files
Don't log stacktrace for normal exceptions (e.g. file not found)
android: Don't use LimitedInputStream when reading entire file (optimization)
CB-6428 android: Add support for directory copies from assets -> filesystem
android: Add listChildren(): Java-consumable version of readEntriesAtLocalURL()
CB-6428 android: Add support for file:///android_asset URLs
CB-8642 android: Fix content URIs not working with resolve / copy
Tweak tests to fail if deleteEntry fails (rather than time out)
android: Ensure LocalFilesystemURL can only be created with “cdvfile” URLs
android: Move CordovaResourceApi into Filesystem base class
android: Use CordovaResourceApi.mapUriToFile() rather than own custom logic in ContentFilesystem
android: Use Uri.parse rather than manual parsing in resolveLocalFileSystemURI
Tweak test case that failed twice on error rather than just once
android: Delete invalid JavaDoc (lint errors)
android: Use CordovaResourceApi rather than FileHelper
CB-8032 - File Plugin - Add nativeURL external method support for CDVFileSystem->makeEntryForPath:isDirectory: (closes #96)
CB-8567 Integrate TravisCI
CB-8438 cordova-plugin-file documentation translation: cordova-plugin-file
CB-8538 Added package.json file
CB-7956 Add cordova-plugin-file support for browser platform
CB-8423 Corrected usage of done() in async tests
CB-8459 Fixes spec 111 failure due to incorrect relative paths handling
Code cleanup, whitespace
Added nativeURL property to FileEntry, implemented readAsArrayBuffer and readAsBinaryString

1.3.3 (Feb 04, 2015)

CB-7927 Encoding data to bytes instead of chars when writing a file.
ios: Fix compile warning about implicit int conversion
CB-8351 ios: Use base64EncodedStringWithOptions instead of CordovaLib's class extension
CB-8351 ios: Use argumentForIndex rather than NSArray extension
CB-8351 ios: Use a local copy of valueForKeyIsNumber rather than CordovaLib's version
windows: Handle url's containing absolute windows path starting with drive letter and colon (encoded as %3A) through root FS
windows: Rework to use normal url form
android: refactor: Make Filesystem base class store its own name, rootUri, and rootEntry
android: Simplify code a bit by making makeEntryForPath not throw JSONException
CB-6431 android: Fix plugin breaking content: URLs
CB-7375 Never create new FileSystem instances (except on windows since they don't implement requestAllFileSystems())

1.3.2 (Dec 02, 2014)

Gets rid of thread block error in File plugin
CB-7917 Made tests file.spec.114 - 116 pass for Windows platform
CB-7977 Mention deviceready in plugin docs
CB-7602: Fix isCopyOnItself logic
CB-7700 cordova-plugin-file documentation translation: cordova-plugin-file
Use one proxy for both Windows and Windows8 platforms
CB-6994 Fixes result, returned by proxy's write method
[fxos] update __format__ to match pathsPrefix
CB-6994 Improves merged code to be able to write a File
Optimize FileProxy for Windows platforms
Synchronize changes with Windows platform
Fix function write for big files on Windows 8
Write file in background
CB-7487 Android Broadcast file write This allows MTP USB shares to show the file immediately without reboot/manual refresh using 3rd party app.
CB-7700 cordova-plugin-file documentation translation: cordova-plugin-file
CB-7571 Bump version of nested plugin to match parent plugin

1.3.1 (Sep 17, 2014)

CB-7471 cordova-plugin-file documentation translation
CB-7272 Replace confusing “r/o” abbreviation with just “r”
CB-7423 encode path before attempting to resolve
CB-7375 Fix the filesystem name in resolveLocalFileSystemUri
CB-7445 [BlackBerry10] resolveLocalFileSystemURI - change DEFAULT_SIZE to MAX_SIZE
CB-7458 [BlackBerry10] resolveLocalFileSystemURL - add filesystem property
CB-7445 [BlackBerry10] Add default file system size to prevent quota exceeded error on initial install
CB-7431 Avoid calling done() twice in file.spec.109 test
CB-7413 Adds support of ‘ms-appdata://’ URIs
CB-7422 [File Tests] Use proper fileSystem to create fullPath
CB-7375 [Entry] get proper filesystem in Entry
Amazon related changes.
CB-7375 Remove leading slash statement from condition
Refactored much of the logic in FileMetadata constructor. Directory.size will return 0
CB-7419 [WP8] Added support to get metada from dir
CB-7418 [DirectoryEntry] Added fullPath variable as part of condition
CB-7417 [File tests] added proper matcher to compare fullPath property
CB-7375 Partial revert to resolve WP8 failures
Overwrite existing file on getFile when create is true
CB-7375 CB-6148: Ensure that return values from copy and move operations reference the correct filesystem
CB-6724 changed style detail on documentation
Added new js files to amazon-fireos platform.
Adds Windows platform
Fixes multiple mobilespec tests errors
Removed test/tests.js module from main plugin.xml
CB-7094 renamed folder to tests + added nested plugin.xml
added documentation for manual tests
CB-6923 Adding support to handle relative paths
Style improvements on Manual tests
CB-7094 Ported File manual tests

1.3.0 (Aug 06, 2014)

FFOS Remove unsupported paths from requestAllPaths
FFOS Support for resolve URI, request all paths and local app directory.
CB-4263 set ready state to done before onload
CB-7167 [BlackBerry10] copyTo - return wrapped entry rather than native
CB-7167 [BlackBerry10] Add directory support to getFileMetadata
CB-7167 [BlackBerry10] Fix tests detection of blob support (window.Blob is BlobConstructor object)
CB-7161 [BlackBerry10] Add file system directory paths
CB-7093 Create separate plugin.xml for new-style tests
CB-7057 Docs update: elaborate on what directories are for
CB-7093: Undo the effects of an old bad S&R command
CB-7093: Remove a bunch of unneeded log messages
CB-7093: Add JS module to plugin.xml file for auto-tests
CB-7093 Ported automated file tests
WINDOWS remove extra function closure, not needed
WINDOWS remove check for undefined fail(), it is defined by the proxy and always exists
WINDOWS re-apply readAsBinaryString and readAsArrayBuffer
WINDOWS Moved similar calls to be the same calls, aliased long namespaced functions
CB-6127 Updated translations for docs.
CB-6571 Fix getParentForLocalURL to work correctly with directories with trailing ‘/’ (This closes #58)
UTTypeCopyPreferredTagWithClass returns nil mimetype for css when there is no network
updated spec links in docs ( en only )
CB-6571 add trailing space it is missing in DirectoryEnty constructor.
CB-6980 Fixing filesystem:null property in Entry
Add win8 support for readAsBinaryString and readAsArrayBuffer
[FFOS] Update FileProxy.js
CB-6940: Fixing up commit from dzeims
CB-6940: Android: cleanup try/catch exception handling
CB-6940: context.getExternal* methods return null if sdcard isn't in mounted state, causing exceptions that prevent startup from reaching readystate
Fix mis-handling of filesystem reference in Entry.moveTo (‘this’ used in closure).
CB-6902: Use File.lastModified rather than .lastModifiedDate
CB-6922: Remove unused getMetadata native code
CB-6922: Use getFileMetadata consistently to get metadata
changed fullPath to self.rootDocsPath
CB-6890: Fix pluginManager access for 4.0.x branch

1.2.1

CB-6922 Fix inconsistent handling of lastModifiedDate and modificationTime
CB-285: Document filesystem root properties

1.2.0 (Jun 05, 2014)

CB-6127 Spanish and French Translations added. Github close #31
updated this reference to window
Add missing semicolon (copy & paste error)
Fix compiler warning about symbol in interface not matching implementation
Fix sorting order in supported platforms
ubuntu: increase quota value
ubuntu: Change FS URL scheme to ‘cdvfile’
ubuntu: Return size with Entry.getMetadata() method
CB-6803 Add license
Initial implementation for Firefox OS
Small wording tweaks
Fixed toURL() toInternalURL() information in the doku
ios: Don't fail a write of zero-length payload.
CB-285 Docs for cordova.file.*Directory properties
CB-285 Add cordova.file.*Directory properties for iOS & Android
CB-3440 [BlackBerry10] Proxy based implementation
Fix typo in docs “app-bundle” -> “bundle”
CB-6583 ios: Fix failing to create entry when space in parent path
CB-6571 android: Make DirectoryEntry.toURL() have a trailing /
CB-6491 add CONTRIBUTING.md
CB-6525 android, ios: Allow file: URLs in all APIs. Fixes FileTransfer.download not being called.
fix the Windows 8 implementation of the getFile method
Update File.js for typo: lastModifiedData --> lastModifiedDate (closes #38)
Add error codes.
CB-5980 Updated version and RELEASENOTES.md for release 1.0.0
Add NOTICE file
CB-6114 Updated version and RELEASENOTES.md for release 1.0.1
CB-5980 Updated version and RELEASENOTES.md for release 1.0.0

1.1.0 (Apr 17, 2014)

CB-4965: Remove tests from file plugin
Android: Allow file:/ URLs
CB-6422: [windows8] use cordova/exec/proxy
CB-6249: [android] Opportunistically resolve content urls to file
CB-6394: [ios, android] Add extra filesystem roots
CB-6394: [ios, android] Fix file resolution for the device root case
CB-6394: [ios] Return ENCODING_ERR when fs name is not valid
CB-6393: Change behaviour of toURL and toNativeURL
ios: Style: plugin initialization
ios: Fix handling of file URLs with encoded spaces
Always use Android's recommended temp file location for temporary file system
CB-6352: Allow FileSystem objects to be serialized to JSON
CB-5959: size is explicitly 0 if not set, file.spec.46&47 are testing the type of size
CB-6242: [BlackBerry10] Add deprecated version of resolveLocalFileSystemURI
CB-6242: [BlackBerry10] add file:/// prefix for toURI / toURL
CB-6242: [BlackBerry10] Polyfill window.requestAnimationFrame for OS < 10.2
CB-6242: [BlackBerry10] Override window.resolveLocalFileSystemURL
CB-6212: [iOS] fix warnings compiled under arm64 64-bit
ios: Don‘t cache responses from CDVFile’s URLProtocol
CB-6199: [iOS] Fix toNativeURL() not escaping characters properly
CB-6148: Fix cross-filesystem copy and move
fixed setMetadata() to use the formatted fullPath
corrected typo which leads to a “comma expression”
CB-4952: ios: Resolve symlinks in file:// URLs
Add docs about the extraFileSystems preference
CB-6460: Update license headers

1.0.1 (Feb 28, 2014)

CB-6116 Fix error where resolveLocalFileSystemURL would fail
CB-6106 Add support for nativeURL attribute on Entry objects
CB-6110 iOS: Fix typo in filesystemPathForURL: method
Android: Use most specific FS match when resolving file: URIs
iOS: Update fileSystemURLforLocalPath: to return the most match url.
Allow third-party plugin registration, and the total count of fs type is not limited to just 4.
CB-6097 Added missing files for amazon-fireos platform. Added onLoad flag to true.
CB-6087 Android, iOS: Load file plugin on startup
CB-6013 BlackBerry10: wrap webkit prefixed called in requestAnimationFrame
Update plugin writers' documentation
CB-6080 Fix file copy when src and dst are on different local file systems
CB-6057 Add methods for plugins to convert between URLs and paths
CB-6050 Public method for returning a FileEntry from a device file path
CB-2432 CB-3185, CB-5975: Fix Android handling of content:// URLs
CB-6022 Add upgrade notes to doc
CB-5233 Make asset-library urls work properly on iOS
CB-6012 Preserve query strings on cdvfile:// URLs where necessary
CB-6010 Test properly for presence of URLforFilesystemPath method
CB-5959 Entry.getMetadata should return size attribute

1.0.0 (Feb 05, 2014)

CB-5974: Use safe ‘Compatibilty’ mode by default
CB-5915: CB-5916: Reorganize preference code to make defaults possible
CB-5974: Android: Don't allow File operations to continue when not configured
CB-5960: ios: android: Properly handle parent references in getFile/getDirectory
[ubuntu] adopt to recent changes
Add default FS root to new FS objects
CB-5899: Make DirectoryReader.readEntries return properly formatted Entry objects
Add constuctor params to FileUploadResult related to CB-2421
Fill out filesystem attribute of entities returned from resolveLocalFileSystemURL
CB-5916: Create documents directories if they don't exist
CB-5915: Create documents directories if they don't exist
CB-5916: Android: Fix unfortunate NPE in config check
CB-5916: Android: Add “/files/” to persistent files path
CB-5915: ios: Update config preference (and docs) to match issue
CB-5916: Android: Add config preference for Android persistent storage location
iOS: Add config preference for iOS persistent storage location
iOS: Android: Allow third-party plugin registration
Android: Expose filePlugin getter so that other plugins can register filesystems
Fix typos in deprecation message
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
Change default FS URL scheme to “cdvfile”
Android: Properly format content urls
Android, iOS: Replace “filesystem” protocol string with constant
Android: Allow absolute paths on Entry.getFile / Entry.getDirectory
Android: Make clear that getFile takes a path, not just a filename
CB-5008: Rename resolveLocalFileSystemURI to resolveLocalFileSystemURL; deprecate original
Remove old file reference from plugin.xml
Android: Refactor File API
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/index.md
CB-5658 Add doc.index.md for File plugin.
CB-5658 Delete stale snapshot of plugin docs
CB-5403: Backwards-compatibility with file:// urls where possible
CB-5407: Fixes for ContentFilesystem
Android: Add method for testing backwards-compatibility of filetransfer plugin
iOS: Add method for testing backwards-compatiblity of filetransfer plugin
Android: Updates to allow FileTransfer to continue to work
Android: Clean up unclosed file objects
CB-5407: Cleanup
CB-5407: Add new Android source files to plugin.xml
CB-5407: Move read, write and truncate methods into modules
CB-5407: Move copy/move methods into FS modules
CB-5407: Move getParent into FS modules
CB-5407: Move getmetadata methods into FS modules
CB-5407: Move readdir methods into FS modules
CB-5407: Move remove methods into FS modules
CB-5407: Move getFile into FS modules
CB-5407: Start refactoring android code: Modular filesystems, rfs, rlfsurl
CB-5407: Update android JS to use FS urls
CB-5405: Use URL formatting for Entry.toURL
CB-5532 Fix
Log file path for File exceptions.
Partial fix for iOS File compatibility with previous fileTransfer plugin
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-5406: Extend public API for dependent plugins
CB-5403: Bump File plugin major version
CB-5406: Split iOS file plugin into modules
CB-5406: Factor out filesystem providers in iOS
CB-5408: Add handler for filesystem:// urls
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

0.2.5 (Oct 28, 2013)

CB-5129: Add a consistent filesystem attribute to FileEntry and DirectoryEntry objects
CB-5128: added repo + issue tag to plugin.xml for file plugin
CB-5015 [BlackBerry10] Add missing dependency for File.slice
CB-5010 Incremented plugin version on dev branch.

0.2.4 (Oct 9, 2013)

CB-5020 - File plugin should execute on a separate thread
CB-4915 Incremented plugin version on dev branch.
CB-4504: Updating FileUtils.java to compensate for Java porting failures in the Android SDK. This fails because Java knows nothing about android_asset not being an actual filesystem

0.2.3 (Sept 25, 2013)

CB-4889 bumping&resetting version
CB-4903 File Plugin not loading Windows8
CB-4903 File Plugin not loading Windows8
CB-4889 renaming references
CB-4889 renaming org.apache.cordova.core.file to org.apache.cordova.file
Rename CHANGELOG.md -> RELEASENOTES.md
CB-4771 Expose TEMPORARY and PERSISTENT constants on window.
Fix compiler/lint warnings
CB-4764 Move DirectoryManager.java into file plugin
CB-4763 Copy FileHelper.java into the plugin.
CB-2901 [BlackBerry10] Automatically unsandbox filesystem if path is not in app sandbox
CB-4752 Incremented plugin version on dev branch.

0.2.1 (Sept 5, 2013)

CB-4656 Don't add newlines in data urls within readAsDataUrl.
CB-4514 Making DirectoryCopy Recursive
[iOS] Simplify the code in resolveLocalFileSystemURI