Android文件选择器：FileSelectorRelease完全指南

Android文件选择器：FileSelectorRelease完全指南

项目地址:https://gitcode.com/gh_mirrors/fi/FileSelectorRelease

项目介绍

FileSelectorRelease是一款强大的Android文件选择器库，它允许开发者轻松集成文件选择功能，支持访问包括Android/data和Android/obb在内的系统文件夹。此库提供了多样的功能，如区分多种文件类型且自定义图标、多选与单选模式、指定文件类型筛选、以及扩展菜单定制等，确保了灵活的文件浏览和选择体验。项目遵循AGPL-3.0许可协议，并通过JitPack提供依赖。

项目快速启动

添加依赖

首先，在你的项目的build.gradle（位于项目根目录）文件中添加JitPack仓库：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

然后，在app模块的build.gradle文件中加入FileSelectorRelease的依赖：

dependencies {
    implementation 'com.github.zzy0516alex:FileSelectorRelease:v6.2'
}

记得在AndroidManifest.xml中添加必要的存储权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 若适配Android 10及以上版本，还需处理Scoped Storage -->
<application
    android:requestLegacyExternalStorage="true">
</application>

基础使用

在Activity中初始化FileSelectorSettings并启动选择器：

FileSelectorSettings settings = new FileSelectorSettings();
settings.setRootPath(FileSelectorSettings.getSystemRootPath() + "/Android"); // 设定起始路径
settings.setMaxFileSelect(2); // 设置最多可以选择的文件数量
settings.setTitle("请选择文件夹"); // 设置标题
settings.setFileTypesToSelect(FileInfo.FileType.Folder); // 限制选择的文件类型为文件夹
startActivityForResult(new Intent(this, FileSelectorActivity.class), YOUR_REQUEST_CODE);

接收结果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == YOUR_REQUEST_CODE && resultCode == RESULT_OK) {
        List<String> selectedFiles = data.getStringArrayListExtra(FileSelectorActivity.EXTRA_SELECTED_FILES);
        // 处理选取的文件路径
    }
}

应用案例和最佳实践

在实现特定场景文件选择时，利用setFileTypesToShow和setCustomizedIcons函数可以高度定制UI显示和交互体验。例如，如果你的应用需要用户选择图片和视频，同时希望图标符合品牌风格，可以通过以下方式配置：

settings.setFileTypesToSelect(FileInfo.FileType.Image, FileInfo.FileType.Video);
String[] imageExtensions = {"jpg", "png"};
int[] imageIcons = {R.drawable.custom_image_icon, R.drawable.custom_video_icon};
settings.setCustomizedIcons(imageExtensions, this, imageIcons);

典型生态项目

虽然上述指南聚焦于FileSelectorRelease，另一个相似但更新活跃的项目是molihuan/mlhfileselectorlib，它同样提供文件和路径的选择能力，且兼容性覆盖到Android 4.4至Android 13，支持自定义UI和SD卡访问，可能为寻找更多定制化选项的开发者提供另一种选择。

---

以上就是关于FileSelectorRelease的使用指南，无论你是要快速集成文件选择功能，还是想深入定制UI和交互逻辑，这款库都能满足你的需求。希望这份指南能帮助您高效地完成开发任务。

FileSelectorRelease 一款具有多种功能的文件选择器，支持访问Android/data(obb)等系统文件夹 项目地址: https://gitcode.com/gh_mirrors/fi/FileSelectorRelease