Android存储权限完美适配（Android11及以上适配）

一、Bug简述

一个很普通的需求，需要下载图片到本地，我的三个测试机（荣耀Android10，红米 11 和小米Android 13都没有问题）。

然后，主角登场了，测试的三星Android 13 死活拉不起存储权限弹窗。

想了下，三星的系统可能和小米的系统做了些区别。于是就是看了下存储权限的版本更迭，却是发现了些骚东西。

二、原因

很早以前，一直都是在manifest申明这两个权限就可以了，但是现在会有下面的警告！

这便是错误的原因：

 可以得知，在Android 13（sdkversion为33）的系统中，已经被废弃了！！！

但是如果你给Write和Read权限加上maxSdkVersion=32，他在11，12上是没有问题的，但是最新的App要求 target sdkversion必须是33了。

所以，在此就必须做一个适配：

Android 11 里将引入一个特别的权限叫做 MANAGE_EXTERNAL_STORAGE，该权限将授权读写所有共享存储内容，这也将同时包含非媒体类型的文件。但是获得这个权限的应用还是无法访问其他应用的应用专属目录 (app-specific directory)，无论是外部存储还是内部存储。

那么，为了兼容Android版本，我就必须在Android11之前和之后分开做申请才会有用。

三、步骤

1).申明权限

manifest文件里：

<uses-permission
    android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    tools:ignore="ScopedStorage" />

2）.权限的判断

判断是否已经获得权限：

 private fun checkPer(activity: PreViewActivity): Boolean {
        return if (Build.VERSION.SDK_INT >= 30) {
            EasyPermissions.hasPermissions(
                activity,
                android.Manifest.permission.MANAGE_EXTERNAL_STORAGE
            )
        } else {
            EasyPermissions.hasPermissions(
                activity,
                android.Manifest.permission.WRITE_EXTERNAL_STORAGE
            )
        }
    }

未获得权限，申请权限

private fun aaa(activity: PreViewActivity, curImg: Int) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            
                val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
                intent.data = Uri.parse("package:" + activity.packageName)
                activity.startActivityForResult(intent, 200)
           
        } else {
            val perm = android.Manifest.permission.WRITE_EXTERNAL_STORAGE
            PaperThreeVariable.isToRequestPer = true
            EasyPermissions.requestPermissions(
                PermissionRequest.Builder(
                    activity,
                    200,
                    perm
                )
                    .build()
            )
        }
    }

权限申请回调

    override fun onRequestPermissionsResult(
        requestCode: Int, permissions: Array<String>, grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this)
    }

    override fun onPermissionsGranted(requestCode: Int, perms: MutableList<String>) {
        AppInitUtils().saveFreshAppImageToGallery(this, curImg)
        PaperThreeVariable.isToRequestPer = false
    }

    override fun onPermissionsDenied(requestCode: Int, perms: MutableList<String>) {
        PaperThreeVariable.isToRequestPer = false
        if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
            AppSettingsDialog.Builder(this)
                .setRationale("This function requires storage permission to be enabled")
                .setNegativeButton("No")
                .setPositiveButton("Yes")
                .build().show()
        }
    }

因为有时候用户会拒绝权限且永久弹窗，所以为了方便我就用了EasyPermission这个库，拒绝的情况下，弹窗跳转系统权限设置页面去让用户选择开启权限。

这样，就OK啦！(至于我的小米为啥Android 13也能正常拉起，我也不知道具体原因，但是在Android Studio的历史链接设备中，我发现它识别我的手机系统为Android 12，真是百思不得其解)

本文参考了郭霖大神的一篇文章，当时是想看下 Scoped Storage这个属性的内容，接过发现了Android 11的变更。

Android 11新特性，Scoped Storage又有了新花样

仅做个人工作总结，内容肯定不够全面，如有问题，欢迎大佬指正！

Android Permission 权限申请，EasyPermission和其他三方库_安卓权限申请_&岁月不待人&的博客-CSDN博客

