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
相关产品推荐
相关产品推荐

