This is an automated email from the ASF dual-hosted git repository.
erisu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 5f0cd7c11d doc(release): cordova-plugin-file@8.0.0 (#1322)
5f0cd7c11d is described below
commit 5f0cd7c11d700fec7771a22ddfb8051b4aa3df3e
Author: エリス <er...@users.noreply.github.com>
AuthorDate: Wed Jul 12 00:53:55 2023 +0900
doc(release): cordova-plugin-file@8.0.0 (#1322)
---
www/_posts/2023-07-11-file-plugin-8.0.0.md | 74 ++++++++++++++++++++++++++++++
1 file changed, 74 insertions(+)
diff --git a/www/_posts/2023-07-11-file-plugin-8.0.0.md
b/www/_posts/2023-07-11-file-plugin-8.0.0.md
new file mode 100644
index 0000000000..000bf29051
--- /dev/null
+++ b/www/_posts/2023-07-11-file-plugin-8.0.0.md
@@ -0,0 +1,74 @@
+---
+layout: post
+author:
+ name: Bryan Ellis
+title: "File Plugin 8.0.0 Released!"
+categories: news
+tags: release plugins
+---
+
+We are happy to announce that we have just released an update for
`cordova-plugin-file`!
+
+*
[cordova-plugin-file@8.0.0](https://www.npmjs.com/package/cordova-plugin-file)
+
+**To upgrade:**
+
+```bash
+cordova plugin remove cordova-plugin-file
+cordova plugin add cordova-plugin-file@8.0.0
+```
+
+## Release Highlights
+
+### Breaking Changes
+
+* **Removed `WRITE_EXTERNAL_STORAGE` permission**
+
+ According to the official documentation on [Storage updates in Android
11](https://developer.android.com/about/versions/11/privacy/storage), the
[`WRITE_EXTERNAL_STORAGE`](https://developer.android.com/reference/android/Manifest.permission#WRITE_EXTERNAL_STORAGE)
permission is no longer operational and does not grant access to write to
external storage.
+
+ > If this permission is not allowlisted for an app that targets an API
level before
[`Build.VERSION_CODES.Q`](https://developer.android.com/reference/android/os/Build.VERSION_CODES#Q)
(SDK 29) this permission cannot be granted to apps.
+
+ Although Cordova has removed this permission from the plugin by default,
you can still add it back if needed by using the `config-file` tag in your
project's `config.xml` file.
+
+ Example:
+
+ ```xml
+ <config-file target="AndroidManifest.xml" parent="/*"
xmlns:android="http://schemas.android.com/apk/res/android";>
+ <uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="32" />
+ </config-file>
+ ```
+
+ It's important to note that other plugins used in your Cordova project may
still include the `WRITE_EXTERNAL_STORAGE` permission. To verify whether the
permission is added by other plugins, you can check the merged
`AndroidManifest.xml` file.
+
+ The merged `AndroidManifest.xml` file can be found at the following
location:
+
+ ```text
+
platforms/android/app/build/intermediates/merged_manifest/debug/AndroidManifest.xml
+ ```
+
+ 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.
+
+* **Android 13+ Support**
+
+ Beginning from Android 13 (SDK 33), the `READ_EXTERNAL_STORAGE` permission
no longer has any effect. Instead, this permission has been replaced with more
granular permissions: `READ_MEDIA_IMAGES`, `READ_MEDIA_VIDEO`, and
`READ_MEDIA_AUDIO`.
+
+ 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.
+
+ Furthermore, to support the new granular permissions and Android 13 (SDK
33), we have raised the minimum requirement for `cordova-android` to version
`12.0.0`. This version of Cordova-Android specifically includes the necessary
updates to handle Android 13 and compile your project with the new permissions
successfully.
+
+Please report any issues you find by following the this [How to File a
Bug](https://github.com/apache/cordova#filing-a-bug) guide!
+
+<!--more-->
+## Changes Log
+
+* [GH-534](https://github.com/apache/cordova-plugin-file/pull/534)
fix(android): `FileError` on a content `resolveLocalFileSystemURL`
+* [GH-566](https://github.com/apache/cordova-plugin-file/pull/566)
feat(android): add `READ_MEDIA_*` permissions for Android 13+
+* [GH-576](https://github.com/apache/cordova-plugin-file/pull/576)
feat(android)!: bump `cordova-android@12` requirement
+* [GH-575](https://github.com/apache/cordova-plugin-file/pull/575) ci: sync
github workflow with paramedic base configs
+* [GH-574](https://github.com/apache/cordova-plugin-file/pull/574) chore:
update `@cordova/eslint-config@5.0.0` w/ fixes
+* [GH-556](https://github.com/apache/cordova-plugin-file/pull/556)
feat(android)!: remove `WRITE_EXTERNAL_STORAGE` permission from `plugin.xml`
+* [GH-554](https://github.com/apache/cordova-plugin-file/pull/554)
spec(android): fix spec based on testing environment
+* [GH-547](https://github.com/apache/cordova-plugin-file/pull/547) fix(types):
Mark `FileWriter.write` to support `ArrayBuffer` data
+* [GH-535](https://github.com/apache/cordova-plugin-file/pull/535) ci: sync
workflow with paramedic
+* [GH-531](https://github.com/apache/cordova-plugin-file/pull/531) dep(npm):
bump package-lock v2 w/ rebuild
+* [GH-529](https://github.com/apache/cordova-plugin-file/pull/529)
ci(android): update java requirement for `cordova-android@11`
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
