Return-Path: X-Original-To: apmail-cordova-dev-archive@www.apache.org Delivered-To: apmail-cordova-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9FC2610484 for ; Tue, 5 Nov 2013 17:31:23 +0000 (UTC) Received: (qmail 93911 invoked by uid 500); 5 Nov 2013 17:31:22 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 93859 invoked by uid 500); 5 Nov 2013 17:31:21 -0000 Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list dev@cordova.apache.org Received: (qmail 93850 invoked by uid 99); 5 Nov 2013 17:31:20 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 05 Nov 2013 17:31:20 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of brian.leroux@gmail.com designates 209.85.223.182 as permitted sender) Received: from [209.85.223.182] (HELO mail-ie0-f182.google.com) (209.85.223.182) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 05 Nov 2013 17:31:16 +0000 Received: by mail-ie0-f182.google.com with SMTP id as1so15765634iec.13 for ; Tue, 05 Nov 2013 09:30:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:content-type; bh=e/kponitzeJy4rlJrjh8QEMpbbzOqVWcyTa3c6ZMhb4=; b=sHj4hZrDxC2HD9CFy2q2IIL643uILckkGYalGChG0WsNovuarPAxBrKc8t6ykHiNql nap1kWsgJUMIaSNo9EisywKvgr15G8xR6Cp6cbMSHsdObAhRgh841cQAccz0Dfuw72C/ 15ZwlVHH4DTkso/rOG+8/Oh/ULOt1VMKgLKmsT73pRHPS6u18jlqBeA6Ovc5BNDcQ8kJ wtimqJexbqdNSXzU6NsQGsxPszRPm92tq+TlHdOe8ZyAAf3tirAS81DeivdNHfnf9P4r VDLjQmBZjDTK9GYoEccMJWtCEjL858q7wKXNefW9TRRjK03oF4a+7moU4gsLWtmD9ibX jVLA== MIME-Version: 1.0 X-Received: by 10.50.1.102 with SMTP id 6mr16986848igl.0.1383672655527; Tue, 05 Nov 2013 09:30:55 -0800 (PST) Sender: brian.leroux@gmail.com Received: by 10.50.114.132 with HTTP; Tue, 5 Nov 2013 09:30:55 -0800 (PST) In-Reply-To: References: Date: Tue, 5 Nov 2013 17:30:55 +0000 X-Google-Sender-Auth: Gamn8s9Rhqj2QC1bPjern9SfvkQ Message-ID: Subject: Re: Proposed changes to Cordova File API From: Brian LeRoux To: "dev@cordova.apache.org" Content-Type: multipart/alternative; boundary=047d7bd770a41e94c604ea716535 X-Virus-Checked: Checked by ClamAV on apache.org --047d7bd770a41e94c604ea716535 Content-Type: text/plain; charset=ISO-8859-1 Love it. Now that this business is independently versioned I say we charge ahead with the changes ruthlessly. This is the most adopted plugin and long standing PITA! On Tue, Nov 5, 2013 at 4:18 PM, Ian Clelland wrote: > So, coming out of our meetup last week, we brainstormed a bunch of ideas > for improving the Cordova File plugin. I'm going to start working on these, > but I want to share with the list so that everybody knows what's going on, > and so we can have any additional discussions :) > > I think that we had general agreement on these points, but let's talk: > > 1. Entry.toURL() should return a filesystem:// URL on platforms which > support it. Platforms which cannot support custom URL protocols are free to > return URLs which *can* be used to access the local file system. > > 2. These URLs will look like: > > filesystem://localhost/persistent/path/to/file.ext > filesystem://localhost/temporary/path/to/file.ext > > Additional roots are possible for new file systems (assets, media, > documents, etc) > > (The specific format used does not need to conform to any existing or > proposed standard, since these URLs should not be assumed valid across > machines) > > 3. Entry.fullFath will be relative to the HTML file system root, and not a > path from the root of the actual device file system. > > 4. Only URLs will be passed over the exec bridge; we won't be passing raw > file system paths into and out of JS anymore. (This generally means > filesystem:// URLs in the iOS/Android case, but platforms are free to > support other URLs as needed) > > 5. At some point (not right now) we should move the permanent storage > location on iOS from /Documents to /Library, so that > the entire HTML5 file system doesn't get exposed in iTunes, synced with > iCloud, etc. This will almost certainly require a major version change and > a migration plan for existing apps, so I'd like to separate that work from > the first four points. > > We also discussed shipping a new API with Cordova, get*Directory(), which > is currently in the File-extras plugin. After some thinking, I think it's > not really required, but I'm open to talking about it. I'll start another > thread for it. > > Ian > --047d7bd770a41e94c604ea716535--