You need to enable JavaScript to run this app. Android开发适配Android11及以下版本在外部存储创建文件夹的权限方案
优惠活动
大模型
产品
解决方案
定价
更多

Android开发适配Android11及以下版本在外部存储创建文件夹的权限方案

Android全版本(含Android 11及更低版本)外部存储自定义文件夹创建适配指南

适配所需权限配置

所有权限需要在应用的AndroidManifest.xml中提前声明,再配合运行时权限申请逻辑引导用户授权,不同系统版本的权限要求差异如下:

  • Android 9.0(API 28)及更低版本:
    申请传统外部存储读写权限,指定最大生效版本为28,避免高版本权限校验冲突:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

该组权限属于危险权限,需要在应用运行时动态弹窗申请。

  • Android 10.0(API 29)版本:
    系统默认开启分区存储机制,为了兼容旧的存储访问逻辑,可在application节点下添加配置跳过分区存储限制:
android:requestLegacyExternalStorage="true"

同时将之前的读写权限的maxSdkVersion修改为29,让权限在该版本正常生效即可,依旧走常规动态权限申请流程。

  • Android 11.0(API 30)及以上版本:
    分区存储强制生效,requestLegacyExternalStorage配置不再生效,要在公共外部存储根目录创建自定义文件夹,需要申请所有文件访问权限:
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

该权限不能通过常规运行时弹窗申请,需要引导用户跳转到系统的应用权限设置页手动开启授权。

兼容全版本的文件夹创建实现代码

object ExternalStorageHelper {
    // 常量:权限申请请求码
    private const val REQ_STORAGE_PERM = 1001

    /**
     * 在外部存储公共根目录创建指定名称的文件夹
     * @param folderName 要创建的文件夹名称
     * @return 创建成功返回true,权限不足或创建失败返回false
     */
    fun createPublicFolder(folderName: String): Boolean {
        // 先校验当前权限是否满足
        if (!hasPermission()) {
            requestPermission()
            return false
        }
        // 校验外部存储是否处于已挂载可用状态
        if (Environment.getExternalStorageState() != Environment.MEDIA_MOUNTED) {
            return false
        }
        // 构建目标文件夹路径
        val targetDir = File(Environment.getExternalStorageDirectory(), folderName)
        // 文件夹不存在则递归创建
        if (!targetDir.exists()) {
            return targetDir.mkdirs()
        }
        return true
    }

    /**
     * 全版本权限校验逻辑
     */
    private fun hasPermission(): Boolean {
        return when {
            // Android11及以上:检查所有文件访问权限
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.R -> Environment.isExternalStorageManager()
            // Android10:检查传统写权限(因为开启了兼容模式)
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q ->
                ContextCompat.checkSelfPermission(
                    App.context,
                    Manifest.permission.WRITE_EXTERNAL_STORAGE
                ) == PackageManager.PERMISSION_GRANTED
            // 低版本:同时校验读写权限
            else -> {
                val writePerm = ContextCompat.checkSelfPermission(
                    App.context,
                    Manifest.permission.WRITE_EXTERNAL_STORAGE
                )
                val readPerm = ContextCompat.checkSelfPermission(
                    App.context,
                    Manifest.permission.READ_EXTERNAL_STORAGE
                )
                writePerm == PackageManager.PERMISSION_GRANTED && readPerm == PackageManager.PERMISSION_GRANTED
            }
        }
    }

    /**
     * 对应版本的权限申请跳转逻辑
     */
    private fun requestPermission() {
        when {
            // Android11+:跳转到所有文件访问权限设置页
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.R -> {
                val intent = Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION).apply {
                    data = Uri.parse("package:${App.context.packageName}")
                    addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
                }
                App.context.startActivity(intent)
            }
            // Android10:申请写权限
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q -> {
                ActivityCompat.requestPermissions(
                    App.currentActivity,
                    arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE),
                    REQ_STORAGE_PERM
                )
            }
            // 低版本:申请读写权限
            else -> {
                ActivityCompat.requestPermissions(
                    App.currentActivity,
                    arrayOf(
                        Manifest.permission.READ_EXTERNAL_STORAGE,
                        Manifest.permission.WRITE_EXTERNAL_STORAGE
                    ),
                    REQ_STORAGE_PERM
                )
            }
        }
    }
}

实操注意事项:

  • 普通非工具类应用不建议使用MANAGE_EXTERNAL_STORAGE权限,该权限审核要求较高,无文件管理、备份等核心场景的应用无法通过应用市场上架审核,这类场景可直接使用应用私有外部目录(通过context.getExternalFilesDir()获取路径)完成存储,不需要申请任何权限。
  • 如果仅需在系统指定公共目录(如下载、图片目录)下创建子文件夹,Android 10及以上版本可通过MediaStoreAPI实现,不需要申请所有文件访问权限。
  • mkdirs()方法需要确保应用有对应路径的写入权限,否则会返回创建失败,不要在外部存储未挂载状态下调用该方法。

内容的提问来源于stack exchange,提问作者Rohullah Tawasoli

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 20:45:00