Skip to content
/ FileSelectorRelease Public

一款具有多种功能的文件选择器，支持访问Android/data(obb)等系统文件夹

License

AGPL-3.0 license
47 stars 7 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

zzy0516alex/FileSelectorRelease

BranchesTags

Repository files navigation

一款具有多种功能的文件选择器，支持访问Android/data(obb)等系统文件夹

介绍

GitHub地址：Fileselector

  1. 这是一个文件选择器
  2. 可以区分多种文件类型，并支持自定义它们的图标
  3. 支持多选和单选
  4. 可以对选择或显示的文件类型进行指定
  5. 提供功能拓展菜单进行自定义
  6. 支持访问/选择Android系统文件(夹)
  7. 支持文件列表下拉刷新
  8. 支持非英文路径显示和访问
  9. 采用多线程加载，打开文件列表更迅捷

实例展示

在这里插入图片描述

更多预览图请访问我的博客

使用方法

基础使用

gradle:project 中

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

gradle:app 中

implementation 'com.github.zzy0516alex:FileSelectorRelease:v6.2'

Manifest中

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<application
        ...
        android:requestLegacyExternalStorage ="true">    
<application>

依赖与权限设置完成后 在你的Activity中

FileSelectorSettings settings = new FileSelectorSettings();
                settings.setRootPath(FileSelectorSettings.getSystemRootPath()+"/Android")//起始路径
                        .setMaxFileSelect(2)//最大文件选择数
                        .setTitle("请选择文件夹")//标题
                        .setFileTypesToSelect(FileInfo.FileType.Folder)//可选择文件类型
                        .show(MainActivity.this);//显示

获取返回的数据

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == FileSelectorSettings.FILE_LIST_REQUEST_CODE && resultCode == FileSelectorSettings.BACK_WITH_SELECTIONS){
            assert data != null;
            Bundle bundle=data.getExtras();
            assert bundle != null;
            ArrayList<String> FilePathSelected
                    =bundle.getStringArrayList(FileSelectorSettings.FILE_PATH_LIST_REQUEST);
            for (String file_path :
                    FilePathSelected) {
                Log.v("file_sel", file_path);
            }
        }
    }

添加拓展功能菜单

FileSelectorSettings settings=new FileSelectorSettings();
        settings.setMoreOptions(new String[]{"新建文件夹", "删除文件","反选","转到系统目录"},
                        (activity, currentPath, FilePathList, FilePathSelected) -> {
                            File Folder =new File(currentPath,"新文件夹");
                            if(!Folder.exists()){
                                Folder.mkdir();
                            }
                        }, (activity, currentPath, FilePathList, FilePathSelected) -> {
                            if (FilePathSelected!=null){
                                for (String path : FilePathSelected) {
                                    File delFile=new File(path);
                                    delFile.delete();
                                }
                            }
                        },(activity, currentPath, FilePathList, FilePathSelected) -> {
                            List<Integer>selectList = new ArrayList<>();
                            for (int i = 0; i < FilePathList.size(); i++) {
                                if (FilePathSelected.contains(FilePathList.get(i)))continue;
                                selectList.add(i);
                            }
                            activity.updateFileSelectList(selectList);
                        },(activity, currentPath, FilePathList, FilePathSelected) -> {
                            activity.updateFileList(FileSelectorSettings.getSystemRootPath()+"/Android/data");
                        })
                .show(this);

设置了拓展功能菜单后，顶栏右上角会出现功能菜单图标，点击后将弹出你自定义的菜单栏。需要注意的是，在setMoreOptions方法中参数一与参数二的长度需一致。 本方法提供四个回调参数(详见后文BasicParams.OnOptionClick部分)，开发者可以利用这些参数进行拓展。 上面实例代码中给出了四种常见的选项供开发者参考。

自定义文件显示和图标

FileSelectorSettings settings = new FileSelectorSettings();
            settings.setRootPath(FileSelectorSettings.getSystemRootPath())
                    .setMaxFileSelect(2)
                    .setTitle("请选择文件夹")
                    .setFileTypesToSelect(FileInfo.FileType.Unknown)//选择自定义后缀的文件此处参数需为Unknown/File
                    .setFileTypesToShow(".cer")//自定义可见的文件后缀
                    .setCustomizedIcons(new String[]{".cer"},context,R.mipmap.file_cert)//自定义文件图标
                    .show(MainActivity.this);

自定义图标及字体

FileSelectorTheme theme = new FileSelectorTheme();
        theme.setTopToolBarTitleColor("#03DAC5")
                .setThemeColor("#FFFFFF")
                .setTopToolBarTitleSize(28)
                .setTopToolBarBackIcon(R.mipmap.back_black)
                .setTopToolBarMenuIcon(R.mipmap.options)
                .setNaviBarArrowIcon(R.mipmap.segment)
                .setNaviBarTextSize(20)
                .setFileInfoColor(getColor(R.color.black))
                .setFileNameSize(25);
FileSelectorSettings settings = new FileSelectorSettings();
            settings.setTheme(theme)
                    .show(MainActivity.this);

更改默认的文件图标

本组件提供了一组默认的文件图标，如下：

图标资源名称 对应文件类型
file_folder.png 文件夹
file_audio.png 音频文件
file_image.png 图片文件
file_text.png 文本文件
file_video.png 视频文件
file_unknown.png 其他文件

只需要在 res > mipmap 文件夹中添加同名的替换文件即可更改新图标。

