Android文件选择器——让用户选择文件变得轻松简便

一、文件选择器的作用：

Android开发中，用户需要选择文件的情况非常普遍，比如用户需要选择导入数据、上传文件等。此时，使用文件选择器可以极大地简化用户操作，减小用户的心智负担，提高用户体验。

Android系统提供了许多便于操作文件的工具类，如ContentProvider、MediaProvider等。在这些工具类的支持下，我们可以很方便地实现文件的读取、解析、展示以及上传等操作。下面，我们就来学习如何在Android应用中运用文件选择器。

二、两种常用的文件选择器：

1. Android系统提供的文件选择器

Android系统提供了官方的文件选择器，可以让用户在文件系统中选择文件，并返回选择结果。调用方式如下：

// 创建intent
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
// 设置类型为*/*，表示允许选择任何类型的文件
intent.setType("*/*");
// 是否允许多选，默认为false
intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, false);
// 启动文件选择器
startActivityForResult(intent, requestCode);

在startActivityForResult()方法中，requestCode为请求码，用于区分返回的结果。在onActivityResult()方法中，我们就可以接收到用户选择的文件了。

2. 第三方库FilePicker

为了进一步优化体验，我们可以使用第三方文件选择器库FilePicker。它支持单选、多选、分组展示、自定义UI等多种功能，使用简单方便。

首先，在工程的build.gradle文件中添加以下依赖项：

dependencies {
   implementation 'com.github.frankiesardo:material-file-picker:1.5.1'
}

接下来，在代码中调用FilePicker的方式如下：

// 创建FilePicker对象
MaterialFilePicker materialFilePicker = new MaterialFilePicker();
// 设定过滤器，表示只显示jpg、png、bmp和gif格式的图片
materialFilePicker.withFilter(Pattern.compile(".*\\.(jpg|png|bmp|gif)$"));
// 设置文件选择的根路径为/sdcard/Download/
materialFilePicker.withRootPath(Environment.getExternalStorageDirectory().getPath() + "/Download");
// 设定选择模式为单选
materialFilePicker.withSingleFileMode(true);
// 设置Activity
materialFilePicker.withActivity(MainActivity.this);
// 设置选择结果回调
materialFilePicker.withCallback(new MaterialFilePicker.Callback() {
    @Override
    public void onPickMaterialFile(MaterialFilePicker materialFilePicker, File file) {
        // 处理选择结果，file为选择的文件
    }
}).show();

三、如何自定义文件选择器：

默认的文件选择器虽然可以满足基本需求，但却不够美观、灵活、方便。有时候，我们需要根据自己的需求来定制一个更好的文件选择器。这里，我们就介绍一下如何自定义文件选择器。

1. 定义文件选择器的XML布局

首先，我们需要自定义布局文件。例如，我们创建一个名为file_picker.xml的XML布局文件，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
   
    <TextView
        android:id="@+id/tv_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="选择文件"
        android:textStyle="bold"
        android:textSize="20sp"
        android:gravity="center"
        android:padding="10dp"/>

    <ListView
        android:id="@+id/lv_files"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginTop="5dp"
        android:divider="@null"
        android:dividerHeight="0dp"/>
        
</LinearLayout>

定义好布局文件后，在代码中使用setContentView方法将布局文件加载到Activity中：

setContentView(R.layout.file_picker);

2. 定义文件选择器的Adapter

接下来，我们需要定义一个文件列表的Adapter，用于加载和显示文件列表。我们可以继承BaseAdapter，并实现以下方法：

• getCount()，返回文件列表的长度
• getItem(position)，返回文件列表position位置的文件对象
• getItemId(position)，返回文件列表position位置的ID
• getView(position, convertView, parent)，返回文件列表中position位置的视图

在getView()方法中，我们需要加载文件列表的Item布局，并将文件信息显示在视图中。例如：

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        convertView = LayoutInflater.from(mContext).inflate(R.layout.file_item, null);
        holder = new ViewHolder();
        holder.ivIcon = convertView.findViewById(R.id.iv_icon);
        holder.tvName = convertView.findViewById(R.id.tv_name);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }

    // 设置视图内容
    File file = mDataList.get(position);
    holder.tvName.setText(file.getName());
    if (file.isDirectory()) {
        holder.ivIcon.setImageResource(R.drawable.ic_folder);
    } else {
        holder.ivIcon.setImageResource(R.drawable.ic_file);
    }
    return convertView;
}

private class ViewHolder {
    ImageView ivIcon;
    TextView tvName;
}

3. 在Activity中实现文件选择器

最后，我们需要在Activity中实现文件选择器的功能。例如，当用户点击“选择文件”按钮时，我们可以启动文件选择器对话框，并根据用户选择的文件路径进行处理。代码示例如下：

// 弹出文件选择器对话框
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setView(R.layout.file_picker);
final AlertDialog dialog = builder.create();
dialog.show();

// 加载文件列表
final ListView lvFiles = dialog.findViewById(R.id.lv_files);
final List fileList = new ArrayList<>();
String rootPath = Environment.getExternalStorageDirectory().getPath();
File rootFile = new File(rootPath);
if (rootFile.listFiles() != null) {
    for (File file : rootFile.listFiles()) {
        if (file.isFile()) {
            fileList.add(file);
        }
    }
}
final FileAdapter adapter = new FileAdapter(this, fileList);
lvFiles.setAdapter(adapter);

// 设置列表项的点击事件
lvFiles.setOnItemClickListener(new AdapterView.OnItemClickListener() {
    @Override
    public void onItemClick(AdapterView adapterView, View view, int i, long l) {
        File file = fileList.get(i);
        if (file.isDirectory()) {
            // 如果是文件夹，则重新加载子文件列表
            fileList.clear();
            for (File childFile : file.listFiles()) {
                if (childFile.isFile()) {
                    fileList.add(childFile);
                }
            }
            adapter.notifyDataSetChanged();
        } else {
            // 如果是文件，则返回文件路径
            Toast.makeText(MainActivity.this, "选中文件：" + file.getAbsolutePath(), Toast.LENGTH_SHORT).show();
            dialog.dismiss();
        }
    }
});

  

四、总结

文件选择器是Android开发中非常实用的工具，它可以极大地简化用户操作，提高用户体验。本文介绍了常用的两种文件选择器，以及如何自定义文件选择器。希望读者可以通过本文的学习，掌握文件选择器的基本用法，并在实践中运用文件选择器优化应用的用户体验。