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-plugin-media.git
The following commit(s) were added to refs/heads/master by this push:
new 8b398f7 doc(android): add quirks for WRITE_EXTERNAL_STORAGE
permission (#386)
8b398f7 is described below
commit 8b398f7d7822b2f821245107e91754f58c9c9973
Author: エリス <er...@users.noreply.github.com>
AuthorDate: Wed Sep 13 21:23:56 2023 +0900
doc(android): add quirks for WRITE_EXTERNAL_STORAGE permission (#386)
---
README.md | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/README.md b/README.md
index 62db81c..0e629ff 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,22 @@ cordova plugin add cordova-plugin-media
- iOS
- Browser
+### Android Quirks
+
+#### SDK Target Less Than 29
+
+From the official [Storage updates in Android
11](https://developer.android.com/about/versions/11/privacy/storage)
documentation, the
[`WRITE_EXTERNAL_STORAGE`](https://developer.android.com/reference/android/Manifest.permission#WRITE_EXTERNAL_STORAGE)
permission is no longer operational and does not provide access.
+
+> 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.
+
+If you need to add this permission, please add the following to your
`config.xml`.
+
+```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="28" />
+</config-file>
+```
+
## Media
```js
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
