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 84a03354e2 Deploying to asf-site from @
apache/cordova-docs@5f0cd7c11d700fec7771a22ddfb8051b4aa3df3e 🚀
84a03354e2 is described below
commit 84a03354e22fc512531d7e87a100f294be4c5715
Author: erisu <[email protected]>
AuthorDate: Tue Jul 11 15:57:05 2023 +0000
Deploying to asf-site from @
apache/cordova-docs@5f0cd7c11d700fec7771a22ddfb8051b4aa3df3e 🚀
---
announcements/2023/07/10/cordova-ios-7.0.0.html | 20 ++
blog/index.html | 82 +++++-
feed.xml | 138 +++++----
news/2023/07/11/file-plugin-8.0.0.html | 354 ++++++++++++++++++++++++
sitemap.xml | 5 +
static/js/index.js | 1 +
6 files changed, 552 insertions(+), 48 deletions(-)
diff --git a/announcements/2023/07/10/cordova-ios-7.0.0.html
b/announcements/2023/07/10/cordova-ios-7.0.0.html
index 5c8fed66e0..0e8da86760 100644
--- a/announcements/2023/07/10/cordova-ios-7.0.0.html
+++ b/announcements/2023/07/10/cordova-ios-7.0.0.html
@@ -371,6 +371,26 @@ cordova platform add [email protected]
</div>
<div class="col-sm-6">
+ <a href="/news/2023/07/11/file-plugin-8.0.0.html">Next</a>
+ <br>
+ <br>
+ <a class="title"
href="/news/2023/07/11/file-plugin-8.0.0.html">File Plugin 8.0.0 Released!</a>
+ <div class="date"> 11 Jul 2023 - By Bryan Ellis </div>
+ <p class="content">
+ <!--
+ NOTE:
+ the markdownify filter is used here
+ because posts are rendered in sequence;
+ that is, the next post's content isn't
+ yet rendered at the time that this post
+ is being rendered, so page.next.excerpt
+ is still in Markdown and not HTML
+
+ Reference:
https://github.com/jekyll/jekyll/issues/2860
+ -->
+ We are happy to announce that we have just released an
update...
+ </p>
+
</div>
</div>
</footer>
diff --git a/blog/index.html b/blog/index.html
index 9344dfda6d..70ca6c37ec 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -130,6 +130,86 @@
</h1>
<ul class="posts">
+ <li>
+ <header>
+ <div class="adorner" blogTime="Tue, 11 Jul 2023 00:00:00
+0000"></div>
+ <h2 class="title">
+ <a href="/news/2023/07/11/file-plugin-8.0.0.html">File
Plugin 8.0.0 Released!</a>
+ </h2>
+ <div class="details">
+ <span class="date">11 Jul 2023</span>
+ - by
+ <span class="author">
+
+ Bryan Ellis
+
+ </span>
+ <a class="comment"
href="/news/2023/07/11/file-plugin-8.0.0.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>We are happy to announce that we have just released
an update for <code>cordova-plugin-file</code>!</p>
+
+<ul>
+ <li><a
href="https://www.npmjs.com/package/cordova-plugin-file";>[email protected]</a></li>
+</ul>
+
+<p><strong>To upgrade:</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova plugin remove cordova-plugin-file
+cordova plugin add [email protected]
+</code></pre></div></div>
+
+<h2>Release Highlights</h2>
+
+<h3>Breaking Changes</h3>
+
+<ul>
+ <li>
+ <p><strong>Removed <code>WRITE_EXTERNAL_STORAGE</code>
permission</strong></p>
+
+ <p>According to the official documentation on <a
href="https://developer.android.com/about/versions/11/privacy/storage";>Storage
updates in Android 11</a>, the <a
href="https://developer.android.com/reference/android/Manifest.permission#WRITE_EXTERNAL_STORAGE";><code>WRITE_EXTERNAL_STORAGE</code></a>
permission is no longer operational and does not grant access to write to
external storage.</p>
+
+ <blockquote>
+ <p>If this permission is not allowlisted for an app that targets an API
level before <a
href="https://developer.android.com/reference/android/os/Build.VERSION_CODES#Q";><code>Build.VERSION_CODES.Q</code></a>
(SDK 29) this permission cannot be granted to apps.</p>
+ </blockquote>
+
+ <p>Although Cordova has removed this permission from the plugin by
default, you can still add it back if needed by using the
<code>config-file</code> tag in your project's <code>config.xml</code>
file.</p>
+
+ <p>Example:</p>
+
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><config-file</span> <span
class="na">target=</span><span class="s">"AndroidManifest.xml"</span> <span
class="na">parent=</span><span class="s">"/*"</span> <span
class="na">xmlns:android=</span><span
class="s">"http://schemas.android.com/apk/res/android";</span><span
class="nt">></span>
+ <span class="nt"><uses-permission</span> <span
class="na">android:name=</span><span
class="s">"android.permission.WRITE_EXTERNAL_STORAGE"</span> <span
class="na">android:maxSdkVersion=</span><span class="s">"32"</span> <span
class="nt">/></span>
+ <span class="nt"></config-file></span>
+</code></pre></div> </div>
+
+ <p>It's important to note that other plugins used in your Cordova
project may still include the <code>WRITE_EXTERNAL_STORAGE</code> permission.
To verify whether the permission is added by other plugins, you can check the
merged <code>AndroidManifest.xml</code> file.</p>
+
+ <p>The merged <code>AndroidManifest.xml</code> file can be found at the
following location:</p>
+
+ <div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
platforms/android/app/build/intermediates/merged_manifest/debug/AndroidManifest.xml
+</code></pre></div> </div>
+
+ <p>Please keep in mind that the example file path provided above is
specific to debug builds. For release builds or different build variants, the
file path may vary slightly.</p>
+ </li>
+ <li>
+ <p><strong>Android 13+ Support</strong></p>
+
+ <p>Beginning from Android 13 (SDK 33), the
<code>READ_EXTERNAL_STORAGE</code> permission no longer has any effect.
Instead, this permission has been replaced with more granular permissions:
<code>READ_MEDIA_IMAGES</code>, <code>READ_MEDIA_VIDEO</code>, and
<code>READ_MEDIA_AUDIO</code>.</p>
+
+ <p>To adapt to this change, we have introduced these three new
permissions. This ensures that the existing functionality and behavior related
to reading various media file are maintained for Android 13 and higher
versions.</p>
+
+ <p>Furthermore, to support the new granular permissions and Android 13
(SDK 33), we have raised the minimum requirement for
<code>cordova-android</code> to version <code>12.0.0</code>. This version of
Cordova-Android specifically includes the necessary updates to handle Android
13 and compile your project with the new permissions successfully.</p>
+ </li>
+</ul>
+
+<p>Please report any issues you find by following the this <a
href="https://github.com/apache/cordova#filing-a-bug";>How to File a Bug</a>
guide!</p>
+
+</p>
+ <div><a
href="/news/2023/07/11/file-plugin-8.0.0.html">More...</a></div>
+ </section>
+ </li>
+
<li>
<header>
<div class="adorner" blogTime="Mon, 10 Jul 2023 00:00:00
+0000"></div>
@@ -13122,7 +13202,7 @@ window.twttr = (function(d, s, id) {
<script>
window.onload = function(){
setTimeout(function(){
- var lastPostTime = new Date("Mon, 10 Jul 2023 00:00:00
+0000").getTime();
+ var lastPostTime = new Date("Tue, 11 Jul 2023 00:00:00
+0000").getTime();
setCookie("visitTime", lastPostTime, 365);
}, 2000);
};
diff --git a/feed.xml b/feed.xml
index 956928f784..c91d93c198 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,10 +6,99 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml"; rel="self"
type="application/rss+xml"/>
- <pubDate>Tue, 11 Jul 2023 15:54:56 +0000</pubDate>
- <lastBuildDate>Tue, 11 Jul 2023 15:54:56 +0000</lastBuildDate>
+ <pubDate>Tue, 11 Jul 2023 15:55:35 +0000</pubDate>
+ <lastBuildDate>Tue, 11 Jul 2023 15:55:35 +0000</lastBuildDate>
<generator>Jekyll v4.3.2</generator>
+ <item>
+ <title>File Plugin 8.0.0 Released!</title>
+ <description><p>We are happy to announce that we have just
released an update for <code>cordova-plugin-file</code>!</p>
+
+<ul>
+ <li><a
href="https://www.npmjs.com/package/cordova-plugin-file">[email protected]</a></li>
+</ul>
+
+<p><strong>To upgrade:</strong></p>
+
+<div class="language-bash highlighter-rouge"><div
class="highlight"><pre
class="highlight"><code>cordova plugin remove
cordova-plugin-file
+cordova plugin add [email protected]
+</code></pre></div></div>
+
+<h2>Release Highlights</h2>
+
+<h3>Breaking Changes</h3>
+
+<ul>
+ <li>
+ <p><strong>Removed
<code>WRITE_EXTERNAL_STORAGE</code>
permission</strong></p>
+
+ <p>According to the official documentation on <a
href="https://developer.android.com/about/versions/11/privacy/storage">Storage
updates in Android 11</a>, the <a
href="https://developer.android.com/reference/android/Manifest.permission#WRITE_EXTERNAL_STORAGE"><code>WRITE_EXTERNAL_STORAGE</code></a>
permission is no longer operational and does not grant access to write to
external storage.</p>
+
+ <blockquote>
+ <p>If this permission is not allowlisted for an app that targets
an API level before <a
href="https://developer.android.com/reference/android/os/Build.VERSION_CODES#Q"><code>Build.VERSION_CODES.Q</code></a>
(SDK 29) this permission cannot be granted to apps.</p>
+ </blockquote>
+
+ <p>Although Cordova has removed this permission from the plugin by
default, you can still add it back if needed by using the
<code>config-file</code> tag in your project&#39;s
<code>config.xml</code> file.</p>
+
+ <p>Example:</p>
+
+ <div class="language-xml highlighter-rouge"><div
class="highlight"><pre
class="highlight"><code> <span
class="nt">&lt;config-file</span> <span
class="na">target=</span><span
class="s">"AndroidManifest.xml"</span> <span
class="na">parent=</span><span
class="s">"/*"</span> <span class="na&quo
[...]
+ <span class="nt">&lt;uses-permission</span>
<span class="na">android:name=</span><span
class="s">"android.permission.WRITE_EXTERNAL_STORAGE"</span>
<span class="na">android:maxSdkVersion=</span><span
class="s">"32"</span> <span
class="nt">/&gt;</span>
+ <span class="nt">&lt;/config-file&gt;</span>
+</code></pre></div> </div>
+
+ <p>It&#39;s important to note that other plugins used in your
Cordova project may still include the
<code>WRITE_EXTERNAL_STORAGE</code> permission. To verify whether
the permission is added by other plugins, you can check the merged
<code>AndroidManifest.xml</code> file.</p>
+
+ <p>The merged <code>AndroidManifest.xml</code> file can
be found at the following location:</p>
+
+ <div class="language-text highlighter-rouge"><div
class="highlight"><pre
class="highlight"><code>
platforms/android/app/build/intermediates/merged_manifest/debug/AndroidManifest.xml
+</code></pre></div> </div>
+
+ <p>Please keep in mind that the example file path provided above is
specific to debug builds. For release builds or different build variants, the
file path may vary slightly.</p>
+ </li>
+ <li>
+ <p><strong>Android 13+ Support</strong></p>
+
+ <p>Beginning from Android 13 (SDK 33), the
<code>READ_EXTERNAL_STORAGE</code> permission no longer has any
effect. Instead, this permission has been replaced with more granular
permissions: <code>READ_MEDIA_IMAGES</code>,
<code>READ_MEDIA_VIDEO</code>, and
<code>READ_MEDIA_AUDIO</code>.</p>
+
+ <p>To adapt to this change, we have introduced these three new
permissions. This ensures that the existing functionality and behavior related
to reading various media file are maintained for Android 13 and higher
versions.</p>
+
+ <p>Furthermore, to support the new granular permissions and Android
13 (SDK 33), we have raised the minimum requirement for
<code>cordova-android</code> to version
<code>12.0.0</code>. This version of Cordova-Android specifically
includes the necessary updates to handle Android 13 and compile your project
with the new permissions successfully.</p>
+ </li>
+</ul>
+
+<p>Please report any issues you find by following the this <a
href="https://github.com/apache/cordova#filing-a-bug">How to File
a Bug</a> guide!</p>
+
+<!--more-->
+<h2>Changes Log</h2>
+
+<ul>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/534">GH-534</a>
fix(android): <code>FileError</code> on a content
<code>resolveLocalFileSystemURL</code></li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/566">GH-566</a>
feat(android): add <code>READ_MEDIA_*</code> permissions for
Android 13+</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/576">GH-576</a>
feat(android)!: bump <code>cordova-android@12</code>
requirement</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/575">GH-575</a>
ci: sync github workflow with paramedic base configs</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/574">GH-574</a>
chore: update <code>@cordova/[email protected]</code> w/
fixes</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/556">GH-556</a>
feat(android)!: remove <code>WRITE_EXTERNAL_STORAGE</code>
permission from <code>plugin.xml</code></li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/554">GH-554</a>
spec(android): fix spec based on testing environment</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/547">GH-547</a>
fix(types): Mark <code>FileWriter.write</code> to support
<code>ArrayBuffer</code> data</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/535">GH-535</a>
ci: sync workflow with paramedic</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/531">GH-531</a>
dep(npm): bump package-lock v2 w/ rebuild</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/529">GH-529</a>
ci(android): update java requirement for
<code>cordova-android@11</code></li>
+</ul>
+</description>
+ <pubDate>Tue, 11 Jul 2023 00:00:00 +0000</pubDate>
+
<link>https://cordova.apache.org/news/2023/07/11/file-plugin-8.0.0.html</link>
+ <guid
isPermaLink="true">https://cordova.apache.org/news/2023/07/11/file-plugin-8.0.0.html</guid>
+
+ <category>release</category>
+
+ <category>plugins</category>
+
+
+ <category>news</category>
+
+ </item>
+
<item>
<title>Cordova iOS 7.0.0 Released!</title>
<description><p>We are happy to announce that we have just
released <code>Cordova iOS 7.0.0</code>! This is one of
Cordova&#39;s supported platforms for building iOS applications.</p>
@@ -924,50 +1013,5 @@ cordova plugin add [email protected]
</item>
- <item>
- <title>Media Plugin 6.1.0 Released!</title>
- <description><p>We are happy to announce that we have just
released an update for <code>cordova-plugin-media</code>!</p>
-
-<ul>
- <li><a
href="https://www.npmjs.com/package/cordova-plugin-media">[email protected]</a></li>
-</ul>
-
-<p><strong>To upgrade:</strong></p>
-
-<div class="language-bash highlighter-rouge"><div
class="highlight"><pre
class="highlight"><code>cordova plugin remove
cordova-plugin-media
-cordova plugin add [email protected]
-</code></pre></div></div>
-
-<h2>Release Highlights</h2>
-
-<p>For Android, we updated the media error response object to include
the &quot;message&quot; property. This property will provide additional
information about the error. It also syncs in line with the media error
response object that iOS returns.</p>
-
-<p>For iOS, file scheme support has been implemented. Two fixes were
applied to prevent crashes that occured when fetching the position while the
time was not defined and to ensured that the category was defined after the
recording was released.</p>
-
-<p>Please report any issues you find by following the this <a
href="https://github.com/apache/cordova#filing-a-bug">How to File
a Bug</a> guide!</p>
-
-<!--more-->
-<h1>Changes include:</h1>
-
-<ul>
- <li><a
href="https://github.com/apache/cordova-plugin-media/pull/357">GH-357</a>
feat(android): add &#39;<code>message</code>&#39; field to
media error <a
href="https://issues.apache.org/jira/browse/CB-11641">CB-11641</a></li>
- <li><a
href="https://github.com/apache/cordova-plugin-media/pull/352">GH-352</a>
feat(ios): support <code>file</code> scheme</li>
- <li><a
href="https://github.com/apache/cordova-plugin-media/pull/354">GH-354</a>
fix(ios): Reset default audio session category when release (<a
href="https://issues.apache.org/jira/browse/CB-13243">CB-13243</a>)</li>
- <li><a
href="https://github.com/apache/cordova-plugin-media/pull/353">GH-353</a>
fix(ios): error on <code>getPosition</code> when time is
<code>nan</code></li>
-</ul>
-</description>
- <pubDate>Fri, 09 Sep 2022 00:00:00 +0000</pubDate>
-
<link>https://cordova.apache.org/news/2022/09/09/media-plugin-6.1.0.html</link>
- <guid
isPermaLink="true">https://cordova.apache.org/news/2022/09/09/media-plugin-6.1.0.html</guid>
-
- <category>release</category>
-
- <category>plugins</category>
-
-
- <category>news</category>
-
- </item>
-
</channel>
</rss>
diff --git a/news/2023/07/11/file-plugin-8.0.0.html
b/news/2023/07/11/file-plugin-8.0.0.html
new file mode 100644
index 0000000000..e9303fd2ba
--- /dev/null
+++ b/news/2023/07/11/file-plugin-8.0.0.html
@@ -0,0 +1,354 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta name="format-detection" content="telephone=no">
+ <meta name="viewport" content="user-scalable=no, initial-scale=1,
maximum-scale=1, minimum-scale=1, width=device-width" />
+ <meta name="description" content="We are happy to announce that we have
just released an update for cordova-plugin-file! [email protected]
upgrade:cordova plugin remove cordova-plu...">
+
+ <title>
+
+
+ File Plugin 8.0.0 Released! - Apache Cordova
+
+
+ </title>
+
+ <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+
+
+
+
+
+
+ <link rel="canonical"
href="https://cordova.apache.org/news/2023/07/11/file-plugin-8.0.0.html";>
+
+ <!-- CSS -->
+ <link rel="stylesheet" type="text/css" href="/static/css/main.css">
+ <link rel="stylesheet" type="text/css" href="/static/css/lib/syntax.css">
+ <!-- Algolia Search CSS -->
+ <link rel="stylesheet"
href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"; />
+
+ <!-- Fonts -->
+ <!-- For attribution information, see www/attributions.html -->
+ <link
href='https://fonts.googleapis.com/css?family=Raleway:700,400,300,700italic,400italic,300italic'
rel='stylesheet' type='text/css'>
+
+ <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media
queries -->
+ <!--[if lt IE 9]>
+ <script
src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js";></script>
+ <script
src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js";></script>
+ <![endif]-->
+ <script type="text/javascript">
+ var disqus_developer = 1; // this would set it to developer mode
+ </script>
+
+ <!-- JS -->
+ <script defer type="text/javascript"
src="/static/js/lib/jquery-2.1.1.min.js"></script>
+ <script defer type="text/javascript"
src="/static/js/lib/bootstrap.min.js"></script>
+
+ <!-- Matomo -->
+<script>
+ var _paq = window._paq = window._paq || [];
+ /* tracker methods like "setCustomDimension" should be called before
"trackPageView" */
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+ (function() {
+ var u="https://analytics.apache.org/";;
+ _paq.push(['setTrackerUrl', u+'matomo.php']);
+ _paq.push(['setSiteId', '16']);
+ var d=document, g=d.createElement('script'),
s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+ <!-- End Matomo Code -->
+
+
+</head>
+
+<body>
+ <header>
+ <a class="scroll-point pt-top" name="top"></a>
+ <nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed"
data-toggle="collapse" data-target="#navbar" aria-expanded="false"
aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img id="logo_top"
src="/static/img/cordova-logo-newbrand.svg"/></a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <div class="nav_bar_center">
+ <ul class="nav navbar-nav">
+ <li >
+ <a href="/docs/en/latest/">Documentation</a>
+ </li>
+ <li >
+ <a href="/plugins">Plugins</a>
+ </li>
+ <li class="active">
+ <a href="/blog" id="blog_button">Blog<span
class="badge" id="new_blog_count"></span></a>
+ </li>
+ <li >
+ <a href="/contribute">Contribute</a>
+ </li>
+ <li >
+ <a href="/contribute/team.html">Team</a>
+ </li>
+ <li>
+ <a href="/#getstarted">Get Started</a>
+ </li>
+ <li>
+ <form class="navbar-form navbar-right"
id="header-search-form" role="search">
+ <div class="input-group">
+
+ <input id="header-search-field"
type="text" placeholder="Search '11.x' docs..." class="form-control hidden-xs"
autocomplete="off">
+ </div>
+ </form>
+ </li>
+ </ul>
+ </div>
+ </div><!--/.navbar-collapse -->
+ </div>
+ </nav>
+ <div id="_fixed_navbar_spacer" style="padding-top:50px"></div>
+</header>
+
+<div class="page container">
+ <div class="blog">
+ <h1 class="blogHeader">
+ Blog
+ <span class="rss">
+ <img src="/static/img/subscribe.png"><a href="/feed.xml">RSS Feed</a>
+ </span>
+</h1>
+
+<div class="post">
+ <header>
+ <div class="title">File Plugin 8.0.0 Released!</div>
+ <div class="author">By:
+
+ Bryan Ellis
+
+ </div>
+ <div class="date">11 Jul 2023</div>
+ </header>
+ <section>
+ <div>
+ <p>We are happy to announce that we have just released an update
for <code>cordova-plugin-file</code>!</p>
+
+<ul>
+ <li><a
href="https://www.npmjs.com/package/cordova-plugin-file";>[email protected]</a></li>
+</ul>
+
+<p><strong>To upgrade:</strong></p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>cordova plugin remove cordova-plugin-file
+cordova plugin add [email protected]
+</code></pre></div></div>
+
+<h2>Release Highlights</h2>
+
+<h3>Breaking Changes</h3>
+
+<ul>
+ <li>
+ <p><strong>Removed <code>WRITE_EXTERNAL_STORAGE</code>
permission</strong></p>
+
+ <p>According to the official documentation on <a
href="https://developer.android.com/about/versions/11/privacy/storage";>Storage
updates in Android 11</a>, the <a
href="https://developer.android.com/reference/android/Manifest.permission#WRITE_EXTERNAL_STORAGE";><code>WRITE_EXTERNAL_STORAGE</code></a>
permission is no longer operational and does not grant access to write to
external storage.</p>
+
+ <blockquote>
+ <p>If this permission is not allowlisted for an app that targets an API
level before <a
href="https://developer.android.com/reference/android/os/Build.VERSION_CODES#Q";><code>Build.VERSION_CODES.Q</code></a>
(SDK 29) this permission cannot be granted to apps.</p>
+ </blockquote>
+
+ <p>Although Cordova has removed this permission from the plugin by
default, you can still add it back if needed by using the
<code>config-file</code> tag in your project's <code>config.xml</code>
file.</p>
+
+ <p>Example:</p>
+
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><config-file</span> <span
class="na">target=</span><span class="s">"AndroidManifest.xml"</span> <span
class="na">parent=</span><span class="s">"/*"</span> <span
class="na">xmlns:android=</span><span
class="s">"http://schemas.android.com/apk/res/android";</span><span
class="nt">></span>
+ <span class="nt"><uses-permission</span> <span
class="na">android:name=</span><span
class="s">"android.permission.WRITE_EXTERNAL_STORAGE"</span> <span
class="na">android:maxSdkVersion=</span><span class="s">"32"</span> <span
class="nt">/></span>
+ <span class="nt"></config-file></span>
+</code></pre></div> </div>
+
+ <p>It's important to note that other plugins used in your Cordova
project may still include the <code>WRITE_EXTERNAL_STORAGE</code> permission.
To verify whether the permission is added by other plugins, you can check the
merged <code>AndroidManifest.xml</code> file.</p>
+
+ <p>The merged <code>AndroidManifest.xml</code> file can be found at the
following location:</p>
+
+ <div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
platforms/android/app/build/intermediates/merged_manifest/debug/AndroidManifest.xml
+</code></pre></div> </div>
+
+ <p>Please keep in mind that the example file path provided above is
specific to debug builds. For release builds or different build variants, the
file path may vary slightly.</p>
+ </li>
+ <li>
+ <p><strong>Android 13+ Support</strong></p>
+
+ <p>Beginning from Android 13 (SDK 33), the
<code>READ_EXTERNAL_STORAGE</code> permission no longer has any effect.
Instead, this permission has been replaced with more granular permissions:
<code>READ_MEDIA_IMAGES</code>, <code>READ_MEDIA_VIDEO</code>, and
<code>READ_MEDIA_AUDIO</code>.</p>
+
+ <p>To adapt to this change, we have introduced these three new
permissions. This ensures that the existing functionality and behavior related
to reading various media file are maintained for Android 13 and higher
versions.</p>
+
+ <p>Furthermore, to support the new granular permissions and Android 13
(SDK 33), we have raised the minimum requirement for
<code>cordova-android</code> to version <code>12.0.0</code>. This version of
Cordova-Android specifically includes the necessary updates to handle Android
13 and compile your project with the new permissions successfully.</p>
+ </li>
+</ul>
+
+<p>Please report any issues you find by following the this <a
href="https://github.com/apache/cordova#filing-a-bug";>How to File a Bug</a>
guide!</p>
+
+<!--more-->
+<h2>Changes Log</h2>
+
+<ul>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/534";>GH-534</a>
fix(android): <code>FileError</code> on a content
<code>resolveLocalFileSystemURL</code></li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/566";>GH-566</a>
feat(android): add <code>READ_MEDIA_*</code> permissions for Android 13+</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/576";>GH-576</a>
feat(android)!: bump <code>cordova-android@12</code> requirement</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/575";>GH-575</a> ci:
sync github workflow with paramedic base configs</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/574";>GH-574</a> chore:
update <code>@cordova/[email protected]</code> w/ fixes</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/556";>GH-556</a>
feat(android)!: remove <code>WRITE_EXTERNAL_STORAGE</code> permission from
<code>plugin.xml</code></li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/554";>GH-554</a>
spec(android): fix spec based on testing environment</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/547";>GH-547</a>
fix(types): Mark <code>FileWriter.write</code> to support
<code>ArrayBuffer</code> data</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/535";>GH-535</a> ci:
sync workflow with paramedic</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/531";>GH-531</a>
dep(npm): bump package-lock v2 w/ rebuild</li>
+ <li><a
href="https://github.com/apache/cordova-plugin-file/pull/529";>GH-529</a>
ci(android): update java requirement for <code>cordova-android@11</code></li>
+</ul>
+
+ </div>
+ </section>
+ <footer>
+ <div class="row">
+ <div class="col-sm-6">
+
+ <a
href="/announcements/2023/07/10/cordova-ios-7.0.0.html">Previous</a>
+ <br>
+ <br>
+ <a class="title"
href="/announcements/2023/07/10/cordova-ios-7.0.0.html">Cordova iOS 7.0.0
Released!</a>
+ <div class="date"> 10 Jul 2023 - By Bryan Ellis </div>
+ <p class="content">
+ We are happy to announce that we have just released
Cordova iOS...
+ </p>
+
+ </div>
+ <div class="col-sm-6">
+
+ </div>
+ </div>
+ </footer>
+ <div class="disqus">
+ <div id="disqus_thread"></div>
+<script type="text/javascript">
+ /* * * CONFIGURATION VARIABLES * * */
+ var disqus_shortname = 'cordovablogs';
+
+ /* * * DON'T EDIT BELOW THIS LINE * * */
+ (function() {
+ var dsq = document.createElement('script'); dsq.type =
'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] ||
document.getElementsByTagName('body')[0]).appendChild(dsq);
+ })();
+</script>
+<noscript>Please enable JavaScript to view the <a
href="https://disqus.com/?ref_noscript"; rel="nofollow">comments powered by
Disqus.</a></noscript>
+
+ </div>
+</div>
+
+</div>
+
+</div>
+
+<div class="blue-divider"></div>
+<footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-sm-9">
+ <h1>More Resources</h1>
+ <div class="row">
+ <div class="col-sm-4">
+ <h2>General</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank"
href="https://projects.apache.org/project.html?cordova";>Apache Project Page</a>
+ </li>
+ <li>
+ <a
href="https://www.apache.org/dyn/closer.cgi/cordova";>Source Distribution</a>
+ </li>
+ <li>
+ <a target="_blank"
href="https://www.apache.org/licenses/LICENSE-2.0";>License</a>
+ </li>
+ <li>
+ <a href="/artwork">Artwork</a>
+ </li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Development</h2>
+ <ul class="nav">
+ <li><a target="_blank"
href="https://github.com/apache?utf8=%E2%9C%93&q=cordova-";>Source
Code</a></li>
+ <li><a target="_blank"
href="https://github.com/apache/cordova#filing-a-bug";>Issue Tracker</a></li>
+ <li><a target="_blank"
href="https://stackoverflow.com/questions/tagged/cordova";>Stack
Overflow</a></li>
+ <li><a href="/contact">Mailing List</a></li>
+ <li><a href="/contribute/nightly_builds.html">Nightly
builds</a></li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Apache Software Foundation</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank"
href="https://www.apache.org/";>About ASF</a>
+ </li>
+ <li>
+ <a target="_blank"
href="https://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a>
+ </li>
+ <li>
+ <a target="_blank"
href="https://www.apache.org/foundation/thanks.html";>Thanks</a>
+ </li>
+ <li>
+ <a target="_blank"
href="https://www.apache.org/security/";>Security</a>
+ </li>
+ <li>
+ <a target="_blank"
href="https://privacy.apache.org/policies/privacy-policy-public.html";>Privacy
policy</a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm-3">
+ <h1>Contribute</h1>
+ <p style="padding-top:20px"><strong>Help Cordova move
forward!</strong></p>
+ <p>Report bugs, improve the docs, or contribute to the code.</p>
+ <a href="/contribute" class="btn btn-lg btn-primary">
+ Learn More
+ </a>
+ <p style="padding-top:20px"> <a
href="https://twitter.com/apachecordova"; class="twitter-follow-button"
data-show-count="false">Follow @apachecordova</a></p>
+ <script async defer
src="https://slack-cordova-io.herokuapp.com/slackin.js";></script>
+ </div>
+</div>
+<p class="copyright_text">
+ Copyright © 2023 The Apache Software Foundation, Licensed under the
<a target="_blank" href="https://www.apache.org/licenses/LICENSE-2.0";>Apache
License, Version 2.0</a>.<br/>
+ Apache and the Apache feather logos are <a target="_blank"
href="https://www.apache.org/foundation/marks/list/";>trademarks</a> of The
Apache Software Foundation.
+ <br/>
+ <p>See the <a href="/attributions/">attributions page</a> for other
copyright & trademark notices.</p>
+</p>
+
+ </div>
+</footer>
+
+
+ <script defer type="text/javascript" src="/static/js/index.js"></script>
+ <script defer type="text/javascript" src="/static/js/twitter.js"></script>
+
+
+
+
+<script type="text/javascript"
src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js";></script>
+<script type="text/javascript">
+ docsearch({
+ apiKey: '0a916ab198bd93d031aa70611271e42e',
+ indexName: 'cordova',
+ inputSelector: '#header-search-field',
+ algoliaOptions: { 'facetFilters': ["version: 11.x", "language: en"] }
+ });
+</script>
+
+</body>
+</html>
diff --git a/sitemap.xml b/sitemap.xml
index c8d6edc588..0ff18e9b6c 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -3,6 +3,11 @@
<!-- posts -->
+<url>
+
<loc>https://cordova.apache.org/news/2023/07/11/file-plugin-8.0.0.html</loc>
+</url>
+
+
<url>
<loc>https://cordova.apache.org/announcements/2023/07/10/cordova-ios-7.0.0.html</loc>
</url>
diff --git a/static/js/index.js b/static/js/index.js
index f64962bcd2..965588fb53 100644
--- a/static/js/index.js
+++ b/static/js/index.js
@@ -47,6 +47,7 @@ function checkNotification() {
var dates = [];
if (lastVisit != "") {
+ dates.push('Tue, 11 Jul 2023 00:00:00 +0000');
dates.push('Mon, 10 Jul 2023 00:00:00 +0000');
dates.push('Mon, 22 May 2023 00:00:00 +0000');
dates.push('Mon, 22 May 2023 00:00:00 +0000');
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
