Android Q 查询指定文件夹下的文件

本文将指导你如何在 Android Q 中查询指定文件夹下的文件。为了让你更清晰地理解整个流程，我们将首先提供一个步骤的表格，然后详细解释每一步的内容和所需代码。

流程步骤概览

步骤 描述
1 设置适当的权限
2 使用 MediaStore 查询文件
3 显示查询结果
4 处理文件数据

步骤详解

1. 设置适当的权限

在 Android Q（API Level 29）及以上版本，文件操作权限至关重要。需要在 AndroidManifest.xml 中请求以下权限：

<manifest xmlns:android="
    package="com.example.yourapp">

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
</manifest>

代码解析：

  • READ_EXTERNAL_STORAGE：允许应用读取外部存储。

2. 使用 MediaStore 查询文件

接下来，我们使用 MediaStore API 来查询指定文件夹下的文件。以下是一个完整的代码示例，展示如何查询特定目录下的文件：

import android.content.ContentResolver;
import android.database.Cursor;
import android.net.Uri;
import android.provider.MediaStore;

// 查询文件
public void queryFiles(String directoryPath) {
    // 获取ContentResolver
    ContentResolver contentResolver = getContentResolver();
    
    // 设置查询Uri
    Uri uri = MediaStore.Files.getContentUri("external");
    
    // 查询参数
    String[] projection = new String[]{
            MediaStore.Files.FileColumns._ID,
            MediaStore.Files.FileColumns.DISPLAY_NAME,
            MediaStore.Files.FileColumns.MIME_TYPE,
            MediaStore.Files.FileColumns.SIZE
    };
    
    //选择条件
    String selection = MediaStore.Files.FileColumns.RELATIVE_PATH + " = ?";
    String[] selectionArgs = new String[]{directoryPath};
    
    // 执行查询
    Cursor cursor = contentResolver.query(uri, projection, selection, selectionArgs, null);
    
    if (cursor != null) {
        while (cursor.moveToNext()) {
            // 获取文件信息
            String fileName = cursor.getString(cursor.getColumnIndex(MediaStore.Files.FileColumns.DISPLAY_NAME));
            long fileSize = cursor.getLong(cursor.getColumnIndex(MediaStore.Files.FileColumns.SIZE));
            String mimeType = cursor.getString(cursor.getColumnIndex(MediaStore.Files.FileColumns.MIME_TYPE));
            
            // 处理或显示文件信息
            // 例如：Log.d("FileInfo", "Name: " + fileName + ", Size: " + fileSize + ", MIME: " + mimeType);
        }
        cursor.close();
    }
}

代码解析：

  • ContentResolver：用于操作应用程序与外部内容提供者之间的交互。
  • MediaStore.Files.getContentUri("external")：获取外部存储的文件Uri。
  • projection：指定我们希望查询的列。
  • selection：查询条件，这里我们使用相对路径来匹配指定目录。
  • cursor：用于遍历查询结果，获取文件的基本信息，如名称、大小和 MIME 类型。

3. 显示查询结果

你可以通过 Log 或 UI 组件（如 RecyclerView）来展示查询获取的文件信息。上述代码中的 Log.d 可以用来调试输出文件信息。

4. 处理文件数据

完成查询后，你可以根据需求处理这些文件数据，比如展示在 UI 界面上，或者对文件进行操作（如打开、删除等）。

关系图

为了帮助你理解文件与查询之间的关系，以下是一个简单的关系图：

erDiagram
    Files {
        String _ID
        String DISPLAY_NAME
        String MIME_TYPE
        Long SIZE
        String RELATIVE_PATH
    }

    ContentResolver {
        String URI
        String PROJECTION
        String SELECTION
        String[] SELECTION_ARGS
    }

    Files ||--|| ContentResolver: "queried by"

结尾

通过以上的步骤和代码，你应该对如何在 Android Q 中查询指定文件夹下的文件有了清晰的概念。要记住，处理文件需要谨慎，并确保遵守相关的权限要求。你也可以在此基础上扩展更多功能，例如文件的排序、过滤等。继续探索Android开发的其他领域，祝你好运！