You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by gi...@apache.org on 2022/03/16 17:17:16 UTC
[cordova-docs] branch asf-site updated: Deploying to asf-site from @ apache/cordova-docs@ae8a8b39edc638ca71f4fcbe92560c0e1c588fed 🚀
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 12231f0 Deploying to asf-site from @ apache/cordova-docs@ae8a8b39edc638ca71f4fcbe92560c0e1c588fed 🚀
12231f0 is described below
commit 12231f08a81d886f3587553e71fc47374dc28c94
Author: breautek <no...@nbsolutions.ca>
AuthorDate: Wed Mar 16 17:10:30 2022 +0000
Deploying to asf-site from @ apache/cordova-docs@ae8a8b39edc638ca71f4fcbe92560c0e1c588fed 🚀
---
docs/en/dev/reference/cordova-plugin-file/index.html | 18 ++++++++++++++++++
feed.xml | 4 ++--
static/img/tools/instabug.png | Bin 23838 -> 8803 bytes
3 files changed, 20 insertions(+), 2 deletions(-)
diff --git a/docs/en/dev/reference/cordova-plugin-file/index.html b/docs/en/dev/reference/cordova-plugin-file/index.html
index 0df1098..3c4ef37 100644
--- a/docs/en/dev/reference/cordova-plugin-file/index.html
+++ b/docs/en/dev/reference/cordova-plugin-file/index.html
@@ -2976,7 +2976,25 @@ This method will now return filesystem URLs of the form</p>
<p>which can be used to identify the file uniquely.</p>
+<p>In v7.0.0 the return value of <code>toURL()</code> for Android was updated to return the absolute <code>file://</code> URL when app content is served from the <code>file://</code> scheme.</p>
+
+<p>If app content is served from the <code>http(s)://</code> scheme, a <code>cdvfile</code> formatted URL will be returned instead. The <code>cdvfile</code> formatted URL is created from the internal method <code>toInternalURL()</code>.</p>
+
+<p>An example <code>toInternalURL()</code> return filesystem URL:</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>https://localhost/persistent/path/to/file
+</code></pre></div></div>
+
+<p><a href="//sketchviz.com/@erisu/7b05499842275be93a0581e8e3576798"><img src="https://sketchviz.com/@erisu/7b05499842275be93a0581e8e3576798/6dc71d8302cafd05b443d874a592d10fa415b8e3.sketchy.png" alt="toURL flow" /></a></p>
+
+<p>It is recommended to always use the <code>toURL()</code> to ensure that the correct URL is returned.</p>
+
<h2>cdvfile protocol</h2>
+
+<ul>
+ <li>Not Supported on Android</li>
+</ul>
+
<p><strong>Purpose</strong></p>
<p><code>cdvfile://localhost/persistent|temporary|another-fs-root*/path/to/file</code> can be used for platform-independent file paths.
diff --git a/feed.xml b/feed.xml
index 6e90f87..3b10e0c 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Sat, 12 Mar 2022 09:08:27 +0000</pubDate>
- <lastBuildDate>Sat, 12 Mar 2022 09:08:27 +0000</lastBuildDate>
+ <pubDate>Wed, 16 Mar 2022 17:09:18 +0000</pubDate>
+ <lastBuildDate>Wed, 16 Mar 2022 17:09:18 +0000</lastBuildDate>
<generator>Jekyll v4.2.2</generator>
<item>
diff --git a/static/img/tools/instabug.png b/static/img/tools/instabug.png
index f30475a..0e0f505 100644
Binary files a/static/img/tools/instabug.png and b/static/img/tools/instabug.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org