feat(android): add READ_MEDIA_* permissions for Android 13+ (apache#566)

* Add READ_MEDIA - permissions for Android 13+
* Fix spelling in permssion string

---------

Co-authored-by: maurice.frank <[email protected]>

Author: MauriceFrank

src/android/FileUtils.java

@@ -100,12 +100,25 @@ public class FileUtils extends CordovaPlugin {
     private PendingRequests pendingRequests;
 
     /*
-     * We need both read and write when accessing the storage, I think.
+     * We need both read and write when accessing the storage, I think. (SDK Version < 33)
+     * 
+     * If your app targets Android 13 (SDK 33) or higher and needs to access media files that other apps have created, 
+     * you must request one or more of the following granular media permissions 
+     * instead of the READ_EXTERNAL_STORAGE permission:
+     * 
+     * READ_MEDIA_IMAGES
+     * READ_MEDIA_VIDEO
+     * READ_MEDIA_AUDIO
+     * 
+     * Refer to: https://developer.android.com/about/versions/13/behavior-changes-13
      */
 
     private String [] permissions = {
             Manifest.permission.READ_EXTERNAL_STORAGE,
-            Manifest.permission.WRITE_EXTERNAL_STORAGE };
+            Manifest.permission.WRITE_EXTERNAL_STORAGE,
+            Manifest.permission.READ_MEDIA_IMAGES,
+            Manifest.permission.READ_MEDIA_VIDEO,
+            Manifest.permission.READ_MEDIA_AUDIO};
 
     // This field exists only to support getEntry, below, which has been deprecated
     private static FileUtils filePlugin;
@@ -577,7 +590,12 @@ public void run(JSONArray args) throws FileNotFoundException, JSONException, Mal
 
     private void getReadPermission(String rawArgs, int action, CallbackContext callbackContext) {
         int requestCode = pendingRequests.createRequest(rawArgs, action, callbackContext);
-        PermissionHelper.requestPermission(this, requestCode, Manifest.permission.READ_EXTERNAL_STORAGE);
+        if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            PermissionHelper.requestPermissions(this, requestCode, 
+            new String[]{Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.READ_MEDIA_VIDEO, Manifest.permission.READ_MEDIA_AUDIO});
+          } else {
+            PermissionHelper.requestPermission(this, requestCode, Manifest.permission.READ_EXTERNAL_STORAGE);
+          }
     }
 
     private void getWritePermission(String rawArgs, int action, CallbackContext callbackContext) {
@@ -586,7 +604,13 @@ private void getWritePermission(String rawArgs, int action, CallbackContext call
     }
 
     private boolean hasReadPermission() {
-        return PermissionHelper.hasPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE);
+        if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            return PermissionHelper.hasPermission(this, Manifest.permission.READ_MEDIA_IMAGES) 
+            && PermissionHelper.hasPermission(this, Manifest.permission.READ_MEDIA_VIDEO)
+            && PermissionHelper.hasPermission(this, Manifest.permission.READ_MEDIA_AUDIO);
+          } else {
+            return PermissionHelper.hasPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE);
+          }
     }
 
     private boolean hasWritePermission() {