安卓开发:getExternalStorageDir等废弃后如何在/storage/emulated/0建目录存文件
不同安卓版本下公共外部存储的实现方案
首先需要明确:你当前使用的getExternalFilesDir()从设计逻辑上就会返回应用专属的外部存储路径(即/storage/emulated/0/Android/data/你的包名/),这和方法是否废弃没有关系——这个方法本身就不需要任何存储权限,卸载应用时目录会被自动清除,天生就不适合用来存放需要跨应用共享的公共文件。
针对你需要访问公共存储目录的需求,可以按照安卓系统的版本分段适配:
Android 9(API 28)及以下版本
- 这类系统尚未引入Scoped Storage存储隔离机制,通过常规存储权限即可直接访问公共目录
- 配置步骤:
- 在AndroidManifest.xml中声明
READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE权限,并在运行时动态申请这两个权限 - 直接调用
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)即可获取/storage/emulated/0/Download的公共目录路径 - 代码示例:
// 确认已经获取存储读写权限 val publicDownloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS) val workLogsFolder = File(publicDownloadDir, "Work Logs") workLogsFolder.mkdirs() // 使用mkdirs()替代mkdir(),避免父目录不存在时创建失败
- 在AndroidManifest.xml中声明
注意:
getExternalStoragePublicDirectory()虽然被标记为废弃,但在Android 9及以下版本上可以正常运行,没有兼容问题。
Android 10(API 29)版本
- 这个版本首次引入Scoped Storage隔离机制,普通应用默认无法直接访问公共目录,有两种适配路径:
- 临时兼容方案:在AndroidManifest.xml的
<application>标签中添加android:requestLegacyExternalStorage="true",即可沿用旧的存储访问逻辑,和Android 9的行为保持一致。这个方案只能作为过渡,在Android 11及以上系统会失效。 - 合规永久方案:通过MediaStore API访问公共Download目录,不需要申请额外的存储权限。
- 临时兼容方案:在AndroidManifest.xml的
Android 11(API 30)及以上版本
这个版本的Scoped Storage机制进一步收紧,之前的兼容标记完全失效,普通应用想要访问公共存储目录有三类合规路径:
- 常规共享文件存储:直接通过MediaStore API将文件写入公共Download、Documents等系统预设公共目录,不需要申请危险权限,代码示例:
val workLogEntry = ContentValues().apply { put(MediaStore.Downloads.DISPLAY_NAME, "Work Logs") put(MediaStore.Downloads.MIME_TYPE, "text/plain") put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS) } // 通过系统内容解析器创建文件入口,即可获得可读写的文件URI val targetUri = contentResolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, workLogEntry) - 自定义目录访问:如果需要在公共存储下创建自定义文件夹,可以通过存储访问框架(SAF),弹出系统目录选择器引导用户手动授权应用访问指定目录,授权后应用可以长期在该目录下读写文件,不需要额外申请权限。
- 全量存储访问:如果你的应用属于文件管理、数据备份、设备辅助类的特殊应用,可以申请
MANAGE_EXTERNAL_STORAGE全量存储权限,授权通过后即可直接访问/storage/emulated/0根目录下的所有路径,直接通过File类完成文件夹和文件的创建操作。但这类权限应用市场审核标准极高,普通内容类应用不要尝试申请。
常见认知误区
- 误区一:废弃的方法完全不可用——只要对应系统版本没有限制方法的行为,废弃方法依然可以在适配低版本系统时正常使用。
- 误区二:Scoped Storage下所有存储路径都需要权限——应用专属的外部存储路径不需要任何权限,但这类路径不属于公共共享目录。
- 误区三:普通应用可以直接在
/storage/emulated/0根目录创建文件夹——从Android 11开始,没有特殊权限的普通应用既不能列举根目录的文件列表,也无法在根目录下直接创建文件夹。
内容的提问来源于stack exchange,提问作者vishal N
相关产品推荐
相关产品推荐