访问data或obb文件夹

启动文件选择器

FileSelectorSettings settings=new FileSelectorSettings();
settings.setRootPath(FileSelectorSettings.getSystemRootPath() + "/Android/data")
        .setTitle("请选择文件夹")
        .setFileTypesToSelect(FileInfo.FileType.Folder)
        .show(this);

在onActivityResult中

@Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode==FileSelectorSettings.FILE_LIST_REQUEST_CODE && resultCode==FileSelectorSettings.BACK_WITH_SELECTIONS){
            assert data != null;
            Bundle bundle=data.getExtras();
            assert bundle != null;
            ArrayList<String> FilePathSelected
                    =bundle.getStringArrayList(FileSelectorSettings.FILE_PATH_LIST_REQUEST);
            for (String file_path :
                    FilePathSelected) {
                FileInfo.AccessType accessType = FileInfo.judgeAccess(file_path);
                switch(accessType){
                    case Open:
                        File file = new File(file_path);
                        break;
                    case Protected:
                        DocumentFile documentFile = FileUtil.getDocumentFilePath(this,file_path);
                        break;
                    default:
                }
                Log.v("file_sel", file_path);
            }
        }
    }

注意通过FileInfo.judgeAccess方法区分是否是受保护的系统文件夹，如果是，则应该通过DocumentFile的方式来访问。

类与方法

FileSelectorTheme

下面图片中给出了UI的属性作用位置的序号：

在这里插入图片描述

属性 入参类型 注释 对应UI位置
themeColor Color-int/Color-String 主题色，顶栏及状态栏 1
topToolBarBackIcon Resource ID 顶部返回按钮 2
topToolBarTitleColor Color-int/Color-String 顶部标题及提示文本颜色 3
topToolBarTitleSize sp 顶部标题及提示文本大小 3
topToolBarMenuIcon Resource ID 顶部菜单按钮 4
naviBarTextColor Color-int/Color-String 导航栏字体颜色 5
naviBarTextSize sp 导航栏文本大小 5
naviBarArrowIcon Resource ID 导航栏分隔箭头 6
fileNameColor Color-int/Color-String 文件(夹)名称字体颜色 7
fileNameSize sp 文件(夹)名称字体大小 7
fileInfoColor Color-int/Color-String 文件信息提示字体颜色 8
fileInfoSize sp 文件信息提示字体大小 8
checkboxDrawable Resource ID 勾选框的样式 9

表中每个属性均有set方法，并有默认的属性，故该设置不是必须的设置。

FileSelectorSettings

方法 作用 注释
FileSelectorSettings setRootPath(String path) 设置起始目录 无
FileSelectorSettings setFileListRequestCode(int requestCode) 设置Activity请求码 默认为512
FileSelectorSettings setMaxFileSelect(int num) 设置最大文件选择数 默认为-1，即不限制选择数量
FileSelectorSettings setMinFileSelect(int num) 设置最小文件选择数 默认为0。若选择的文件数小于该值，点击确定按钮不返回
FileSelectorSettings setTitle(String title) 设置标题 无
FileSelectorSettings setTheme(FileSelectorTheme theme) 设置界面主题(大部分图标及字体) 无
FileSelectorSettings setFileTypesToSelect(FileInfo.FileType ... fileTypes) 设置可选择的文件类型 可以多选，但不能包含parent类型
FileSelectorSettings setFileTypesToShow(String ... extensions) 设置可见的文件类型 后缀示例".txt",不填写则全部显示
FileSelectorSettings setCustomizedIcons(String[] extensions, Context context, int ... icon_ids) 设置自定义文件图标 后缀名和图标资源id应一一对应
FileSelectorSettings setMoreOptions(String[] optionsName, BasicParams.OnOptionClick...onOptionClicks) 设置更多选项，第一个参数为选项名，第二个参数为选项点击事件 选项名和点击响应数量必须对应
static String getSystemRootPath() 获取系统外部存储根目录：/storage/emulated/0 无

FileInfo.FileType

变量 解释
Folder 文件夹
Video 视频文件
Image 图片文件
Audio 音频文件
Text 文本文件
Unknown 除上述类型以外的其他文件类型
File 除Folder类型以外的其他文件类型
Parent 不可用的变量

FileInfo.AccessType

变量 解释
Open 普通文件(夹)
Protected Android系统保护的文件(夹)，必须通过SAF框架访问

BasicParams.OnOptionClick

接口抽象方法：onclick

void onclick(FileSelectorActivity activity, String currentPath, List<String> FilePathList, List<String> FilePathSelected);
参数 解释
activity 文件选择器的activity
currentPath 当前所在的目录
FilePathList 当前的文件(路径)列表
FilePathSelected 当前用户选择的文件(路径)列表

FileSelectorActivity提供的公共方法：

方法 解释
void updateFileSelectList(List<Integer> select_index_list) 输入需要选中的列表项的索引的集合，更新当前列表的勾选状态，
void updateFileList(String new_path) 输入用新的文件夹路径，用该路径更新文件列表

About

一款具有多种功能的文件选择器，支持访问Android/data(obb)等系统文件夹

Resources

Readme

License

AGPL-3.0 license
Activity

Stars

47 stars

Watchers

1 watching

Forks

7 forks
Report repository

Releases 10

v6.2 Latest
Mar 20, 2024
+ 9 releases

Packages

No packages published

Languages