Android模拟器中Storage Access Framework存储选项受限的适配方案

核心原因 #

Android模拟器默认的系统存储分区挂载逻辑和物理设备存在差异，默认仅暴露Downloads目录与模拟SD卡，而物理设备通常会完整开放内部存储的所有可访问目录。

具体配置步骤 #

1. 调整模拟器存储镜像配置（针对API 26/28） #

• 打开Android Studio的Device Manager，找到目标模拟器，点击右侧的编辑图标（铅笔样式）
• 在Virtual Device Configuration窗口中，切换到Show Advanced Settings
• 找到Storage板块，将Internal Storage的容量调整至至少2GB（默认容量过小可能导致部分目录未被正确挂载）
• 勾选Enable device frame（可选配置，部分场景下可修复存储目录识别异常）
• 点击Finish后重启模拟器

2. 手动挂载完整内部存储目录（临时调试方案） #

• 启动模拟器后，打开Terminal窗口执行以下ADB命令：

  adb shell
  su
  mount -o remount,rw /
  ln -s /storage/emulated/0/ /sdcard/internal
  

  该命令会在模拟SD卡下创建内部存储的软链接，让SAF能够识别到完整的内部存储目录

3. 优化SAF Intent参数配置 #

• 若启动SAF的Intent指定了特定目录限制，会缩小可选范围。确保Intent配置未添加不必要的限制：

  Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
  // 移除仅允许下载目录这类限制性参数
  // intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, downloadUri);
  startActivityForResult(intent, REQUEST_CODE_SAF);
  

  避免添加EXTRA_INITIAL_URI这类限制目录范围的参数，让SAF默认展示所有可访问的存储位置

4. 更换为Google Play系统镜像 #

• 确保使用带Google Play标识的系统镜像而非纯Android镜像：Google Play镜像包含完整的Google服务框架，其文件管理器组件行为更贴近物理设备
• 创建模拟器时，选择带有Google Play标记的系统镜像（例如Android 8.1 (Oreo) - API 27的Google Play版本）

验证方式 #

配置完成后重启模拟器，触发应用内的SAF存储选择界面，此时应能看到与物理设备一致的存储选项，包括内部存储根目录、Documents、Pictures等目录。

内容的提问来源于stack exchange，提问作者Dana Bell