Android 11 共享目录遍历指南：权限、实现与优化策略

作者：c4t2025.10.14 02:02浏览量：8

简介：本文深入探讨Android 11中遍历共享目录的实现方法，涵盖存储访问框架（SAF）、权限配置、代码实现及性能优化，帮助开发者高效管理用户共享文件。

Android 11 共享目录遍历指南：权限、实现与优化策略

一、Android 11 存储机制变革与共享目录定位

Android 11（API 30）引入了分区存储（Scoped Storage）机制，彻底改变了应用对设备存储的访问方式。传统模式下，应用可通过Environment.getExternalStorageDirectory()直接访问所有公共目录，但此方式存在隐私泄露风险。Android 11通过以下核心规则重构存储模型：

  1. 应用专属存储区：每个应用拥有独立的Android/data/<package_name>目录，无需权限即可自由读写。
  2. 媒体文件分区：照片、视频、音频等媒体文件通过MediaStore API访问，需声明READ_EXTERNAL_STORAGE权限。
  3. 共享存储限制：应用无法直接遍历Downloads、DCIM等公共目录，必须通过存储访问框架（Storage Access Framework, SAF）或MANAGE_EXTERNAL_STORAGE权限（需用户手动授权）实现。

共享目录定位：在Android 11中，”共享目录”特指用户通过SAF主动选择的目录（如Downloads中的子文件夹），或通过MediaStore暴露的媒体集合。开发者需明确：直接遍历系统级共享目录（如/storage/emulated/0/Download）已被禁止，必须通过合规方式获取访问权限。

二、遍历共享目录的核心方法

方法1：通过存储访问框架（SAF）实现

SAF是Google推荐的共享文件访问方式，其核心流程如下：

  1. 启动系统文件选择器：
    1. // 使用ACTION_OPEN_DOCUMENT_TREE让用户选择目录
    2. Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    3. startActivityForResult(intent, REQUEST_CODE_OPEN_DIRECTORY);
  2. 处理用户选择结果：
    1. @Override
    2. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    3.  super.onActivityResult(requestCode, resultCode, data);
    4.  if (requestCode == REQUEST_CODE_OPEN_DIRECTORY && resultCode == RESULT_OK) {
    5.      Uri treeUri = data.getData();
    6.      // 获取持久化权限
    7.      getContentResolver().takePersistableUriPermission(
    8.          treeUri, 
    9.          Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION
    10.      );
    11.      // 遍历目录内容
    12.      traverseDirectory(treeUri);
    13.  }
    14. }
  3. 递归遍历目录：
    1. private void traverseDirectory(Uri treeUri) {
    2.  DocumentFile root = DocumentFile.fromTreeUri(this, treeUri);
    3.  if (root != null && root.isDirectory()) {
    4.      for (DocumentFile file : root.listFiles()) {
    5.          if (file.isDirectory()) {
    6.              traverseDirectory(file.getUri()); // 递归子目录
    7.          } else {
    8.              Log.d("File", "Name: " + file.getName() + ", Size: " + file.length());
    9.          }
    10.      }
    11.  }
    12. }
    优势：符合Android隐私政策，无需声明危险权限。
    局限：需用户主动交互，无法后台自动遍历。

方法2：使用MediaStore API访问媒体文件

若目标为照片、视频等媒体文件，可通过MediaStore查询：

  1. // 查询Downloads目录下的图片
  2. String[] projection = {MediaStore.Images.Media._ID, MediaStore.Images.Media.DISPLAY_NAME};
  3. String selection = MediaStore.Images.Media.RELATIVE_PATH + " LIKE ?";
  4. String[] selectionArgs = {"Download/%"};
  6. ContentResolver resolver = getContentResolver();
  7. Cursor cursor = resolver.query(
  8.     MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
  9.     projection,
  10.     selection,
  11.     selectionArgs,
  12.     null
  13. );
  15. if (cursor != null) {
  16.     while (cursor.moveToNext()) {
  17.         long id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
  18.         String name = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME));
  19.         Uri contentUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id);
  20.         Log.d("MediaFile", "ID: " + id + ", Name: " + name);
  21.     }
  22.     cursor.close();
  23. }

适用场景：需处理媒体文件时，可结合MediaStore.Files查询非媒体文件。

方法3：MANAGE_EXTERNAL_STORAGE权限（高风险方案）

若必须访问所有共享目录（如文件管理器类应用），可声明MANAGE_EXTERNAL_STORAGE权限，但需通过Google Play审核：

  1. 声明权限：
    1. <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  2. 动态请求权限：
    1. if (!Environment.isExternalStorageManager()) {
    2.  Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
    3.  startActivity(intent);
    4. }
  3. 遍历目录：
    1. File downloadsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
    2. if (downloadsDir.exists()) {
    3.  File[] files = downloadsDir.listFiles();
    4.  if (files != null) {
    5.      for (File file : files) {
    6.          Log.d("File", "Path: " + file.getAbsolutePath());
    7.      }
    8.  }
    9. }
    风险提示：Google Play可能拒绝应用上架，且用户可能拒绝授权。

三、性能优化与最佳实践

1. 异步加载与分页处理

遍历大目录时，使用AsyncTask或Coroutine避免阻塞UI线程：

  1. // Kotlin协程示例
  2. suspend fun traverseDirectoryAsync(treeUri: Uri) {
  3.     withContext(Dispatchers.IO) {
  4.         val root = DocumentFile.fromTreeUri(context, treeUri)
  5.         root?.listFiles()?.forEach { file ->
  6.             if (file.isDirectory) {
  7.                 traverseDirectoryAsync(file.uri)
  8.             } else {
  9.                 // 处理文件
  10.             }
  11.         }
  12.     }
  13. }

2. 缓存与增量更新

对频繁访问的目录，缓存文件列表并监听变更：

  1. // 注册内容观察者
  2. getContentResolver().registerContentObserver(
  3.     MediaStore.Downloads.EXTERNAL_CONTENT_URI,
  4.     true,
  5.     new ContentObserver(new Handler()) {
  6.         @Override
  7.         public void onChange(boolean selfChange) {
  8.             // 目录内容变更时刷新缓存
  9.         }
  10.     }
  11. );

3. 错误处理与权限回退

  • SAF权限失效：监听PersistableUriPermission被撤销事件。
  • MediaStore查询失败：检查RELATIVE_PATH列是否支持（Android 11+）。
  • MANAGE_EXTERNAL_STORAGE拒绝：提供降级方案（如仅显示应用专属文件）。

四、常见问题与解决方案

  1. 问题：SAF选择的目录无法写入文件。
    解决：确保调用takePersistableUriPermission时包含FLAG_GRANT_WRITE_URI_PERMISSION。

  2. 问题：MediaStore查询不到Downloads目录的文件。
    解决：检查设备是否启用”存储权限”，或使用DocumentFile通过SAF访问。

  3. 问题：MANAGE_EXTERNAL_STORAGE权限被系统自动撤销。
    解决：避免频繁请求权限，仅在核心功能需要时提示用户。

五、总结与展望

Android 11的存储机制变革旨在平衡功能与隐私，开发者需适应以下趋势：

  • 优先使用SAF：符合平台政策，用户体验更友好。
  • 谨慎使用全盘权限：仅在必要场景申请MANAGE_EXTERNAL_STORAGE。
  • 关注媒体文件API：MediaStore的功能持续增强，可覆盖大部分文件管理需求。

未来Android版本可能进一步收紧存储访问，建议提前规划迁移至合规方案。通过合理组合SAF、MediaStore和权限管理，可在保护用户隐私的同时实现高效的共享目录遍历。

最热文章