在Android开发中,如何获取手机设备中的所有文件信息?

目录

方法概述

重要提示

示例代码

使用说明

权限申请

注意事项


在 Android 开发中获取设备中的所有文件信息,需要注意权限管理和隐私安全。在 Android 11 及更高版本,访问设备文件的权限得到了进一步限制,应用只能访问自身的私有存储区域和经过用户授权的共享存储区域。

方法概述

要获取文件信息,可以使用以下方法:

  1. 访问应用的私有存储 :使用 Context.getFilesDir() 等方法获取应用的私有目录中的文件信息。
  2. 访问共享存储的文件 :在 Android 10 及更高版本,使用 MediaStore 访问公开文件(例如图片、视频、音频等)。
  3. 访问特定的文件路径 :通过 File 类指定路径访问文件夹内容,适用于 Android 10 以下版本,或获得特殊权限的情况。

重要提示

  • 从 Android 6.0 开始,访问外部存储需要申请 READ_EXTERNAL_STORAGEWRITE_EXTERNAL_STORAGE 权限。
  • 从 Android 11(API 30)开始,应用只能访问其私有目录和部分经过权限批准的共享文件,使用 MediaStore 访问多媒体文件。
  • 为了更灵活地管理存储访问权限,可以使用 Storage Access Framework (SAF)Scoped Storage

示例代码

以下代码演示如何在 Android 10 及以下版本中获取所有文件的信息,并在 Android 11 及更高版本中使用 MediaStore 获取公开文件的信息。

复制代码
import android.Manifest;
import android.content.Context;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Build;
import android.os.Environment;
import android.provider.MediaStore;
import android.util.Log;

import androidx.annotation.RequiresApi;
import androidx.core.app.ActivityCompat;

import java.io.File;

public class FileUtils {

    private static final String TAG = "FileUtils";

    /**
     * 获取应用私有目录中的所有文件
     *
     * @param context 应用上下文
     */
    public static void getAllPrivateFiles(Context context) {
        File privateDir = context.getFilesDir(); // 获取应用私有文件目录
        listFilesRecursively(privateDir);
    }

    /**
     * 列出文件夹及其子文件夹中的所有文件
     *
     * @param dir 目标文件夹
     */
    private static void listFilesRecursively(File dir) {
        if (dir != null && dir.isDirectory()) {
            File[] files = dir.listFiles();
            if (files != null) {
                for (File file : files) {
                    if (file.isDirectory()) {
                        listFilesRecursively(file); // 递归遍历子目录
                    } else {
                        Log.d(TAG, "File: " + file.getAbsolutePath());
                    }
                }
            }
        }
    }

    /**
     * 获取外部存储中的所有文件信息(适用于 Android 10 及以下版本)
     *
     * @param context 应用上下文
     */
    public static void getAllExternalFiles(Context context) {
        if (ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_EXTERNAL_STORAGE) 
                != PackageManager.PERMISSION_GRANTED) {
            Log.e(TAG, "需要 READ_EXTERNAL_STORAGE 权限");
            return;
        }

        File externalDir = Environment.getExternalStorageDirectory(); // 获取外部存储根目录
        listFilesRecursively(externalDir);
    }

    /**
     * 使用 MediaStore 获取多媒体文件信息(适用于 Android 11 及更高版本)
     *
     * @param context 应用上下文
     */
    @RequiresApi(api = Build.VERSION_CODES.R)
    public static void getAllMediaFiles(Context context) {
        String[] projection = new String[]{
                MediaStore.MediaColumns.DISPLAY_NAME,
                MediaStore.MediaColumns.DATA
        };

        Cursor cursor = context.getContentResolver().query(
                MediaStore.Files.getContentUri("external"),
                projection,
                null,
                null,
                null
        );

        if (cursor != null) {
            while (cursor.moveToNext()) {
                String fileName = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.MediaColumns.DISPLAY_NAME));
                String filePath = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.MediaColumns.DATA));
                Log.d(TAG, "Media File: " + fileName + " Path: " + filePath);
            }
            cursor.close();
        }
    }
}

使用说明

  1. 应用私有目录getAllPrivateFiles() 方法会递归遍历应用的私有存储目录,无需特殊权限。
  2. 外部存储目录getAllExternalFiles() 方法在 Android 10 及以下版本中运行。调用该方法前,需要检查并请求 READ_EXTERNAL_STORAGE 权限。
  3. 多媒体文件访问getAllMediaFiles() 使用 MediaStore 访问多媒体文件(图片、视频、音频等),适用于 Android 11 及更高版本。

权限申请

AndroidManifest.xml 文件中添加以下权限声明:

复制代码
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

在 Android 6.0 及更高版本中,运行时请求权限:

复制代码
if (ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_EXTERNAL_STORAGE) 
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(activity, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_CODE);
}

注意事项

  • 使用 MediaStore 是 Android 11 及以上版本访问公共存储的推荐方法。
  • 对于非公共目录或特定类型的文件,需使用 Storage Access Framework (SAF) 或其他系统 API。
  • 在 Android 10 及以上,建议使用 Scoped Storage 访问共享存储数据。
相关推荐
hqxstudying2 小时前
Java异常处理
java·开发语言·安全·异常
wjs20245 小时前
状态模式(State Pattern)
开发语言
我命由我123455 小时前
Kotlin 数据容器 - List(List 概述、创建 List、List 核心特性、List 元素访问、List 遍历)
java·开发语言·jvm·windows·java-ee·kotlin·list
liulilittle5 小时前
C++ TAP(基于任务的异步编程模式)
服务器·开发语言·网络·c++·分布式·任务·tap
zepcjsj08016 小时前
简单实现支付密码的页面及输入效果
android
励志要当大牛的小白菜6 小时前
ART配对软件使用
开发语言·c++·qt·算法
小阳睡不醒7 小时前
小白成长之路-部署Zabbix7(二)
android·运维
武子康7 小时前
Java-80 深入浅出 RPC Dubbo 动态服务降级:从雪崩防护到配置中心秒级生效
java·分布式·后端·spring·微服务·rpc·dubbo
舒一笑7 小时前
我的开源项目-PandaCoder迎来史诗级大更新啦
后端·程序员·intellij idea
灵感__idea7 小时前
JavaScript高级程序设计(第5版):好的编程就是掌控感
前端·javascript·程序员