【亲测免费】 MaterialFilePicker 使用指南

1. 项目介绍

MaterialFilePicker 是一个基于 Android 的文件选择器库，它提供了符合 Material Design 规范的界面，让用户能够优雅地选择文件或目录。该项目实现了自定义过滤器、隐藏文件显示等功能，可轻松集成到任何 Android 应用中。

2. 项目快速启动

添加依赖

在你的 build.gradle 文件（Module级别）中添加以下依赖：

dependencies {
    implementation 'com.nbsp.materialfilepicker:library:版本号' // 替换为最新版本号
}

同步项目后，依赖即已导入。

初始化并调用文件选择器

在你的 Activity 或 Fragment 中，按照下面的示例代码使用 MaterialFilePicker：

import com.nbsp.materialfilepicker.MaterialFilePicker;

// 定义请求码
public static final int FILE_PICKER_REQUEST_CODE = 989;

// 在需要的地方调用文件选择器
MaterialFilePicker.filePicker()
    .withActivity(this)
    .withHiddenFiles(false) // 可选，设置是否显示隐藏文件，默认不显示
    .withFilterPattern(null) // 可选，设置文件筛选规则，例如只允许选择图片
    .start(FILE_PICKER_REQUEST_CODE);

处理选择结果

在 Activity 中重写 onActivityResult 方法，如下所示：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == FILE_PICKER_REQUEST_CODE && resultCode == RESULT_OK) {
        String selectedFilePath = data.getStringExtra(FilePickerActivity.EXTRA_FILE_PATH);
        Log.d("Selected File", "Path: " + selectedFilePath);
        // 此处处理选定文件的逻辑
    }
}

3. 应用案例和最佳实践

为了提供更好的用户体验，可以考虑以下最佳实践：

• 根据应用需求调整 MaterialFilePicker 的初始路径，如用户最近访问的目录。
• 通过 withFilterPattern 设置过滤器，限制用户只能选择特定类型的文件，如文本或图像。
• 使用 withTitle 自定义对话框标题，以增加应用品牌感。
• 考虑使用 withHiddenFiles(true) 显示隐藏文件，以便用户有更多的选择，但也要警告用户可能的风险。

4. 典型生态项目

MaterialFilePicker 已经被多个开源项目采用，包括但不限于：

• Android-FileExplore：一个基于 Android 的文件浏览器示例应用。
• MyNotes：一款简单的笔记应用程序，支持附件上传功能。

这些项目展示了如何将 MaterialFilePicker 整合到不同应用场景中，提供了有价值的参考。如果你发现更多使用 MaterialFilePicker 的项目，欢迎访问其 GitHub 主页查看更完整的生态列表。