You need to enable JavaScript to run this app. 安卓开发:getExternalStorageDir等废弃后如何在/storage/emulated/0建目录存文件
优惠活动
大模型
产品
解决方案
定价
更多

安卓开发: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(),避免父目录不存在时创建失败
      

注意:getExternalStoragePublicDirectory()虽然被标记为废弃,但在Android 9及以下版本上可以正常运行,没有兼容问题。

Android 10(API 29)版本

  • 这个版本首次引入Scoped Storage隔离机制,普通应用默认无法直接访问公共目录,有两种适配路径:
    • 临时兼容方案:在AndroidManifest.xml的<application>标签中添加android:requestLegacyExternalStorage="true",即可沿用旧的存储访问逻辑,和Android 9的行为保持一致。这个方案只能作为过渡,在Android 11及以上系统会失效。
    • 合规永久方案:通过MediaStore API访问公共Download目录,不需要申请额外的存储权限。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.12 07:24:08