补充：

因为 MANAGE_EXTERNAL_STORAGE，该权限将授权读写所有共享存储内容，所以在谷歌中属于敏感权限，不容易通过，如果只是想保存图片，则可以通过下面的博客中的方法去保存

Android 保存图片并刷新相册（无需权限）-CSDN博客

Android Gilde获取网络图片显示保存路径并转化为bitmap-CSDN博客

四、总结性补充

2025.2.6

1. Android 9 及以下（API 级别 28 及以下）

• 权限要求：
  • 需要 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限才能访问外部存储。
• 特点：
  • 可以访问 /sdcard 目录及其子目录的所有文件。
  • 应用卸载后，其创建的文件仍然存在。

2. Android 10（API 级别 29）—— 引入分区存储（Scoped Storage）

• 权限要求：
  • READ_EXTERNAL_STORAGE 仍然适用。
  • WRITE_EXTERNAL_STORAGE 仍适用，但影响范围缩小。
• 特点：
  • 分区存储：应用只能访问自己应用目录下的文件 /Android/data/your.package.name/。
  • 无法直接操作其他应用创建的文件（除了 MediaStore API 提供的公共媒体文件）。
  • 仍可使用 requestLegacyExternalStorage=true 来暂时保持旧行为（Android 11 及以上无效）。
• 适配方案：
  • 对于 图片、视频、音频，应使用 MediaStore 进行访问和存储。
  • 对于 私有文件，应存放在 getExternalFilesDir() 或 getDataDir() 目录下。

3. Android 11（API 级别 30）—— 强制分区存储

• 权限要求：
  • READ_EXTERNAL_STORAGE 仍然适用（仅限于 MediaStore）。
  • WRITE_EXTERNAL_STORAGE 彻底失效，无法申请。
  • 访问某些特定目录（如 Documents/Download）需要 MANAGE_EXTERNAL_STORAGE 权限（敏感权限，Google Play 限制使用）。
• 特点：
  • requestLegacyExternalStorage=true 不再有效，强制启用 分区存储。
  • 禁止访问 /sdcard/ 根目录，只能访问 MediaStore 提供的共享媒体文件（图片、视频、音频）。
  • 应用卸载后，应用私有目录下的文件会被自动清理。
• 适配方案：
  • 普通应用：只能访问 MediaStore 提供的媒体文件（推荐使用 ACTION_OPEN_DOCUMENT 选择文件）。
  • 特殊情况：
    • 需要 MANAGE_EXTERNAL_STORAGE 权限，但 Google Play 限制其使用，必须填写申请理由，除非是文件管理类 App，否则会被拒绝。
    • 如果是 非商店渠道（如企业内部发布），可以直接使用 Environment.getExternalStorageDirectory()。

4. Android 13（API 级别 33）—— 细化媒体权限

• 权限要求：
  • READ_MEDIA_IMAGES（访问图片）
  • READ_MEDIA_VIDEO（访问视频）
  • READ_MEDIA_AUDIO（访问音频）
• 特点：
  • 细化媒体文件权限，用户可以选择性地授予权限，而不必一次性授予所有媒体访问权限。
  • 其他限制和 Android 11 保持一致。
• 适配方案：
  • 需要分别请求 READ_MEDIA_IMAGES、READ_MEDIA_VIDEO 和 READ_MEDIA_AUDIO 权限，而不是 READ_EXTERNAL_STORAGE。

版本	访问私有目录	访问公共媒体文件	访问其他应用的文件
Android 9 及以下	READ/WRITE_EXTERNAL_STORAGE	直接访问	直接访问
Android 10	getExternalFilesDir()	MediaStore	受限，部分目录无法访问
Android 11	getExternalFilesDir()	MediaStore	受限，无法直接访问
Android 13	getExternalFilesDir()	需要申请 READ_MEDIA_IMAGES、READ_MEDIA_VIDEO、READ_MEDIA_AUDIO	受限，无法直接访问