[CB-6022] Need to update docs re: fullPath change

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Component/s: cordova-plugin-file, cordova-plugin-file-transfer (DEPRECATED)
• Assignee: Ian Clelland
• Reporter: Ian Clelland
• Created: 12/Feb/14 18:37
• Updated: 23/Aug/18 07:27
• Resolved: 13/Feb/14 14:51

Description

For backwards compatibility, FileTransfer can take device-absolute file paths as well as file URLs.

Previously, there were two methods that would get you a file path from a FileEntry: Entry.toURL() and Entry.fullPath would both expose the absolute path. With the new version (1.0.0) of File, fullPath now properly represents the path relative to the filesystem root, rather than the device root.

We should update the docs to say that if you were previously using entry.fullPath to obtain filesystem paths, you should switch to entry.toURL() and use URLs instead.

Issue Links

• is related to: CB-6029 fileTransfer fails after URLforFilesystemPath: test implemented
• is related to: CB-6015 FileTransfer error: Read-Only filesystem